Troubleshooting a Controller Not Working

If your controller does not respond in Minecraft or you see a screen stating that no controllers are currently connected, check your setup and Controlify's diagnostic options.

Edition and Mod Compatibility

First, verify that you are playing Minecraft: Java Edition, as Controlify is built exclusively for Java rather than Bedrock Edition. If you use performance or shader mods like Sodium or Iris, you do not need to remove them—Controlify is compatible with both.

Checking Detection and Natives

1. Open the Minecraft mod menu interface and click on Controlify.

2. If the interface displays a message that no controllers are connected, check your USB cable or system Bluetooth pairing to ensure your computer recognizes the device outside the game.

3. Open Controlify's Global Settings menu and look for the Load Natives feature. Read the on-screen description and ensure it is configured properly, as native libraries handle direct communication with controller hardware and advanced features.

4. Check the Out of Focus Input setting in Global Settings; if it is turned off, make sure you have clicked inside the Minecraft window so it has system focus.

Reporting Persistent Bugs

If your device works in other games but still fails to appear in Controlify, open the Global Settings menu and select the Open Issue Tracker option to check known hardware issues or report the problem.