QuestLines Hooks

Addon for QuestLines to enable advanced features.
QuestLines Hooks
WikiLicenseDiscordKo-fiPatreon

Officially partnered with Bearded.Host
Need a server? Get 25% off at our partner Bearded.Host with code Redstoner.

QuestLinesHooks

A tiny, surgical early-plugin that powers the handful of things the QuestLines suite cannot do from a normal mod — item-use and creature-capture quest tracking, a world-map marker permission gate, and a guard that stops one bad model scale from corrupting your world's chunks.

QuestLinesHooks loads before your Hytale server starts, so it can patch a few internal engine methods the moment they are defined. It does the absolute minimum: precise, individually verified bytecode hooks and nothing else. No commands, no config, no measurable 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 is what unlocks quest objectives like "swing a sword 10 times" or "drink 3 potions".

🪤 Makes capture: quest tracking possible

Catching a creature in a capture crate is likewise invisible to plugins. A second hook reports successful captures to Core, so you can write objectives around taming and collecting specific creatures.

🗺️ Gates world-map marker creation

Hytale lets any player drop markers on the shared world map, with no permission attached. This hook lets QuestLines Core decide, per player, whether a marker may be placed — gated behind questlines.mapmarker.create (default false). If Core registers no gate the hook stays out of the way entirely, so the behaviour is unchanged for anyone not using it.

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

Certain NPCs (especially custom Denizens) can 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" behaviour. This rescues already-corrupted chunks on existing worlds and prevents new ones from ever breaking.

Every bridge between this plugin and the rest of the suite uses pure JDK types only — no QuestLines classes cross the boundary, keeping the patches clean and conflict-free.

📦 Installation

  1. Drop the 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 is 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 — every hook is verified offline against the real server classes using ASM's bytecode verifier before each release.
  • Each hook fails open. If an engine method it targets changes shape, that hook simply does not install; the server still starts and the rest keep working.

The QuestLines Suite

Every plugin works standalone; together they share one ecosystem.

  • QuestLines Core — dialogue, quests, requirements, actions
  • Icons — floating quest-state icons above NPCs
  • Dialog — in-game linear dialogue builder
  • Titles — player title and rank rewards
  • GUI — custom in-game interfaces, no code required
  • Claims — land protection, regions, rent and buy plots
  • Denizens — native NPC manager
  • Arcade — arcade, board and puzzle games
  • Hooks — early plugin unlocking extra quest tracking (this plugin)
  • MMO — parties, guilds, dungeons, duels and item sets
  • Mimics — chests that stand up and fight
  • Nations — cities and nations built on Claims
  • Balloons — balloons to dye, decorate and tie up
  • Cartographer — a live web map of your server

QuestLines Hooks Team

profile avatar
  • 16
    Followers
  • 11
    Projects
  • 15.9K
    Downloads
Donate

More from RedStonerView all