Almanac | Quest Chains and NPCs v1.0

Almanac
Almanac adds a full quest chain system to your server: a quest log GUI, quest giver NPCs players talk to, live objective tracking, and rewards on turn in. Quests unlock other quests through prerequisites, so you can build a real story line instead of a flat list of unrelated tasks. Everything is written in two YAML files, so you can edit the starter chain or replace it with your own.

Built for: Survival, SMP, and any server that wants players to have a reason to explore and come back.



Quest giver NPCs
Place a giver anywhere with /almanac npc create <giver>. Players right click it to see the giver's dialogue, accept an offered quest, or turn one in. Givers have no AI, cannot be pushed or killed, and never wander, so they stay exactly where you put them. Delivered items for collect objectives are handed over automatically the moment a player talks to the right giver.

Quest log and live tracking

Players open their own quest log with /almanac, /quest, /quests, or /al, and see every quest they have unlocked, its objectives, and its current progress. A tracked quest also shows live on a boss bar or the action bar, your choice in config, so the current objective is always in view without opening a menu.



Four objective types
Kill a named entity, break a named block, collect and hand over an item, or reach a set of coordinates. Mix and match inside a single quest, and set your own progress label for each one.

Four reward types
Experience, items, money through Vault, or a console command with the player's name substituted in, for handing out crate keys, ranks, or anything another plugin exposes as a command. Vault is optional. With no economy installed, money rewards are simply skipped and everything else still works.

Quest chains
Point a quest's requires list at earlier quest ids and it stays locked and hidden until they are complete. This is how the included starter chain works: three quests from Elder Rowan lead into a fourth from a second giver, Warden Sela, and you extend it the same way.

Features

• Quest log GUI opened with /almanac, showing every unlocked quest, its objectives, and live progress.
• Quest giver NPCs placed anywhere, with dialogue for offer, in progress, and complete states.
• Four objective types: kill, break, collect, and reach.
• Four reward types: experience, items, money through Vault, and console commands.
• Quest chains through prerequisites, so quests unlock in the order you design.
• Live tracking on a boss bar or the action bar, with a per player tracked quest.
• Per player progress saved to disk off the main thread, and flushed on shutdown so a restart never loses progress.
• A malformed quest or an unknown objective target is skipped with a console warning instead of crashing the load.
• A fully commented config, an editable messages file, and a ready to play starter quest chain.

Commands

• /almanac (aliases /quest, /quests, /al) opens your quest log.
• /almanac list lists your unlocked quests and their state in chat.
• /almanac track <id> and /almanac untrack change what you are tracking.
• /almanac reload reloads config, messages, and quests, and respawns NPCs.
• /almanac npc create <giver>, npc remove, and npc list manage giver NPCs.
• /almanac give <player> <id> starts a quest for a player.
• /almanac complete <player> <id> completes a quest for a player, rewards included.
• /almanac reset <player> [id|all] resets one quest or every quest for a player.

Every subcommand has tab completion filtered to what the sender has permission to use.

Permissions

• almanac.use open the quest log, track quests, and talk to givers. Default: everyone.
• almanac.admin reload, place NPCs, and grant or reset quests. Default: operators.

Configuration
Quests live in quests.yml, one block per quest with its giver, icon, description, objectives, rewards, and dialogue. Givers, their display name, and their NPC type live in config.yml, along with the save interval, tracker mode, and every sound Almanac plays. Every value has an inline comment, and /almanac reload applies changes live, respawning NPCs as needed.

Requirements

• Minecraft 1.21 to 26.1.2.
• Paper, Spigot, or Bukkit.
• Java 21.
• Vault is optional, for money rewards only.

Installation

1. Put Almanac-1.0.0.jar in your plugins folder.
2. Start the server once to create config.yml, messages.yml, and quests.yml with the built in starter chain.
3. Stand where you want your first giver and run /almanac npc create elder.
4. Right click the NPC, accept a quest, and follow the objective on your boss bar.

Try it first
Almanac is live on our test server, hosted here on BuiltByBit. Use the test server link on this page to talk to a giver and open the quest log before you buy.

Support
Questions and bug reports are welcome. Join the No Click Studios Discord at https://discord.gg/drBwA958bn.