EaglerForgeInjector/docs/apidoc/reflect.md

ModAPI.reflect

ModAPI.reflect supplies a user friendly wrapper for accessing and interacting with java classes from javascript.

Properties:

• classes: ReflectClass[]
  • ModAPI.reflect.classes is an array of ReflectClasses, representing (almost) every java class.
• classMap: Map<String, ReflectClass> is a map of every class.

Methods:

• ModAPI.reflect.getClassById(classId: String) : ReflectClass
  • This method is used to find a class by its id.
  • For example, to get the Minecraft class, you can use ModAPI.reflect.getClassById("net.minecraft.client.Minecraft")
• ModAPI.reflect.getClassByName(className: String) : ReflectClass
  • This method is used to find a class by its id.
  • For example, to get the Minecraft class, you can use ModAPI.reflect.getClassById("Minecraft")
  • This runs slower than getClassById because it has to filter through all classes. Make sure to cache the result rather than calling it over and over again.
• ModAPI.reflect.getSuper(rClass: ReflectClass, filter: Function?) : Function
  • Gets a super function from a reflect class. This is used to extend built in classes, like Block.
  • For an example, see lines 29 and 33 in unlucky_blocks.js
  • When called without a filter function, the filter defaults to (fn)=>fn.length === 1
• ModAPI.reflect.prototypeStack(rClass: ReflectClass, target: Class/ConstructorFunction) : void
  • Copies methods from a reflect class and it's parents onto a target native JavaScript class. This allows TeaVM to use these objects normally, without you having to manually reimplement every method. In other words, this is the equivalent of extending a class.
  • Also adds some metadata to make the class work with ModAPI.util.asClass
  • Example usage
• ModAPI.reflect.implements(target: Class/ConstructorFunction, interface: ReflectClass)
  • Marks the provided interface as a supertype of the target class.
  • JavaScript equivalent of the implements keyword

ReflectClass Definition

Each ReflectClass has the following properties:

• binaryName: String?
  • The binary name of the class in question. Eg: Lnet.minecraft.client.entity.EntityPlayerSP;
  • Will be null if hasMeta is equal to false
• class: Class?
  • The actual class. Cannot be used easily with new keyword, this is mostly useful for extending using prototype.
  • Will be null if hasMeta is equal to false
• compiledName: String
  • The TeaVM compiled name of the class. It is equal to the first letters of the package, an underscore, and the class name. Eg: nmce_EntityPlayerSP
• constructors: Function[]
  • The constructors for the class.
• hasMeta: Boolean
  • Wether or not the class has metadata saved by TeaVM.
• id: String?
  • The class id of the class. Eg: net.minecraft.client.entity.EntityPlayerSP
  • Will be null if hasMeta is equal to false
• name: String
  • The name of the class. Eg: EntityPlayerSP
• methods: Map<String, ReflectMethod>
• staticMethods: Map<String, ReflectMethod>
• staticVariableNames: String[]
  • List of all the static variable names for the class.
• staticVariables: Map<String, *>
  • key-value dictionary of all the static variables in a class.
• superclass: ReflectClass?
  • The superclass.

Each ReflectClass has the following methods:

• instanceOf(object: Object)
  • Checks if the object is an instance of the class.
• getConstructorByArgs(...argumentNames) : Function
  • Finds a constructor that matches the specified argument names. Eg:
  • ModAPI.reflect.getClassByName("ItemStack").getConstructorByArgs("blockIn", "amount")

ReflectMethod Definition

Each ReflectMethod has the following properties:

• methodName: String
  • The compiled method name of the method. Eg: nmce_EntityPlayerSP_closeScreen.
• methodNameShort: String
  • The short name of the method. Eg: closeScreen.

Each ReflectClass has the following methods:

• method(...)
  • This is the java method.
  • If it is an instance method (accessed from a ReflectClasses' methods property), the first argument should be an instance of the class. Eg: ModAPI.reflect.getClassByName("EntityPlayerSP").methods.closeScreen.method(ModAPI.player.getRef())
  • If it is a static method (accessed from a ReflectClasses' staticMethods property), call the method as usual. Eg: ModAPI.reflect.getClassById("net.minecraft.init.Items").staticMethods.getRegisteredItem.method(ModAPI.util.str("apple"))

Keep in mind that you need to wrap strings using ModAPI.util.str("MyString"), convert booleans into respective numbers (true->1, false->0), and get references of ModAPI proxies (ModAPI.player->ModAPI.player.getRef());