ControllerSupport
Full controller support for Burglin' Gnomes — navigation, gameplay, UI, menus, settings, task list, hand range control, and native bug fixes. Equipment item moving still requires mouse and keyboard.
模組介紹 作者原文
ControllerSupport
Full gamepad support for Burglin' Gnomes. Navigate every menu, shop, and HUD element with a controller — no keyboard or mouse required.
⚠️ IMPORTANT: Steam Controller Setup Required
Steam lists Burglin' Gnomes as a game that does not support controllers. This means Steam's default controller configuration will emulate keyboard and mouse (WASD) instead of passing through real gamepad input.
This mod will NOT work properly with the default Steam configuration. You must change your Steam controller config so the game receives proper Xbox controller input:
- Open Steam → Settings → Controller.
- Find Burglin' Gnomes in your library and select it.
- Under Controller Layout, change from the default WASD emulation to Gamepad with Joystick Trackpad or Xbox Controller (any layout that sends native gamepad events, not keyboard/mouse emulation).
- Launch the game — ControllerSupport will detect and handle the gamepad input correctly.
If your controller only works for movement but menus and buttons don't respond, this is almost certainly the issue.
Features
- Complete controller navigation — Every screen is navigable with the D-pad and left stick: main menu, settings, shop, papyrus, task list, death/downed overlays, and more.
- Full gameplay bindings — Move, look, jump, crouch, sprint, interact, push, attack, drop, ragdoll, and use items, all mapped to sensible default gamepad controls.
- Shop and catalog support — Browse and purchase items from the shop and catalog using left-stick navigation with proper focus handling and visual indicators.
- In-game settings — Adjust deadzones, response curves, sensitivity, and gameplay toggles directly from the game's options menu. No config file editing required.
- Adjustable deadzones — Separate deadzone values for left stick, right stick, and left trigger. Eliminate stick drift or tighten responsiveness to your liking.
- Response curve options — Choose between Linear, Exponential, Aggressive, and Smooth response curves for each stick independently. Fine-tune the feel of your aim and movement.
- Sensitivity control — Separate look and movement sensitivity sliders.
- Toggle or hold — Optionally switch crouch and sprint to toggle-on/toggle-off instead of hold.
- Invert look Y — Standard inverted-Y option for players who prefer it.
- GloveRangeAdjust compatible — Automatically suppresses LB/RB (ragdoll/drop) while actively levitating an item with Gnomium Gloves, so the bumpers can control glove range instead. No configuration needed.
- Co-op compatible — Works in multiplayer sessions. Push-to-talk and all social features remain accessible.
- Native bug fixes — Includes fixes for several game-side issues: stamina draining while sprint is held but the player is not moving, cursor staying hidden on dead/tied task overlays (M&K), mouse look not locking on dead/tied task overlays (M&K), and cleanup when the local player is revived or untied.
Known Limitations
- Equipment inventory dragging — Moving equipment items between inventory slots requires a mouse. All other inventory interactions (browsing, selecting, using items) work with controller. This may be addressed in a future update if a clean implementation is found.
Requirements
- BepInEx (v5.4.2100 or later)
Installation
- Install BepInEx via r2modman or Mod Manager.
- Install this mod via r2modman or Mod Manager.
- Launch the game — the mod loads automatically.
Task List & Info Overlay
The task list and its detail overlay have dedicated controls for gamepad:
- Navigate tasks — Use the Right Stick up/down to move between tasks in the task list.
- Open task details — Press A on a selected task to open its info overlay.
- Navigate foldouts — In the info overlay, use the Right Stick up/down to select foldout sections.
- Scroll foldout content — Use LB/RB to scroll through the expanded foldout content. This maps to the bumpers because the right stick is already used for foldout navigation, making
安裝與使用 安裝:按包內說明操作
- 解壓本站下載的壓縮包,先讀包內的 readme / 說明檔案。
- 多數模組依賴遊戲的模組載入器:常見做法是用社群模組管理器(如 r2modman)選中本遊戲安裝,由管理器自動處理載入器與依賴。
- 手動安裝時,把模組檔案放進遊戲目錄下對應的 Mod / plugins 資料夾。
- 啟動遊戲確認載入成功;帶「前置依賴」的模組需要把依賴一併安裝。
不同模組的安裝位置差異較大,包內說明是最可靠的依據。
下面這些內容需要先安裝,否則該模組不會生效: