Double Input: If your controller moves the camera twice as fast or skips menu items, close Steam or disable its "Desktop Configuration" for your controller. Steam and Controllable may both be sending inputs simultaneously.
Controller Not Detected: Ensure the Framework mod is installed, as it is a required dependency for Controllable in version 1.20.1. Try switching between USB and Bluetooth connections.
Incorrect Mappings: If buttons are swapped (e.g., A acts as B), you may need to update the gamecontrollerdb.txt file within the mod's JAR file using the latest SDL mappings.
Pitfalls
Old Mappings: Older versions of the mod (like 1.12.2) may not recognize modern controllers like the DualSense (PS5) without manual mapping updates.
Anti-Cheat: Some servers may flag the mod's analog movement as a "cheat" because it allows for movement angles not possible on a keyboard. It is recommended to set Analog Movement to "Local Only" when playing on public servers.