mirror of
https://github.com/LegacyModdingMC/UniMixins.git
synced 2026-11-17 02:55:09 +00:00
The GasStation module still has an underline in its version string, nothing I can do about that.
80 lines
3.9 KiB
Markdown
80 lines
3.9 KiB
Markdown
# Developer usage
|
|
|
|
To migrate a build script to UniMixins, merge the following into your build script.
|
|
|
|
> If using old Gradle, replace each occurrence of `implementation` with `compile`, and ignore the `annotationProcessor` line (in old Gradle, `compile` dependencies are automatically put on the annotation processor classpath).
|
|
|
|
```gradle
|
|
repositories {
|
|
maven {
|
|
url 'https://jitpack.io'
|
|
}
|
|
}
|
|
|
|
def unimixinsVersion = "insert version here"
|
|
|
|
dependencies {
|
|
annotationProcessor("com.github.LegacyModdingMC.UniMixins:_unimixins-all-1.7.10:$unimixinsVersion:dev")
|
|
implementation("com.github.LegacyModdingMC.UniMixins:_unimixins-all-1.7.10:$unimixinsVersion:dev")
|
|
}
|
|
|
|
// Exclude conflicting transitive dependencies.
|
|
// Only needed if you depend on a mod that depends on one of these.
|
|
// This may need to be at the end of the build script.
|
|
|
|
configurations.compile.dependencies.each {
|
|
if (it instanceof ExternalModuleDependency) {
|
|
it.exclude module: "SpongeMixins"
|
|
it.exclude module: "SpongePoweredMixin"
|
|
it.exclude module: "00gasstation-mc1.7.10"
|
|
it.exclude module: "gtnhmixins"
|
|
}
|
|
}
|
|
```
|
|
|
|
You can also depend on modules individually:
|
|
|
|
```gradle
|
|
dependencies {
|
|
// One of these (note: this module doesn't have dev jars)
|
|
implementation("com.github.LegacyModdingMC.UniMixins:_unimixins-mixin-1.7.10:$unimixinsVersion+unimix.0.11.5-mixin.0.8.5")
|
|
//implementation("com.github.LegacyModdingMC.UniMixins:_unimixins-mixin-1.7.10:$unimixinsVersion+spongepowered.0.8.5")
|
|
//implementation("com.github.LegacyModdingMC.UniMixins:_unimixins-mixin-1.7.10:$unimixinsVersion+fabric.0.11.4-mixin.0.8.5")
|
|
//implementation("com.github.LegacyModdingMC.UniMixins:_unimixins-mixin-1.7.10:$unimixinsVersion+gasmix.0.8.5-gasstation_7")
|
|
//implementation("com.github.LegacyModdingMC.UniMixins:_unimixins-mixin-1.7.10:$unimixinsVersion+gtnh.0.8.5-GTNH-2")
|
|
|
|
// You don't need all the modules, only the ones your mod requires.
|
|
implementation("com.github.LegacyModdingMC.UniMixins:_unimixins-compat-1.7.10:$unimixinsVersion:dev")
|
|
implementation("com.github.LegacyModdingMC.UniMixins:_unimixins-spongemixins-1.7.10:$unimixinsVersion+gtnh.2.0.1:dev")
|
|
implementation("com.github.LegacyModdingMC.UniMixins:_unimixins-mixinbooterlegacy-1.7.10:$unimixinsVersion+1.2.0:dev")
|
|
implementation("com.github.LegacyModdingMC.UniMixins:_unimixins-gasstation-1.7.10:$unimixinsVersion+0.5.1:dev")
|
|
implementation("com.github.LegacyModdingMC.UniMixins:_unimixins-mixinextras-1.7.10:$unimixinsVersion+0.1.1:dev")
|
|
implementation("com.github.LegacyModdingMC.UniMixins:_unimixins-gtnhmixins-1.7.10:$unimixinsVersion+2.1.9:dev")
|
|
implementation("com.github.LegacyModdingMC.UniMixins:_unimixins-mixingasm-1.7.10:$unimixinsVersion+0.2.2:dev")
|
|
|
|
// Needed if not using UniMix or GTNH's Mixin fork
|
|
//implementation("com.github.LegacyModdingMC.UniMixins:_unimixins-devcompat-1.7.10:$unimixinsVersion:dev")
|
|
}
|
|
```
|
|
|
|
## Pitfalls
|
|
|
|
### Shaded ASM package name
|
|
|
|
Mods which depend on MixinBooterLegacy or GTNHMixins use the MixinBooterLegacy-style shaded ASM package name (`org.spongepowered.libraries.org.objectweb.asm`), whereas UniMix uses the legacy name (`org.spongepowered.asm.lib`). You will have to switch to the latter to make your mod compile.
|
|
|
|
```patch
|
|
-import org.spongepowered.libraries.org.objectweb.asm.tree.ClassNode;
|
|
+import org.spongepowered.asm.lib.tree.ClassNode;
|
|
```
|
|
|
|
### `--mods` hack
|
|
|
|
Some build scripts use the `--mods` program argument to add a duplicate of the mod in order to work around Mixin [preventing mixin mods on the class path from getting loaded as Forge mods.](https://github.com/SpongePowered/Mixin/issues/207) In UniMix and GTNH's Mixin fork, this issue was fixed, so this workaround should be removed since it only causes problems.
|
|
|
|
```patch
|
|
- arguments += [
|
|
- "--mods=../build/libs/$archivesBaseName-${version}.jar"
|
|
- ]
|
|
```
|