配置

由于Mixin-0.7.11还不支持使用Forge 1.13+的ModLauncher引导，所以本教程以Forge 1.12.2-14.23.5.2838为例。

配置build.gradle

• 在buildscript中添加Sponge的Maven仓库，并应用MixinGradle插件。

  buildscript {
    repositories {
        jcenter()
        maven { url = "https://files.minecraftforge.net/maven" }
        maven { url = "https://repo.spongepowered.org/maven" }
    }
    dependencies {
        classpath 'net.minecraftforge.gradle:ForgeGradle:2.3-SNAPSHOT'
        classpath 'org.spongepowered:mixingradle:0.6-SNAPSHOT'
    }
  }
  apply plugin: 'net.minecraftforge.gradle.forge'
  apply plugin: 'org.spongepowered.mixin'

• 在repositories中添加Sponge的Maven仓库。

  repositories {
    maven { url = "https://repo.spongepowered.org/maven" }
  }

• 在dependencies中添加对Mixin的依赖，并排除Minecraft中已存在的库。

  dependencies {
    provided('org.spongepowered:mixin:0.7.11-SNAPSHOT') {
        exclude module: 'guava'
        exclude module: 'commons-io'
        exclude module: 'gson'
    }
  }

• 由于Forge并不引用Mixin，并且无法保证玩家添加的模组一定会包含Mixin，所以需要在模组打包时把Mixin一并打包进模组jar包中。 在jar中把引用的Mixin打包进去。由于Mixin需要用Tweaker引导（参见引导Mixin），所以还需要添加TweakClass

  jar {
    from configurations.provided.asFileTree.files.collect {
        zipTree(it)
    }
  
    manifest.attributes([
        "TweakClass": "com.example.ExampleTweaker"
    ])
  }

• MixinGradle添加了一个新的闭包：mixin，其所有可配置项参考这里。 一个最基本配置如下：（Mixin 混淆映射文件建议以mixins.<modid>.refmap.json的形式命名）

  mixin {
    add sourceSets.main, "mixins.example.refmap.json"
  }

  需要说明的是，正是因为有了这个文件，我们在编写代码时基本不需要过多地考虑混淆的问题，无论是在开发环境还是生产环境中，我们只需要按照mcp name写就可以了

• 配置完成后即可开始构建Forge开发环境。

配置json文件

• 在src/main/resources文件夹中新建一个json文件，推荐命名为mixins.<modid>.json

• 配置文件中的所有可配置项参考这里。
• 在Wiki中的相关属性解释：

  • package: Mixin注入类所在的父包，这个包将会被添加到LaunchClassLoader的transformerExceptions中去；

  • mixins: 客户端和服务端都运行的Mixin注入类（填写相对于package属性的全类名，下同）；

  • client: 仅在客户端运行的Mixin注入类；

  • server: 仅在服务端运行的Mixin注入类；

  • refmap: 指定Mixin的混淆映射json文件名（需要与MixinGradle中设置的一致）；

  • priority: 指定配置文件被载入的优先级，默认为1000；

  • plugin: 指定Mixin插件类名，这个类需要实现 IMixinConfigPlugin 接口，这个插件允许程序在运行时修改Mixin配置（参考扩展）；
  • required: 决定是否确保所有Mixin注入类都能找到目标类，如果设置为true，一旦未能找到，那么就会抛出异常并终止游戏运行；

  • minVersion: 指定所使用的Mixin功能出现的最低版本，如果运行中的Mixin版本低于该版本，那么就会忽略高版本Mixin中的功能；

  • setSourceFile: 决定是否让注入类覆盖目标类的 source file 属性，如果设置为true，我们大概能在打印调用堆栈时看到

      at net.minecraft.client.gui.GuiMainMenu.func_73863_a(MixinGuiMainMenu.java:514)

    而不是原先的

      at net.minecraft.client.gui.GuiMainMenu.func_73863_a(GuiMainMenu.java:514)

• 一个最基本的配置文件如下：

  {
  "package": "com.example.mixins",
  "mixins": [],
  "client": [],
  "server": []
  }

配置IDE

• 在构建Forge开发环境之后配置IDE。配置完成后，可以在编写Mixin注解时自动检查注解的合法性。

Eclipse

1. 下载Mixin项目源代码仓库
2. 在Mixin项目下运行 ./gradlew build 命令来编译生成Mixin的jar包

3. 打开项目属性，并定位到 Java 编译器 -> 注解处理 -> 工厂路径

4. 勾选 启用特定于项目的设置 复选框

5. 单击 添加外部JAR... 按钮，并选择刚刚编译生成好的带 -processor 后缀的jar包（应该位于Mixin-master/build/libs文件夹内）

6. 定位到 Java 编译器 -> 注解处理

7. 勾选 启用特定于项目的设置 复选框

8. 勾选 启用注解处理 复选框

9. 单击 新建... 按钮

   • 设置 键 为 reobfSrgFile

   • 设置 值 为 mcp-srg.srg 文件的完整路径（对于Forge 1.12.2-14.23.5.2838 以及在不修改默认 mappings 的情况下，此文件应该位于 %GRADLE_USER_HOME%\caches\minecraft\de\oceanlabs\mcp\mcp_snapshot\20171003\1.12.2\srgs 文件夹内）

10. 单击 应用并关闭 按钮即可

IntelliJ IDEA

• 安装由DemonWav开发的Minecraft Development for IntelliJ IDEA插件即可。