Skip to content

Commit 35e9584

Browse files
authored
docs: updated readme
1 parent 89b657d commit 35e9584

File tree

1 file changed

+10
-9
lines changed

1 file changed

+10
-9
lines changed

README.md

+10-9
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,8 @@
11
# Lillero
2-
32
Lillero is a lightweight and simple Java ASM patching framework built on top of [ObjectWeb's ASM library](https://asm.ow2.io/).
43

54
## How
6-
This library provides the core interface, `IInjector`, as well as a small set of utils to make your life easier. All patches should implement `IInjector` and be declared as [services](https://docs.oracle.com/javase/8/docs/api/java/util/ServiceLoader.html).
5+
This library provides the core interface, `IInjector`, as well as a small set of utils to make your life easier. Your patches should implement `IInjector`.
76

87
Some methods *must* be implemented, specifying which class and method will be patched:
98
* `targetClass()`: returns the *fully qualified name* of the class to patch (example: `net.minecraft.client.Minecraft`).
@@ -17,8 +16,7 @@ There's some more optional methods you *don't have to* implement, but really sho
1716

1817
Finally, you should mark your classes as service providers, by creating a text file called `ftbsc.lll.IInjector` in `src/main/resources/META-INF/services` on your project. Inside, put the fully qualified names of your patches (example: `ftbsc.bscv.asm.patches.TestPatch$TickPatch`).
1918

20-
If you use Gradle (you do) don't forget to add this library as a dependency in your `build.gradle`:
21-
19+
Add this library into your build system of choice (Gradle is shown, but anything supporting Maven repositories will do):
2220
```groovy
2321
repositories {
2422
maven { url = 'https://maven.fantabos.co' }
@@ -30,13 +28,16 @@ dependencies {
3028

3129
You are going to need an appropriate loader to use Lillero patches: **this is just a library and does nothing by itself**. You need to make it work by loading services implementing the `IInjector` interface, and by calling their `inject(ClassNode, MethodNode)` methods with the appropriate parameters.
3230

33-
Finally, know that you can spare yourself some trouble, by using this [annotation processor](https://github.com/zaaarf/lillero-processor/) to reduce boilerplate to a minimum.
31+
It should also be noted that this library will be required at runtime for your patches to function. You will either have to bundle it using [Shadow](https://github.com/johnrengelman/shadow) or similar, or get this into your runtime classpath by some other means (our [loader](https://github.com/zaaarf/lillero-loader/), for instance, takes care of this for you).
32+
33+
Finally, know that you can spare yourself some trouble, by using this [annotation processor](https://github.com/zaaarf/lillero-processor/) to reduce boilerplate code to a minimum.
3434

3535
#### Tips specific to Minecraft patching
36-
* You want to be using Notch (fully obfuscated) names whenever you are told to reference a class or method by name, since those are the ones that exist at runtime.
37-
- Use MCP (AKA unobfuscated) names if you are running from ForgeGradle's runClient task.
38-
- If you are using our loader (see below), use Searge (obfuscated but unique) names in every place you are told to use a name - ModLauncher will do the rest.
39-
* Use our [loader](https://github.com/zaaarf/lillero-loader/) that hooks into Forge's ModLauncher if you're writing a Forge mod.
36+
* In "raw" environments, you want to be using Notch (fully obfuscated) names whenever you are told to reference a class or method by name, since those are the ones that exist at runtime.
37+
- Use deobfuscated names if you are running from ForgeGradle's or loom's runClient task.
38+
- If you are using our loader (see below), use intermediary (unreadable but unique) names in every place you are told to use a name - ModLauncher will do the rest.
39+
- If you are loading this through (Fabric-ASM)[https://github.com/Chocohead/Fabric-ASM], use intermediary representation.
40+
* Use our [loader](https://github.com/zaaarf/lillero-loader/) that hooks into Forge's ModLauncher if you're writing a modern Forge mod.
4041
* Make sure to dunk on all the naysayers who tried to force you to use Mixin!
4142

4243
#### Example Minecraft patch

0 commit comments

Comments
 (0)