ScrollQuest - Paper Quests 1.6.0

🛠 Admin GUI

/quest admin opens a menu for managing players and missions, behind op or scrollquest.admin.gui.

• Manage Players lists everyone online, and clicking one opens their active quests, paginated for players carrying a lot
• Each quest has Force Complete, Force Claim, and Delete. Delete removes the quest data and pulls the physical scroll if the player is online
• /quest admin <player> skips the picker and works even when that player is offline, so you can clear a broken quest for someone who is not logged in
• Manage Missions toggles a mission on or off. A disabled mission stops appearing in the random roll from /quest give, while /quest givemission can still hand one out by id
• Every screen is reskinnable in menus.yml, titles and materials included

Force Claim now removes the scroll from the player's inventory the same way a normal claim does, including one stored in their ender chest. Scrolls kept inside third-party storage plugins such as PlayerVaults are out of reach and are not touched.

📜 Getting Lost Scrolls Back

/quest recover opens a menu of quests whose scroll is genuinely gone and hands back a fresh one with its progress intact. Any player can use it, no extra permission needed.

• Only genuinely lost quests are listed. A scroll dropped on the ground nearby, or tucked inside a shulker box in the inventory, counts as found and stays out of the list
• Reissuing never duplicates. Clicking twice returns a message instead of a second scroll, and a full inventory drops the reissued scroll at your feet rather than losing it
• Lost quests now survive the cleanup task. They used to be deleted out from under the player before they ever got a chance to recover them

🚶 Walk Quests Can No Longer Be Farmed

WALK_BLOCKS progress now counts horizontal movement on foot and nothing else. Four separate ways of racking up progress without walking are closed:

• /fly and creative flight
• Elytra gliding, ascending and descending alike
• The fall after dropping out of flight, which made a height and a macro into free progress
• Jumping on the spot, which used to tick twice per jump without going anywhere

Normal walking, stairs, hills, and sprint-jumping across flat ground all count exactly as they did before.

🧩 Nexo Rewards and Targets

• ITEM rewards can hand out a Nexo item. Both nexo-item: forest_axe and nexo-item: nexo:forest_axe are accepted, an unknown id gives a clear console warning instead of failing quietly, and a full inventory drops the item at the player's feet
• Set display-name on the reward to control what the scroll lore shows instead of the raw Nexo id
• Mission targets can point at a Nexo block with target-material: "nexo:<block_id>" on MINE_SPECIFIC_ORE, CHOP_SPECIFIC_TREE, HARVEST_SPECIFIC_CROP, and PLACE_BLOCKS. Only that block counts, not a vanilla block sharing the same base material
• Nexo stays optional. Without it the plugin starts normally and notes that it is not present

⌨️ Commands and Permissions

• Command aliases: command-aliases in config.yml is empty by default. Add - "q" and /q behaves exactly like /quest. If another plugin already owns that command, the first one registered keeps it
• Exact targets: /quest givemission <player> <mission> <quantity> [target] takes an optional fifth argument that pins the target instead of rolling one from the mission's rarity range. Tab-completed quantities now stay within a stack
• Player commands are no longer gated behind admin. A normal player can run toggle actionbar and recover, while give, givemission, reload, and admin still need permission

✨ Smaller Improvements

• The actionbar shows the final tick of a quest, 3/3, instead of freezing one short
• A single-item reward reads as just its name, with no 1x in front. Amounts above one keep the prefix, and the two formats are separate keys in messages.yml, lore.reward-item and lore.reward-item-single
• Quest data is saved in batches rather than continuously, so a server full of walk quests no longer hitches

⚠️ Upgrade Notes

• Restart, do not just reload. config.yml, messages.yml, and menus.yml migrate on a fresh load, and your own values and translations are kept as they are
• Help lines render again. A migration fault left new lines such as the help entries showing "Message not found" on upgraded servers
• Orphan deletion is now opt-in. cleanup.delete-orphaned-quests ships as false so lost quests stay recoverable. Set it to true for the old behaviour, where quest data for a missing scroll is eventually deleted

📦 Install

Replace the old jar in plugins/ with the new one and restart. Quest data, missions, and your config files carry over.

📋 Version Breakdown