# 🎮 Minecraft Java Edition with Controller on TV - Complete Setup Guide

A step-by-step guide to playing Minecraft Java Edition with an Xbox controller on your TV using TLauncher and Fabric mods.

---

## 📋 Table of Contents
1. [Prerequisites](#prerequisites)
2. [Installing TLauncher](#installing-tlauncher)
3. [Setting Up Fabric Loader](#setting-up-fabric-loader)
4. [Downloading the Mods](#downloading-the-mods)
5. [Installing the Mods](#installing-the-mods)
6. [Launching the Game](#launching-the-game)
7. [Controller Configuration](#controller-configuration)
8. [Troubleshooting](#troubleshooting)
9. [Quick Reference](#quick-reference)

---

## 📌 Prerequisites

Before you begin, make sure you have:

| Item | Details |
| :--- | :--- |
| **Windows PC/Laptop** | Connected to your TV via HDMI |
| **Xbox Controller** | Wired, wireless adapter, or Bluetooth |
| **Internet Connection** | For downloading files |
| **Storage Space** | ~1GB free |

---

## 🖥️ Installing TLauncher

### Step 1: Download TLauncher
1. Go to the official TLauncher website: **[https://tlauncher.org/en/](https://tlauncher.org/en/)**
2. Click the **Download** button.
3. Choose the Windows version (`.exe` file).

### Step 2: Install TLauncher
1. Run the downloaded installer.
2. Follow the installation wizard.
3. Choose your preferred language and installation directory.
4. Complete the installation and launch TLauncher.

### Step 3: Login
- You can play without logging in (offline mode).
- Enter a username and click **Enter the game**.

---

## 🔧 Setting Up Fabric Loader

### Step 1: Open TLauncher
1. Launch TLauncher.
2. On the left side, click the **Installations** tab.

### Step 2: Select Fabric
1. Look for the **Fabric** option in the version list.
2. Select the latest Fabric version available (e.g., `Fabric 26.2` or later).
3. Click **Save** or **Apply**.

### Step 3: Launch Once (Optional)
- Launch Minecraft once with the Fabric profile to create the `mods` folder automatically.
- If the game launches successfully, close it and proceed.

---

## 📥 Downloading the Mods

You need **TWO** files for controller support:

### 1. Framework (Fabric API)
This is the required library that makes mods work.

| Source | Link |
| :--- | :--- |
| **Modrinth** | https://modrinth.com/mod/fabric-api |
| **CurseForge** | https://www.curseforge.com/minecraft/mc-mods/fabric-api |
| **GitHub** | https://github.com/FabricMC/fabric/releases |

**Download a version that matches your Minecraft game version (e.g., `26.2`).**

### 2. Controllable Mod
This adds native controller support to the game.

| Source | Link |
| :--- | :--- |
| **Official Website** | https://mrcrayfish.com/mods/controllable |
| **GitHub Releases** | https://github.com/MrCrayfish/Controllable/releases |
| **CurseForge** | https://www.curseforge.com/minecraft/mc-mods/controllable |

**Download a version that matches your Fabric loader version (e.g., `controllable-fabric-26.2-0.26.1.jar`).**

---

## 📂 Installing the Mods

### Step 1: Open the Game Directory
1. Open TLauncher.
2. Select your Fabric profile.
3. Click the **folder icon** (usually near the bottom) to open the `.minecraft` folder.

### Step 2: Create the `mods` Folder
- Inside the `.minecraft` folder, check if a folder named `mods` exists.
- If not, **create a new folder** and name it exactly `mods` (all lowercase).

### Step 3: Copy the Mods
- Copy the **two `.jar` files** you downloaded:
  - `framework-fabric-X.X-X.X.XX.jar`
  - `controllable-fabric-X.X-X.X.XX.jar`
- **Paste** them directly into the `mods` folder.

**Your `mods` folder should look like:**
```
mods/
├── framework-fabric-26.2-0.13.26.jar
└── controllable-fabric-26.2-0.26.1.jar
```

### Step 4: Important Notes
- Do not place the files inside any subfolder.
- Ensure both files are directly in the `mods` folder.
- If you have multiple Fabric API versions, keep only the required one.

---

## 🚀 Launching the Game

1. Open TLauncher.
2. Select your **Fabric profile** from the dropdown menu.
3. Click **Play**.
4. Wait for the game to load.
5. Press the **Start button** on your Xbox controller to open the menu.

---

## 🎮 Controller Configuration

Once the game loads:

### Step 1: Open Controller Settings
1. Press the **Start button** on your controller.
2. Go to **Options**.
3. Select **Controllers** from the menu.

### Step 2: Customize Settings
From here, you can adjust:

| Setting | Description |
| :--- | :--- |
| **Sensitivity** | Adjust right stick camera speed |
| **Vibration** | Enable/disable rumble |
| **Button Mapping** | Customize each button action |
| **Analog Movement** | Enable/disable analog stick control |
| **Chat** | Set button to toggle chat |

---

## 🔧 Troubleshooting

### Issue: "Incompatible mods found!" Error

| Cause | Solution |
| :--- | :--- |
| Missing Framework | Download `framework-fabric-X.X-X.XX.XX.jar` |
| Wrong Version | Ensure mods match your Fabric loader version |
| Outdated Framework | Delete old Fabric API, use the required version |

### Issue: Controller Not Working

| Cause | Solution |
| :--- | :--- |
| Controller not connected | Connect controller **before** launching the game |
| Driver issues | Test in `joy.cpl` (Windows) |
| Mod conflict | Remove other mods temporarily |

### Issue: Game Crashes on Launch

| Cause | Solution |
| :--- | :--- |
| Incompatible mods | Delete all mods, re-add only Framework and Controllable |
| Wrong Minecraft version | Match mods to your exact game version |
| Insufficient RAM | Allocate more RAM in TLauncher settings |

### Issue: Server Rejects Connection

| Cause | Solution |
| :--- | :--- |
| Anti-cheat detection | Analog movement is disabled by default on servers |
| Permission issue | Enable in settings at your own risk |

---

## 📖 Quick Reference

### Recommended Mods Location
```
C:\Users\[YourUsername]\AppData\Roaming\.minecraft\mods\
```

### Keyboard Shortcuts
| Key | Action |
| :--- | :--- |
| `F3` | Show debug info |
| `Esc` | Pause menu |
| `F11` | Fullscreen toggle |

### Controller Controls (Default)
| Button | Action |
| :--- | :--- |
| **Left Stick** | Move |
| **Right Stick** | Look around |
| **A** | Jump |
| **B** | Crouch/Sneak |
| **X** | Use/Interact |
| **Y** | Open Inventory |
| **Left Trigger** | Sprint |
| **Right Trigger** | Attack/Mine |
| **Start** | Pause/Open Menu |
| **Back** | Show/Hide Chat |

---

## 🔗 Useful Links

| Resource | URL |
| :--- | :--- |
| TLauncher | https://tlauncher.org/en/ |
| Fabric Installer | https://fabricmc.net/ |
| Controllable Mod (Official) | https://mrcrayfish.com/mods/controllable |
| Fabric API (Modrinth) | https://modrinth.com/mod/fabric-api |

---

## 📝 Final Notes

✅ **Working Setup:**
- TLauncher + Fabric Loader 26.2
- Framework 0.13.26
- Controllable 0.26.1
- Xbox Controller (Wired/Bluetooth)

✅ **Benefits:**
- Native controller support
- On-screen button hints
- Vibration feedback
- Customizable controls

✅ **Limitations:**
- Analog movement disabled on some servers
- Requires Fabric mod loader

---

**Enjoy your Minecraft gaming session on the big screen! 🎮✨**

*If you found this guide helpful, share it with others who want to play Minecraft with a controller on their TV.*