A Minecraft Forge compatible mod that enables controller usage on PC Minecraft.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
Paulscode IBXM Library License.txt
Paulscode SoundSystem CodecIBXM License.txt


Source installation information for modders

This code follows the Minecraft Forge installation methodology. It will apply some small patches to the vanilla MCP source code, giving you and it access to some of the data and functions you need to build a successful mod.

Note also that the patches are built against "unrenamed" MCP source code (aka srgnames) - this means that you will not be able to read them directly against normal code.

Source pack installation information:

Setting up MinecraftForge

Step 1: Download the latest MDK from MinecraftForge

Step 2: Extract the ZIP file

Step 3: Open a terminal/shell in the folder you unzipped the files in

Step 4: Setup the MinecraftForge sources:

  • Windows: gradlew setupDecompWorkspace
  • Linux/Mac OS: ./gradlew setupDecompWorkspace

Step 5: Set up your workspace:

  • Eclipse
    1. For eclipse, run "gradlew eclipse" (./gradlew eclipse if you are on Mac/Linux)
  • IntelliJ IDEA
    1. Open IDEA, and import project.
    2. Select your build.gradle file and have it import.
    3. Once it's finished you must close IntelliJ and run the following command: gradlew genIntellijRuns

Step 6: Finally, open up your IDE. If Eclipse, change your workspace to ./eclipse

If at any point you are missing libraries in your IDE, or you've run into problems you can run "gradlew --refresh-dependencies" to refresh the local cache. "gradlew clean" to reset everything {this does not affect your code} and then start the processs again.

See the Forge Documentation online for more detailed instructions: http://mcforge.readthedocs.io/en/latest/gettingstarted/

Step 7: Move the sources over into the MDK folder. Run! Enjoy.


If you would like to contribute:

  1. Follow the steps above to setup your workspace
  2. Build your feature or fix your bug on a different branch than master
  3. Create a pull request
  4. I'll review your request. Please address comments and squash your commits into a single commit.
  5. I'll pull your changes.