MixinTale is a Harmony-inspired mixin/bytecode patching framework built specifically for Hytale.

It allows mod developers to modify and extend server/game behavior without editing game files, using familiar patch semantics such as Prefix / Postfix / Replace, plus advanced callsite patching (RedirectCall / WrapCall).

What makes MixinTale different

MixinTale is designed for modern Java and real modding constraints (isolated classloaders, early transforms, strong encapsulation).
To guarantee runtime reliability, MixinTale:

Uses a compile-time annotation processor to generate a patch index (mixintale.index.json) inside mod jars
Applies patches at runtime without requiring patch classes to be visible to the target classloader
Achieves this by copying patch handler methods into the target class, avoiding NoClassDefFoundError and classloader visibility issues

Key features

Harmony-like patch model: Prefix / Postfix / Replace
Callsite patching: RedirectCall / WrapCall with Operation<R> (call original safely)
Deterministic, predictable injection pipeline
Modern Java compatibility
Minimal overhead (index-based discovery, no heavy runtime scanning)

🔧 Installation (Required)

MixinTale is an early bootstrap framework and must be installed as an EarlyPlugin.

Place the MixinTale JAR in:

Singleplayer: [GameFolder]/UserData/EarlyPlugins
Dedicated Server: [ServerFolder]/EarlyPlugins

Server only: start the server with:
--accept-early-plugins

🧰 For mod developers

If you want to create mods using MixinTale, install MixinTale – Developer Tools (API + annotation processor).
This is not required for players/servers running mods — only for compiling mods.

📘 Documentation (GitHub)

https://github.com/Traktool/MixinTale

⚠️ MixinTale is a core framework, not a gameplay mod.
Other mods may depend on it to function properly.