foghrye4 / mixin Goto Github PK

Mixin is a trait/mixin framework for Java using ASM and hooking into the runtime class-loading process via Mojang's LegacyLauncher system. The main documentation for Mixin can be found in the Wiki. Additional documentation for individual features and annotations can be found in the extensive Javadoc. For additional help use the channel #spongedev on the Espernet IRC network.

Mixin uses the Gradle build automation system. To perform a build, use gradle version 2.11 and execute

gradle

from within the project root directory. (If you do not have Gradle installed on your system you can instead run the supplied Gradle wrapper gradlew)

The Mixin project can be integrated easily with Eclipse using the Gradle Plugin. Simply choose Import -> Gradle Project and follow the prompts.

When developing using Mixin, you can use the Mixin Annotation Processor within Eclipse to provide context-sensitive errors and warnings to help you more easily troubleshoot your mixins. To do so:

1. Run the gradle build command to generate the mixin jar
2. Open the properties of your eclipse project and navigate to Java Compiler -> Annotation Processing -> Factory Path
3. Check the Enable project specific settings checkbox
4. Click the Add External JARs button and select the generated mixin jar with the suffix -processor (hint: it should be in Mixin/build/libs)
5. Navigate up one level to Java Compiler -> Annotation Processing
6. Check the Enable project specific settings checkbox
7. Check the Enable annotation processing checkbox
8. Click the New... button next to the Processor options box

• Set Key to reobfSrgFile
• Set Value to the fully-qualified path to the mcp-srg.srg file (for Sponge this can be found in Sponge/build/srgs/mcp-srg.srg)

9. Click OK to apply the changes

Enhanced functionality for working with Mixin in IntelliJ IDEA is available via the Minecraft Development for IntelliJ IDEA plugin developed by DemonWav.