ddozzi/mixin-tutorial

this tutorial is no longer being maintained!

for a more up-to-date and in-depth tutorial, check out my new tutorial!

thanks for all the support!

Mixin Tutorial - INTELLJI

I haven't seen any decent mixin tutorials, so here's one.

Topics

• Setting up your first mixin project
• Creating your first mixin

Setup

Create a new folder where ever you want your client to be.

Open up IntelliJ. Then click New Project > Gradle > Next. Set the Location to the folder you just created

Copy and paste the into your build.gradle.

Then click the "Load Gradle Changes" Button on the top right.

You might be noticing an error popping up in the bottom half, that's totally normal. It's because forgegradle doesn't support newer versions of gradle.

To fix this, go to gradle > wrapper > gradle-wrapper.properties then replace whatever version is currently there, with 4.7

Screen.Recording.2021-07-21.at.1.55.02.AM.mov

Now for the lengthy part. Replace all the "example" strings with your client name. Also replace the "net" packages with whatever fits you. An example is shown below.

! This MUST be done for all instances. DO NOT CHANGE ANY OF THE "mixin" OR "mixins" strings !

Once you are done, click the gradle button on the far right. Then click Tasks > forgegradle > setupDecompWorkspace. This will take some time.

Once that process is finished, click Tasks > forgegradle > genIntellijRuns

Click the button at the top then click Minecraft Client An example is shown below.

Screen.Recording.2021-07-21.at.2.14.01.AM.mov

Click the same button again, then click Edit Configurations. You will see an error saying "Class 'GradleStart not found in module 'ExampleClient'". To fix this, set the Client to Client.main.

Screen.Recording.2021-07-21.at.2.20.45.AM.mov

Click Apply. The error should be gone now.

Tweaker

Create a new package in src/main/java with the package name you've set in your build.gradle in this case, it would be net.example

Create a new package named mixins inside the previous pacakge then create a new java file with whatever you named your tweaker. In this case, it's ExampleTweaker.

Copy the code from this to yours.

Replace the example at Mixins.addConfiguration("mixins.example.json"); (inside your tweaker) with your client name or whatever you named your package.

So far, your project should look something like this:

Mixin Time!

Now it's time to make your first mixin!

Create a new file named whatever was inside your Mixins.addConfiguration("mixins.example.json"); inside the resource folder.

Then, copy the json from into the json file you just created.

Ok, now it's time to create an actual mixin.

Create a package named client inside the package where your tweaker is located.

Then, inside that client package, create a java file named MixinMinecraft

then add this mixin code:

@Mixin(Minecraft.class)
public class MixinMinecraft {
    @Inject(method = "createDisplay", at = @At("RETURN"))
    public void createDisplay(CallbackInfo callbackInfo) {
        Display.setTitle("Example Client | 1.8.9");
    }
}

Congrats! You've made a mixin client for 1.8.9! For more guidance, join the spongepowered and check out this

Having issues? Feel free to contact me on discord (ddozzi#6190), the code is also available

mixin-tutorial's Issues

JCenter no longer works

Since JCenter no longer works, it will not setup properly

This build.gradle should fix it

Build.gradle by xNtrow