如何在 Linux 系統上為 Minecraft 添加控制器支持

Linux 版 Minecraft Java 目前不支援原生手柄，但您可以透過用戶端手柄模組新增此功能。本指南推薦使用Fabric Loader和Controlify來實現簡單易用的設定。 Controlify 透過 SDL3 支援 Linux，相容於 Fabric 和 NeoForge，並可為遊戲、選單、物品欄、聊天、按鍵映射、震動等功能新增手把輸入。

在 Linux 桌面上開啟 Minecraft 啟動器，進入 Java 版本。 — 首先，確保你的 Linux 系統上已經安裝了可以正常運作的 Minecraft：Java 版本。

你需要什麼

一份可正常運作的《我的世界：Java版》遊戲副本。官方啟動器支援Linux系統；如有需要，請從Minecraft.net下載。
Linux 可以透過 USB 或藍牙偵測到的控制器。
模組載入器。本指南使用 Fabric，但 Controlify 也支援 NeoForge。
一個與您的 Minecraft 版本和模組載入器相符的 Controlify 檔案。

在進行任何更改之前，請務必備份重要的存檔。此外，請避免混用為不同 Minecraft 版本製作的模組檔案；版本不符是啟動失敗的最常見原因之一。

1. 為您的 Minecraft 版本安裝 Fabric Loader

請先關閉 Minecraft 和啟動器。從Fabric 官方安裝程式頁面下載通用 JAR 檔案。如果雙擊 JAR 檔案無法打開，請在終端機中執行以下命令：

java -jar fabric-installer.jar

在 Fabric 安裝程式中，選擇「客戶端」，選擇您要玩的 Minecraft 版本，保持「建立設定檔」選項啟用，然後進行安裝。 Fabric 目前的 Linux 文件建議以這種方式使用安裝程序，然後在 Minecraft 啟動器中選擇 Fabric 設定檔。

Linux 系統上的 Fabric 安裝程式用戶端窗口，具有 Minecraft 版本選擇器並啟用了「建立設定檔」功能。 — 安裝 Fabric 時，請確保其版本與您計劃與 Controlify 一起使用的 Minecraft 版本相同。

2. 下載相符的 Controlify 版本

在 Modrinth 上開啟Controlify 頁面，選擇與您的 Minecraft 版本和載入器相符的版本。 Controlify 目前的專案文件同時支援Fabric和NeoForge，因此請勿為 Fabric 設定下載 NeoForge 版本，反之亦然。

Modrinth 上的 Controlify 專案頁面顯示了對 Fabric 和 NeoForge 的支持 — 選擇 Controlify，使其與您系統上安裝的 Minecraft 版本和載入器相符。

3. 將 Controlify 放入 mods 資料夾

對於標準的 Minecraft 目錄，如果 mods 資料夾尚不存在，請建立它：

mkdir -p ~/.minecraft/mods

然後將下載的 Controlify JAR 檔案複製或移動到指定位置~/.minecraft/mods/。如果您的啟動器安裝使用了自訂遊戲目錄，則將 JAR 檔案放在該安裝目錄下的其他mods資料夾中。

Linux 檔案管理器顯示 .minecraft mods 資料夾中的 controlify.jar 文件 — Controlify JAR 檔案應該放在 Fabric 安裝目錄下的 mods 資料夾中。

4. 在Linux系統中連接控制器

使用 USB 連接控制器，或在電腦的藍牙設定中進行配對。啟動 Minecraft 前，請確認 Linux 系統能夠辨識到控制器。 Controlify 使用 SDL3 處理遊戲手把和操縱桿的輸入；其控制器支援頁面指出，支援情況可能因控制器型號、連接類型、作業系統和驅動程式而異。

Linux 藍牙設定顯示已連接遊戲控制器 — 在啟動 Minecraft 之前，請確保控制器已在 Linux 桌面層級連線。

5. 啟動 Fabric 設定文件

開啟 Minecraft 啟動器，選擇與先前步驟中使用的版本相符的 Fabric 配置，然後點選「開始遊戲」。如果 Minecraft 啟動時沒有 Controlify，請重新檢查遊戲目錄，確認 JAR 檔案位於正確的mods資料夾中。

Linux 系統上的 Minecraft 啟動器已選擇 Fabric 設定文件，並且「開始遊戲」按鈕可見。 — 請使用 Fabric 設定啟動 Minecraft，而不是使用未經修改的最新發布配置。

6. 在 Minecraft 中配置控制器輸入

Controlify 載入完成後，從 Minecraft 的選項中開啟其控制器設定或設定檔介面。具體措辭和佈局可能因版本而異，但 Controlify 提供按鍵綁定、靈敏度、死區、震動和支援的高級功能等設定。它還可以顯示控制器專屬的按鍵圖標，並允許您使用遊戲手把操作 Minecraft 選單。

Minecraft 選項螢幕，其中控制器設定項目已高亮顯示 — 模組載入完畢後，使用遊戲選項中的控制器設定來調整遊戲手把。

在加入伺服器之前，請先在單人遊戲世界中測試移動、鏡頭控制、物品欄導航、攻擊/使用動作以及暫停/選單控制。 Controlify 的文檔指出，普通伺服器無需在伺服器端安裝此模組；在伺服器上，為了防止作弊，搖桿移動可能會預設使用類似鍵盤的 WASD 操作。

Controlify 控制器設定介面，顯示已連接的 Xbox 控制器、靈敏度、震動和按鍵綁定。 — 使用 Controlify 的設定來調整所連接控制器的靈敏度、振動和按鍵映射。

如果未偵測到控制器

首先驗證 Linux 檢測：斷開控制器連接並重新連接，或透過藍牙移除並重新配對。
版本必須匹配： Minecraft、Fabric 或 NeoForge 以及 Controlify 必須彼此相容。
檢查遊戲目錄：第三方啟動器和自訂安裝可能使用不同的mods資料夾。
嘗試使用 USB：如果藍牙連接不穩定，有線連接可以幫助找出配對或驅動程式問題。
請查看特定型號的說明：陀螺儀、觸控板輸入、高清觸覺回饋或自適應扳機等功能取決於控制器和 Linux 驅動程式。官方 Controlify 相容性表格記錄了已測試的組合。

可控模組怎麼樣？

本指南的舊版使用 Forge 和 Controllable。 Controllable目前仍在維護，並發布了適用於包括 Fabric 和 NeoForge 在內的主流載入器的版本。如果現有的整合包已經依賴 Controllable，請使用與該整合包相符的版本。對於全新的 Linux 系統，Controlify 是一個不錯的選擇，因為它的文件明確涵蓋了 Linux 控制器支援、現代載入器、按鍵映射、SDL3 輸入以及控制器特有的功能。