Launching the Game in IntelliJ IDEA
Learn how to utilize the various launch profiles to start and debug your mods in a live game environment through IntelliJ IDEA.
WARNING
This page is written for version 1.21.10. Documentation for older versions may be incomplete.
Fabric Loom provides a variety of launch profiles to help you start and debug your mods in a live game environment. This guide will cover the various launch profiles and how to use them to debug and playtest your mods.
Launch Profiles
If you're using IntelliJ IDEA, you can find the launch profiles in the top-right corner of the window. Click the dropdown menu to see the available launch profiles.
There should be a client and server profile, with the option to either run it normally or in debug mode:
Gradle Tasks
If you're using the command line, you can use the following Gradle commands to start the game:
./gradlew runClient- Start the game in client mode../gradlew runServer- Start the game in server mode.
The only problem with this approach is that you can't easily debug your code. If you want to debug your code, you'll need to use the launch profiles in IntelliJ IDEA or via your IDE's Gradle integration.
Hotswapping Classes
When you run the game in debug mode, you can hotswap your classes without restarting the game. This is useful for quickly testing changes to your code.
You're still quite limited though:
- You can't add or remove methods
- You can't change method parameters
- You can't add or remove fields
However, by using the JetBrains Runtime, you are able to circumvent most of the limitations, and even add or remove classes and methods. This should allow most changes to take effect without restarting the game.
Don't forget to add the following to the VM Arguments option in your Minecraft run configuration:
-XX:+AllowEnhancedClassRedefinitionHotswapping Mixins
If you're using Mixins, you can hotswap your Mixin classes without restarting the game. This is useful for quickly testing changes to your Mixins.
You will need to install the Mixin Java agent for this to work though.
1. Locate the Mixin Library Jar
In IntelliJ IDEA, you can find the mixin library jar in the "External Libraries" section of the "Project" section:
You will need to copy the jar's "Absolute Path" for the next step.
2. Add the -javaagent VM Argument
In your "Minecraft Client" and or "Minecraft Server" run configuration, add the following to the VM Arguments option:
-javaagent:"path to mixin library jar here"
Now, you should be able to modify the contents of your mixin methods during debugging and have the changes take effect without restarting the game.