  🔵 Discord     ☕ Ko-fi     ⭐ Patreon     📖 Wiki  

***

QuestLinesHooks

A tiny, surgical early-plugin that powers two things the QuestLines suite can't do from a normal mod — making the use: quest tracker work, and stopping a single bad model scale from corrupting your world's chunks.

QuestLinesHooks loads before your Hytale server starts, so it can patch a couple of internal engine methods the moment they're defined. It does the absolute minimum: two precise, well-tested bytecode hooks and nothing else. No commands, no config, no overhead.

▎ ⚠️ This is a companion plugin for the QuestLines suite. It does nothing on its own — install it alongside QuestLines Core.

✨ What it does

🎯 Makes use: quest tracking possible

In Hytale, "using" an item — swinging a sword, drawing a bow, casting a tome, drinking a potion, placing a block — never fires a public event. QuestLinesHooks injects a feather-light forwarder into the interaction pipeline so QuestLines Core can finally see those actions. That's what unlocks quest
objectives like "swing a sword 10 times" or "drink 3 potions."

The bridge between this plugin and Core uses pure JDK types only — no QuestLines classes cross the boundary, keeping the patch clean and conflict-free.

🛡️Protects your world from "chunk failed to load"

Certain NPCs (especially custom Denizens) can potentially persist a non-positive model scale to disk. The next time that chunk loads, the engine throws "Scale must be greater than 0" and the entire chunk silently fails to load — permanently, until the offending entity is hunted down.

QuestLinesHooks clamps any invalid scale (0, negative, or NaN) to a sane 1.0, exactly matching the engine's own "natural scale" behavior. This rescues already-corrupted chunks on existing worlds and prevents new ones from ever breaking.

📦 Installation

1. Drop questlines-hooks-.jar into your server's earlyplugins/ folder — not mods/.
2. Launch your server with the --accept-early-plugins flag (or --singleplayer).
3. That's it. There's no configuration.

▎ Early plugins print a loud "unsupported" banner at startup — this is expected and harmless. Without the flag, the server will refuse to start once an early plugin is present.

🔧 Requirements

- A Hytale server running the QuestLines suite
- Server launched with --accept-early-plugins

💡 Good to know

- Zero config, zero commands — install and forget.
- Safe by design — both hooks are verified offline against the real server classes using ASM's bytecode verifier before every release.

QuestLines Hooks