Hypertale is a high-performance optimization mod and API extension toolkit for the Hytale (Early Access, Jan 13, 2026) server. It leverages advanced bytecode manipulation to reduce memory pressure, increase TPS stability, and provide an extended set of APIs for the next generation Hytale mods.
Downloads: GitHub Releases | ModTale
For most users, grab the latest version from the GitHub Releases page,
and drop it into your mods folder.
Hypertale features a "Smart-Installation" system:
- Uses a JAR-replacement system to safely patch the server before it is even running.
- If it fails or is unavailable, it automatically leverages the Hytale
earlypluginssystem for seamless integration.
If you prefer to build it yourself, Hypertale automatically locates your local Hytale installation to gather necessary dependencies.
- Install git and OpenJDK 25.
- Clone the repository.
- Run
./gradlew build. - Find your jar in
launcher/build/libs/Hypertale-<version>.jar.
Hypertale targets the core bottlenecks of the Hytale server, specifically focusing on Memory Pressure (the rate of memory allocation). High allocation rates trigger frequent Java Garbage Collection (GC) pauses, causing "stuttering" even on powerful hardware.
Hypertale provides two levels of optimization controlled via .hypertale/hypertale.ini:
- Regular Optimization (
optimizePluginOnlyAPIs=true): Safe, high-efficiency implementations that maintain 100% compatibility with the standard Hytale API. - Aggressive Optimization (
aggressivelyOptimizePluginOnlyAPIs=true): Extreme performance paths that may change API semantics (e.g., returning internal lists instead of copies).
Modding a closed-source game shouldn't be a guessing game. The dev module transforms Hypertale into a comprehensive development platform:
- Transparency-First Patching: In developer mode, Hypertale injects all three code paths (Vanilla, Regular, and Aggressive) into patched methods. Open them in the decompiler to see how they work.
- Reverse Engineering Suite:
- Vineflower Decompiler: Integrated and tuned specifically for Hytale's bytecode.
- HypertaleUnpicker: Automatically resolves inlined constants into readable references.
- Auto-Workspace Setup: The Gradle plugin automatically locates your Hytale installation, extracts dependencies, and configures your IDE.
Hypertale reads custom fields in your mod's manifest to enable advanced features:
| Field | Type | Description |
|---|---|---|
HypertalePreLoad |
boolean |
If true, Hypertale will load your mod in the same ClassLoader as the Hytale server (bypasses isolation). |
HypertaleJavaAgent |
string |
Specify a class to be loaded as a Java Agent for instrumentation. |
HypertaleMixinConfig |
string |
Path to a Mixin configuration file to be applied to the server. |
HypertaleServerVersion |
string |
Set a specific server version compatibility (supports * for any). |
Hypertale adds the .hypertale() extension to core Hytale classes, providing access to optimized methods and new functionality:
com.hypixel.hytale.server.core.entity.entities.Playercom.hypixel.hytale.server.core.plugin.PluginBasecom.hypixel.hytale.server.core.universe.PlayerRefcom.hypixel.hytale.server.core.universe.world.World
Hypertale includes custom compatibility or official support for:
- ModSync: Full bootstrap support.
- Mod List Mods: Integrated icon support.
- Spark: Extensively tested with Spark for performance profiling.
Example Mod: HypertaleExampleMod
Hypertale is licensed under the MIT License.