How zortax/minecraftinjectionapi works
Project type and purpose
• This is an open-source Java library (MinecraftInjectionAPI) that uses the Java Instrumentation API and MCP (Minecraft Coder Pack) deobfuscation mappings to allow runtime code injection into a running Minecraft VM.
• It provides two main capabilities:
• A Java Agent + Transformer framework driven by annotations (FunctionHook, Flags, InjectPosition).
• A reflection-wrapper module that downloads MCP mappings and exposes obfuscated Minecraft classes via human-readable MCP names.
File structure
• Top-level build and CI: .travis.yml, build.sh, pom.xml.
• src/main/java/de/zortax/injection/injector:
• RuntimeInjector.java – entry point for attaching the agent.
• McAgent.java – manages transformer registration.
• McClassTransformer.java – implements java.lang.instrument.ClassFileTransformer.
• FunctionHook, Flags, InjectPosition – annotation and flags controlling injection behavior.
• src/main/java/de/zortax/injection/mcp:
• McpManager.java – downloads and caches MCP deobfuscation mappings.
• WrappedClass.java / MinecraftInstance.java – reflection-based accessors.
• gen/WrapperClassBuilder.java + GenType.java – dynamic wrapper class generator.
• Resources: META-INF/MANIFEST.MF defines the agent manifest.
• src/test/java shows a usage example (MinecraftTransformer) that drives the API.
README for additional insights
• Describes how to attach at runtime (RuntimeInjector.attachToVm) and how to declare hooks via @FunctionHook.
• Explains the reflection wrapper usage (McpManager.getWrappedClass(...)).
• Notes integration points for Forge / deobfuscated environments.
Essential architectural elements to capture
• Agent lifecycle: attach → premain/agentmain → transformer registration
• Hook discovery: annotation scanning → transformer
• Bytecode modification flow into Minecraft classes
• Dynamic mapping download & wrapper generation
• Runtime reflective access paths