mirror of
https://github.com/architectury/architectury-loom.git
synced 2026-03-29 04:30:00 -05:00
Update README.md
This commit is contained in:
43
README.md
43
README.md
@@ -2,6 +2,8 @@
|
|||||||
|
|
||||||
Talk to us on [Discord](https://discord.gg/C2RdJDpRBP)!
|
Talk to us on [Discord](https://discord.gg/C2RdJDpRBP)!
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
A fork of [Juuxel's Loom fork]("https://github.com/Juuxel/fabric-loom") that is a fork of [Fabric Loom](https://github.com/FabricMC/fabric-loom) that supports the Forge modding toolchain.
|
A fork of [Juuxel's Loom fork]("https://github.com/Juuxel/fabric-loom") that is a fork of [Fabric Loom](https://github.com/FabricMC/fabric-loom) that supports the Forge modding toolchain.
|
||||||
|
|
||||||
A [Gradle](https://gradle.org/) plugin to setup a deobfuscated development environment for Minecraft mods. Primarily used in the Fabric toolchain.
|
A [Gradle](https://gradle.org/) plugin to setup a deobfuscated development environment for Minecraft mods. Primarily used in the Fabric toolchain.
|
||||||
@@ -10,47 +12,10 @@ A [Gradle](https://gradle.org/) plugin to setup a deobfuscated development envir
|
|||||||
* Utilises the Fernflower and CFR decompilers to generate source code with comments.
|
* Utilises the Fernflower and CFR decompilers to generate source code with comments.
|
||||||
* Designed to support modern versions of Minecraft (Tested with 1.14.4 and upwards)
|
* Designed to support modern versions of Minecraft (Tested with 1.14.4 and upwards)
|
||||||
* ~~Built in support for IntelliJ IDEA, Eclipse and Visual Studio Code to generate run configurations for Minecraft.~~
|
* ~~Built in support for IntelliJ IDEA, Eclipse and Visual Studio Code to generate run configurations for Minecraft.~~
|
||||||
- Currently, only IntelliJ IDEA and Visual Studio Code works with Forge Loom.
|
- Currently, only IntelliJ IDEA and Visual Studio Code work with Forge Loom.
|
||||||
* Loom targets a wide range of Gradle versions. _Tested with 4.9 up to 6.7_
|
* Loom targets a wide range of Gradle versions. _Tested with 4.9 up to 6.7_
|
||||||
* Supports the latest version of Java all the way down to Java 8
|
* Supports the latest version of Java all the way down to Java 8
|
||||||
|
|
||||||
## Usage
|
## Usage
|
||||||
|
|
||||||
Starting with a Fabric project similar to the example mod,
|
View the [documentation](https://architectury.github.io/architectury-documentations/docs/forge_loom/) for usages.
|
||||||
|
|
||||||
## Use Loom to develop mods
|
|
||||||
|
|
||||||
To get started developing your own mods please follow the guide on [Setting up a mod development environment](https://fabricmc.net/wiki/tutorial:setup).
|
|
||||||
|
|
||||||
## Debugging Loom (Only needed if you want to work on Loom itself)
|
|
||||||
|
|
||||||
_This guide assumes you are using IntelliJ IDEA, other IDE's have not been tested; your experience may vary._
|
|
||||||
|
|
||||||
Then you need to set `loom.forge = true` in your `gradle.properties`,
|
|
||||||
and add the Forge dependency:
|
|
||||||
|
|
||||||
```groovy
|
|
||||||
forge "net.minecraftforge:forge:1.16.4-35.1.7"
|
|
||||||
```
|
|
||||||
|
|
||||||
You also need to remove the Fabric Loader and Fabric API dependencies.
|
|
||||||
You should also remove any access wideners and replace them with a Forge AT.
|
|
||||||
|
|
||||||
### Mixins
|
|
||||||
|
|
||||||
Mixins are used with a property in the `loom` block in build.gradle:
|
|
||||||
|
|
||||||
```groovy
|
|
||||||
loom {
|
|
||||||
mixinConfig = "mymod.mixins.json"
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
## Limitations
|
|
||||||
|
|
||||||
- Launching via IDE run configs doesn't work on Eclipse or VSCode.
|
|
||||||
- The srg -> yarn remapper used for coremod class names is *really* simple,
|
|
||||||
and might break with coremods that have multiple class names per line.
|
|
||||||
|
|
||||||
## Known Issues
|
|
||||||
- https://github.com/architectury/forgified-fabric-loom/issues
|
|
||||||
Reference in New Issue
Block a user