Catalyst

Catalyst

Bytecode-level performance optimization for Hytale servers

Why this exists

Catalyst adds some batching/caching on top. The changes happen at the bytecode level, so there's no plugin API overhead and no game patches to reapply when Hytale updates.

What's actually working

Right now the project is in early stages. Here's what's implemented:

Transformer What it does

LazyBlockEntityTransformer Defers chest/furnace/sign creation until first access

LazyBlockTickTransformer Postpones tick discovery during chunk preload

LazyFluidTransformer Skips fluid sim during chunk load

BatchBlockEntityTransformer Caches block types and batches entity collection

Everything's toggleable at runtime via /catalyst menu—no restart needed.

Installation

For most users:

Download the latest JAR from: [RELEASES PAGE - ADD URL HERE]

Drop it in your early-plugins/ folder (The plugin goes in early-plugins/, not mods/. It runs before the server starts, so transformers can intercept class loading.): Windows: C:\Program Files\Hytale\install\early-plugins\

Linux (Flatpak): ~/.var/app/com.hypixel.HytaleLauncher/data/Hytale/install/early-plugins/

macOS: ~/Library/Application Support/Hytale/install/early-plugins/ (You may want to double-check the macOS path. I used the standard macOS app support location because I don't have a mac)

Restart your server

For developers:

./gradlew build ./gradlew deployEarlyPlugin The plugin goes in early-plugins/, not mods/. It runs before the server starts, so transformers can intercept class loading.

Finding the Hytale JAR

If you're on Flatpak, the paths are a bit buried:

~/.var/app/com.hypixel.HytaleLauncher/data/Hytale/ └── install/ ├── early-plugins/ # Put Catalyst here ├── mods/ # Regular plugins go here └── release/package/game/latest/ ├── Server/HytaleServer.jar └── Assets.zip Development

The transformer pattern is straightforward—extend BaseTransformer, implement transform(), and register via META-INF/services. If something goes wrong, return the original bytecode and the server continues normally.

All config fields are volatile and readable at runtime, so you can flip optimizations on/off without restarting.

./gradlew build # Build JAR ./gradlew deployEarlyPlugin # Deploy to early-plugins/ ./gradlew runServer # Launch server with mod loaded Documentation

Performance Optimizations — Roadmap and planned work

API Reference — Hytale Server Plugin API docs

Early Plugins Guide — How bytecode transformation works

Status

This is experimental. Early plugins run with full system access and can crash your server if something goes wrong. Test on a non-production world first, keep backups, and report issues.

License

MIT — do whatever you want with this code, just keep the copyright notice.