How yashr-cmd/runtime-agent works
Transfinity is a JVM runtime agent for protecting a Minecraft runtime, with gameplay protections and hostile-mod/transformer defenses. The main workflow is launch-time native setup, agent startup, and bytecode patching that delegates runtime checks to protection modules. Additional branches cover armor-invulnerability Lua rules, launcher and event-bus guards, and hostile-thread detection. The README is empty; relationships below rely on sampled source and the SOURCE INDEX, so unsampled behavior is represented only where those references support it.
Main entry points: RuntimeAgent.java Runtime agent · NativeBootstrap.java Native bootstrap · RuntimePatch.java Bytecode patcher · HostileRegistry.java Hostile registry
Components 28
Launch bootstrap
- Native bootstrap
src/main/java/runtime/bootstrap/NativeBootstrap.java - JVM launch context
src/main/java/runtime/bootstrap/JvmLaunchContext.java - Launch context contract
src/main/java/runtime/bootstrap/LaunchContext.java - Platform detection
src/main/java/runtime/bootstrap/NativePlatform.java - Native library extraction
src/main/java/runtime/bootstrap/NativeLibraryExtractor.java - Server launch detection
src/main/java/runtime/bootstrap/ServerLaunchDetector.java - Server native attach
src/main/java/runtime/bootstrap/ServerNativeAttach.java - Attach entry point
src/main/java/runtime/AttacherMain.java - JVMTI agent binaries
src/main/resources/JVMTI_AGENT
Agent runtime
- Runtime agent
src/main/java/runtime/RuntimeAgent.java - Bytecode patcher
src/main/java/runtime/RuntimePatch.java - Transformer watchdog
src/main/java/runtime/TransformerWatchdog.java
Runtime defenses
- Thread sanitizer
src/main/java/runtime/ThreadSanitizer.java - Hostile registry
src/main/java/runtime/HostileRegistry.java - Trust checker
src/main/java/runtime/TrustChecker.java - Launcher state guard
src/main/java/runtime/LauncherStateGuard.java - Forge launcher guard
src/main/java/runtime/ForgeLauncherGuard.java - Event bus fixer
src/main/java/runtime/EventBusFixer.java
Gameplay protections
- Armor lock guard
src/main/java/runtime/ArmorLockGuard.java - Armor invulnerability bridge
src/main/java/runtime/ArmorInvulnBridge.java - Lua armor engine
src/main/java/runtime/LuaArmorEngine.java - Armor invulnerability rules
src/main/resources/scripts/lua/armor_invuln.lua - Health guard
src/main/java/runtime/HealthGuard.java - God-mode helper
src/main/java/runtime/GodHelper.java - Preator spoof
src/main/java/runtime/PreatorSpoof.java
Runtime support
- Hardened thread
src/main/java/runtime/HardenedThread.java - Agent logging
src/main/java/runtime/AgentLog.java
Other components
- Game launcher
Connections 39
- Game launcher → Native bootstrap: starts or attaches
- Native bootstrap → JVM launch context: reads launch state
src/main/java/runtime/bootstrap/NativeBootstrap.java - JVM launch context → Launch context contract: implements
src/main/java/runtime/bootstrap/JvmLaunchContext.java - Native bootstrap → Platform detection: selects platform
src/main/java/runtime/bootstrap/NativeBootstrap.java - Native bootstrap → Native library extraction: extracts library
src/main/java/runtime/bootstrap/NativeBootstrap.java - Native bootstrap → Server launch detection: checks server launch
src/main/java/runtime/bootstrap/NativeBootstrap.java - Native bootstrap → Server native attach: attaches server agent
src/main/java/runtime/bootstrap/NativeBootstrap.java - Native bootstrap → JVMTI agent binaries: loads native library
- Attach entry point → Server native attach: supports attachment
src/main/java/runtime/bootstrap/ServerNativeAttach.java - Native bootstrap → Runtime agent: relaunches with agent
src/main/java/runtime/RuntimeAgent.java - Runtime agent → Bytecode patcher: registers transformer
src/main/java/runtime/RuntimeAgent.java - Runtime agent → Transformer watchdog: starts watchdog
src/main/java/runtime/RuntimeAgent.java - Runtime agent → Hardened thread: starts on thread
src/main/java/runtime/RuntimeAgent.java - Runtime agent → Launcher state guard: initializes guard
src/main/java/runtime/RuntimeAgent.java - Runtime agent → Forge launcher guard: initializes guard
src/main/java/runtime/RuntimeAgent.java - Runtime agent → Thread sanitizer: initializes sanitizer
src/main/java/runtime/RuntimeAgent.java - Runtime agent → Event bus fixer: initializes fixer
src/main/java/runtime/RuntimeAgent.java - Runtime agent → Health guard: initializes guard
src/main/java/runtime/RuntimeAgent.java - Runtime agent → Armor lock guard: initializes guard
src/main/java/runtime/RuntimeAgent.java - Runtime agent → Lua armor engine: initializes engine
src/main/java/runtime/RuntimeAgent.java - Runtime agent → Hostile registry: initializes registry
src/main/java/runtime/RuntimeAgent.java - Runtime agent → God-mode helper: initializes helper
src/main/java/runtime/RuntimeAgent.java - Runtime agent → Preator spoof: initializes spoofing
src/main/java/runtime/RuntimeAgent.java - Bytecode patcher → Armor lock guard: injects armor checks
src/main/java/runtime/RuntimePatch.java - Bytecode patcher → Health guard: injects health checks
src/main/java/runtime/RuntimePatch.java - Bytecode patcher → God-mode helper: injects god checks
src/main/java/runtime/RuntimePatch.java - Bytecode patcher → Preator spoof: references spoofing
src/main/java/runtime/RuntimePatch.java - Bytecode patcher → Hostile registry: references registry
src/main/java/runtime/RuntimePatch.java - Bytecode patcher → Thread sanitizer: references sanitizer
src/main/java/runtime/RuntimePatch.java - Thread sanitizer → Hostile registry: checks hostile threads
src/main/java/runtime/ThreadSanitizer.java - Event bus fixer → Hostile registry: consults registry
src/main/java/runtime/EventBusFixer.java - Forge launcher guard → Hostile registry: consults registry
src/main/java/runtime/ForgeLauncherGuard.java - Armor lock guard → Trust checker: checks trust
src/main/java/runtime/ArmorLockGuard.java - Health guard → Trust checker: checks trust
src/main/java/runtime/HealthGuard.java - Armor invulnerability bridge → Lua armor engine: calls engine
src/main/java/runtime/ArmorInvulnBridge.java - Lua armor engine → Armor invulnerability rules: loads rules
src/main/java/runtime/LuaArmorEngine.java - Runtime agent → Agent logging: writes diagnostics
src/main/java/runtime/RuntimeAgent.java - Bytecode patcher → Agent logging: writes diagnostics
src/main/java/runtime/RuntimePatch.java - Native bootstrap → Agent logging: writes diagnostics
src/main/java/runtime/bootstrap/NativeBootstrap.java