Minecraft Mods Station
This repository is an attempt to create documentation and manage resources for a Minecraft Mods station at Hack the Future events.
This station had focused on modding Minecraft: Java Edition. Starting with HtF 21 we’ve favored hacking Minecraft: Pi Edition or its PC implementation (RaspberryJuice). This allows use of Python and provides a much speedier setup. Read more about it on the station-raspberry-pi repo.
Ideally a laptop to use with the Forge modding environment should have at least
a Core i7 CPU
8 GB of RAM
Compiling Java for such a large project can be CPU-intensive, so a slower computer may result in much waiting throughout each debug cycle. Furthermore, Forge has heavy memory requirements, and a smaller physical RAM set may result in less memory allocated to the JVM and obscure errors.
These problems are not insurmountable, but if you find yourself with an underpowered machine at the Minecraft Mods station, consider requesting a loaner laptop from the station captain.
The following are recommended prerequisites for the Minecraft Mods station. Mentors can help install them at the event. However, if they are pre-installed, participants can get started even faster.
Most of the lesson materials are currently stored on a Google
Drive folder. You can find recent versions of the above software,
as well as a
README.pdf with screenshots of various hack ideas.
Minecraft mods Gdrive folder (
Once you have a recent version of the JDK installed and the Forge Mdk unzipped, run ForgeGradle via:
gradlew setupDecompWorkspace idea
If you hit an error about incompatibility with Java 9, you may
have to tell it explicitly to use your Java 8 installation. On Mac,
set this environment variable before rerunning
or on Windows:
set JAVA_HOME="C:\Program Files\Java\jdk1.8.0_1??"
This download-and-decompile step can take a while depending on your internet connection and computer’s horsepower. Once it’s done, make the bulk of the Minecraft source code available via:
mv build/tmp/recompileMc/sources/net src/main/java/
If on Windows, use the
move command and backslashes for the
path separators, i.e.
move build\tmp\recompileMc\sources\net src\main\java\
From here you can launch IntelliJ IDEA, open up the project by selecting your forge folder, and select Build → Build Project. The initial build ought to take a few minutes.
If you’ve gotten this far, you’ve completed the bulk of the "hurry up and wait" procedure. Congratulations! From here, the ensuing steps may involve some troubleshooting but you’ll no longer need wait on compiling or decompiling an entire Minecraft project.
At this point you can begin hacking, in the sense of modifying
Minecraft code and testing the resultant changes.
If you’re not sure what code to edit first, again go check out
some pictures and examples in
README.pdf linked above.
Arun Gupta has written a README called Minecraft Modding using Forge for his devoxx4kids workshop.
Bob Freitas has written an advanced tutorial for creating tools and weapons out of a new material, Red Diamond.
These tutorials have been used at past HtF events and may reference Eclipse (another IDE) or older versions of Forge. With the help of your mentors, however, these lessons can be readily adapted to our modern environment.
This README is in the AsciiDoc Syntax.