QuestCore

A whole quest experience in one plugin — and not a single dependency.

Write quests in YAML. Hand them out with quest givers you place yourself. Take
deliveries in real chests in the world. Let players browse everything in a
journal with live progress bars. Translate the story separately from the buttons.
And run one command to find every problem before your players do.

No database. No Citizens. No WorldGuard. No economy plugin. No Bedrock form
toolkit. Everything is YAML you can read, and every word a player sees ships in
English and Dutch.

📜 Quests, in YAML you can actually read

  miner_pickaxe:
    name: '&6Lost Family Pickaxe'
    description: 'Bring 10 gold ingots to the Miner Supply Chest.'
    npc-id: 1
    prerequisites: []
    objectives:
      - id: pickaxe_gold
        type: DEPOSIT_TO_CHEST
        target: 1:GOLD_INGOT
        amount: 10
    rewards:
      xp: 120
      commands:
        - 'eco give {player} 2000'

Eight objective types: KILL_MOB, BREAK_BLOCK, PLACE_BLOCK,
COLLECT_ITEM, TALK_TO_NPC, VISIT_ZONE, DEPOSIT_TO_CHEST,
WITHDRAW_FROM_CHEST.

Prerequisite chains, repeatable quests, an optional permission gate, and rewards
made of items, XP, console commands and chat lines. Commands are the escape
hatch that keeps the plugin dependency-free — eco give {player} 2000 works
with whatever economy plugin you already run.

📦 Quest chests that cannot be abused

A real chest in your world that players right-click.

• Delivery mode takes exactly what the player's quests still need and hands
  the rest straight back. Nothing is stored, so it can never be used as free
  storage and nobody can take another player's delivery.
• Storage mode keeps its contents — personal per player, or one shared box an
  admin can stock — and turns the before/after difference into progress, so no
  shift-click, drag or hotbar swap can slip past the accounting.
• A per-chest item whitelist, a configurable size and title, and admin-only
  block breaking.

/questchest create | place | mode | title | filter | shared | link.

🧑‍🌾 Quest-giver NPCs — the plugin's own

No Citizens. Place one where you stand, give it a name, a one-line role and a
greeting in each language, and pick any living entity as its body (or NONE
for an invisible click point over a build you made yourself).

Right-click it: the greeting appears in chat, a line reminds the player which
objective they are on, and the journal opens on that NPC's quests.

Holograms are capped at three lines — name, role, hint — enforced in code,
not just in config.

📖 A journal worth opening

Tabs for in-progress, available and completed quests, plus a page per quest
giver. Quest cards with status colours, live progress bars and percentages,
every objective ticked off individually, and a reward preview — with console
commands shown as "A special reward" rather than leaking your internals.

Built on a self-contained menu framework that cancels every item movement, so a
journal can never be used to duplicate items.

🌍 Translate the story, not the buttons

Quest titles, descriptions and objective text live in their own
quest-content_<code>.yml, separate from the interface strings. A translator can
work on your story without scrolling past error messages, and any player can pick
their own quest language with /questlang — independently of the interface.

Missing a key? It falls back to the default language, then to quests.yml, then
to a generated line from a per-type template. A half-finished translation
degrades to real words, never to a placeholder.

🔁 Rotating dailies and weeklies

Optional per-player daily and weekly objectives with proper reset windows,
reusing the same objective types and reward bundles as everything else.

🔎 The package audit

The feature you will use most.

/questaudit
  [ERROR] chest '1' does not accept ANCIENT_DEBRIS, but 'miner_drill' tells players to deposit it
  [ERROR] quest 'book_medals' needs prerequisite 'book_scroll', which does not exist
  [ERROR] quest 'side_a' can never be started (broken or circular prerequisites)
  [WARN]  quest 'elias_craft' points at quest giver #3, which has no position yet

Dangling prerequisites, circular chains, unreachable quests, missing chests and
NPCs, unknown items and entities, malformed targets, chests that reject the very
item a quest asks for, and per-language translation gaps.

A quest that is broken normally does not throw — it just quietly never completes.
This finds those.

Entity hygiene is the headline

This plugin spawns display entities for the floating text, so it is built to be
tidy:

• Every entity is configured pre-spawn and marked non-persistent — the
  server never writes a hologram into a region file, so a crash or a hard restart
  leaves nothing behind.
• Every entity is tagged with its NPC id and role, so an orphan can always be
  identified — even one from an older build.
• Sweeps run on enable (before anything is spawned), on chunk load, and
  on a timer, plus /questnpc cleanup on demand.
• No chunk tickets, ever. A quest hub does not cost you a permanently loaded
  chunk.
• Bodies have AI off and are invulnerable, silent and non-collidable.
• Bukkit API only — no NMS, no reflection, nothing version-locked.

Modular & standalone

Seven modules you switch on or off: quests, questchests, questnpcs,
journal, questlang, dynamicquests, questaudit. A module whose dependency
is off logs one clear line and stays off rather than half-starting — a chest
that silently swallows items is worse than a chest that does not open.

All data is plain YAML you can open, read and repair by hand.

Built for Paper 26.1

Adventure components everywhere, registry-based type lookups, pre-spawn entity
configuration, TextDisplay holograms. No deprecated-for-removal API anywhere,
and the build finishes with zero compiler warnings.

Ships with 94 JUnit tests covering the parts that matter: objective-type
parsing, the prerequisite/repeatability/permission gate matrix, per-objective
progress bookkeeping, <chestId>:<MATERIAL> parsing and matching, chest
before/after deltas, cuboid-zone containment, daily and weekly reset-window
maths, the three-line hologram cap, progress-bar rendering, and the audit's
graph checks including cycle detection.

Languages

English and Dutch out of the box, for both the interface and the quest content.
Add your own by copying one file.