QuestCitizens v1.0

Have you ever wanted a Install and forget Quest plugin that does not require hours of setup? Well you can but you wont need to. QuestCitizens have been preconfigured and balanced with over 1000+ pre-setup Randomized quests that feels totally new every time you complete a quest. You will never rotate the same old Bring quests.



There are 21 different actions (Bring, Use, Travel, Visit Biome, Break, Place, Break "Silk Touch", Craft, Plant, Harvest, Smelt, Brew, Enchant, Trade, Smith, Fish, Fish "treasure", Breed, Shear, Tame, Kill) that is rolled into the quests that are Category accurate. Eg. You wont let a farmer mine diamonds. You would however let a farmer tame and breed animals. A explorer Category quest will see you riding Camels, Using maps and spyglasses as well as relying on the handy compass to get around. This will challenge your player base to really go out there and play the game.

As you can see for Trader. Kill quests arent enabled but you can enable it if you so wish


As you can imagine the config file is 4000+ lines but the best part is you would never have to open it. It is 100% fully GUI diven from the '/questadmin gui' menu with hot config. You update the config it updates in the Gui. You update the Gui it updates the config. NO SERVER RESTARTS NEEDED

Some unique Quests to name a few: (Distance and amounts are always random and not counted into the 1000+ variations of quests)
1. Travel On foot at night
2. Travel in a cave (Only movement in a cave is counted)
3. Go ride a Pig (Carrot on a stick anyone?)
4. Use a Spyglass
5. Plant Potatoes
6. Harvest Cocoa
7. Kill Piglins
8. Visit 8 different biomes
...
... Quests wont always be easy


The best of all is the Quest tracked allows the player to pin up to 3 Categories of quests. *Side Note. If you have TAB installed you need to add the API to your TAB config but fear not. If you dont have TAB it will display the progress in chat and in your vanilla footer (Holding Tab) - Full documentation is available on Discord for the API with premium support for life



Progress can also be shown in chat to the player



QuestCitizens is a Paper 1.21+ quest plugin built around Citizens NPCs but you dont need Citizens. You can bypass this by using "/quest menu" once permission have been granted. Players get category-based quest lines (e.g. miner, farmer, fisher) with unlock levels, XP, and weighted random tier selection so the same category stays fresh.

You can manage all Online players from the GUI


This includes skipping a quest with or without a reward. Show their active tracked quests, Their rewards and even reset either their Category or all their stats.

Setting up your NPC's is seamless as it integrates directly into Citizens where you can use the admin GUI to allocate Categories or the full quest menu if you dont want to place 18 Citizens down



This plugin has thought of it all as a Player/OP/Owner and catered for all of them. The features are to long to write down but its intuitive and easy to change if you ever feel the out of the box experience needs some tweaking.

So here is the technical writeup of what QuestCitizens will add to your server

Quest flow

• Standard quests — progress in the world (break blocks, craft, fish, kill mobs, travel, explore biomes, trade, brew, enchant, turn in items at NPCs, and more).
• Timed quests — same categories with a countdown; faster completions can surface on “fastest run” leaderboards.
• Turn-in objectives (ITEM_TURN_IN) require returning to the same category NPC with the required items.
• On completion, players see chat feedback with item rewards listed (e.g. You received 10x Diamond, 16x Iron Ingot.). Extra effects can be added via console command lines in the reward chest.

Rewards

• Per category, one reward chest per objective type (e.g. all HARVEST_MATURE_CROPS tiers share one loot table). Tier order in the editor does not create duplicate pools.
• Each chest supports pick-count random draws, item lines, and command-rewards (runs as console). Placeholders: %player%, %category%, %tier%, %quest_kind%, %objective_type%, %objective_material%, %objective_amount%.

Progress & storage

• SQLite database under plugins/QuestCitizens/ (active quests, history, leaderboard totals, last completed tier, pins).
• Versioned config config_<pluginVersion>.yml is created from the bundled default on first install; hot reload when the file changes (interval in config).

Integrations (soft-dependencies)

• Citizens — right-click NPCs for category/menu flows; bind NPCs to categories in-game with the "/questadmin gui".
• Vault — optional economy payouts per completion (configurable caps).
• PlaceholderAPI — expansion "questcitizens" for scoreboards / TAB (pinned quests, totals, top-10 boards) or any other API based plugin that can be configured.

Admin tooling

- "/questadmin gui" full QuestAdmin inventory: players, resets, NPC binding, quest editor (types / tier order / materials / reward chests), anti-exploit toggles, DB backup & vacuum, audit, leaderboard resets.

Fair play

- Configurable anti-exploit rules (e.g. survival-only progress, fishing caught-state, craft result slot, creative exceptions, item-use cooldowns).

Commands & permissions

• Player: /quest (active quests, pin categories, leaderboards, optional full menu for OP).
• Admin: /questadmin (GUI + console utilities).
• See README.md for the full command table, permission nodes, and GUI screen-by-screen tour.

Requirements

• Paper (or compatible fork) 1.21+ matching plugin.yml api-version.
• Java 21 server runtime recommended (matches plugin toolchain).

Support scope

• Full support provided for the life of the Mod on Discord. Updates for 26.x is planned as soon as Paper is stable
• Full readme is available as well as in person support with setup (not that you need it) on Discord from the developer
• Discord Server - https://discord.gg/aS5QKrC9jJ