ftbsc.lll

Interface IInjector

public interface IInjector

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).

Method Summary

Modifier and Type	Method and Description
void	inject(org.objectweb.asm.tree.ClassNode clazz, org.objectweb.asm.tree.MethodNode method) This method is to be called by the launcher after identifying the right class and method to patch.
java.lang.String	methodDesc() This should return the target method's descriptor.
java.lang.String	methodName() This is used to identify the method to transform within the class.
java.lang.String	name()
default java.lang.String	reason()
java.lang.String	targetClass() This is used to identify which classes should be altered, and on which class should this injector operate.

Method Detail

name

java.lang.String name()

Returns:

name of injector, for logging

reason

default java.lang.String reason()

Returns:

reason for this patch, for logging

targetClass

java.lang.String targetClass()

This is used to identify which classes should be altered, and on which class should this injector operate. Class name should be dot-separated, for example "net.minecraft.client.Minecraft".

Returns:

class to transform

methodName

java.lang.String methodName()

This is used to identify the method to transform within the class. It should return the name of target.

Returns:

method to transform

methodDesc

java.lang.String methodDesc()

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 ASM's documentation for a more detailed explanation.

Returns:

descriptor of method to target.

inject

void inject(org.objectweb.asm.tree.ClassNode clazz,
            org.objectweb.asm.tree.MethodNode method)

This method is to be called by the launcher after identifying the right class and method to patch. The overriding method should contain the logic for actually pathing.

Parameters:

clazz - the ClassNode currently being patched

method - the MethodNode of method currently being patched