summaryrefslogtreecommitdiff
path: root/src/main/java/ftbsc/lll/IInjector.java
blob: d22353694d7a6956583ca643622d3233e56dcd21 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
package ftbsc.lll;

import org.objectweb.asm.tree.ClassNode;
import org.objectweb.asm.tree.MethodNode;

/**
 * Patch classes should implement this interface and be declared as services in
 * the META-INF/services folder (or through modules in Java 9+, but only Java 8
 * is officially supported).
 */

public interface IInjector {

   /**
    * @return name of injector, for logging
    */
   String name();

   /**
    * @return reason for this patch, for logging
    */
   default String reason() { return "No reason specified"; }

   /**
    * This is used by the Launch Plugin to identify which classes should be
    * altered, and on which classes should this injector operate.
    * Class name should be dot-separated, for example "net.minecraft.client.Minecraft".
    * @return class to transform
    */
   String targetClass();

   /**
    * This is used by the Launch Plugin to identify the method to transform within
    * the class. It should return the Searge name of target.
    * Example: "func_71407_l", which is "tick()" on "Minecraft" class in 1.16.5
    *
    * @return method to transform
    */
   String methodName();

   /**
    * This should return the target method's descriptor.
    * Methods in Java may have the same name but different parameters: a descriptor
    * compiles that information, as well as the return type, in as little space as
    * possible.
    * Examples:
    * (IF)V - returns void, takes in int and float
    * (Ljava/lang/Object;)I - returns int, takes in a java.lang.Object
    * (ILjava/lang/String;)[I - returns int[], takes in an int and a String
    * See <a href="https://asm.ow2.io/asm4-guide.pdf">https://asm.ow2.io/asm4-guide.pdf</a> for a more detailed explanation.
    * @return descriptor of method to target.
    */
   String methodDesc();

   /**
    * This method will be called once the Launch Plugin has identified the right class and
    * method to patch. Override this for the actual patching.
    * @param clazz  class node currently being patched
    * @param method node of method currently being patched
    */
   void inject(ClassNode clazz, MethodNode method);
}