ScrollQuest - Paper Quests 1.3.0

🌍 Per-World Blacklist

Quest progress can now be switched off in whichever worlds you name. Useful for creative worlds, plot worlds and spawn builds, where blocks are free and a player could otherwise finish a mining or building quest in seconds.

worlds:
  blacklist:
    - "creative"
    - "plotworld"

In a blacklisted world nothing counts toward a quest: no walking, breaking, placing, fishing or killing, and sweet berry bush harvesting is covered too.

• Claiming still works everywhere. A quest finished in survival can be claimed in a blacklisted world. Only earning progress is blocked
• Giving quests works in any world, so staff are never blocked
• World names are case-insensitive, and a name that matches no loaded world is simply ignored with no errors
• Changes apply on reload, no restart needed
• Empty by default, so nothing changes until you add a world

📄 Config Updates That Keep Your Work

Updating used to cost you every comment in the file. A real config went from 81 comment lines to 2. That is over.

• Your values are never overwritten. An edited reward, message or rarity setting stays exactly as you set it
• Your keys are never deleted. Custom missions and extra message keys survive every update
• Your comments are kept, and new settings arrive with their own explanations
• A broken file is left alone. A YAML syntax error used to fall back to defaults and could write that state back over your file. Now the plugin refuses to start, names the file, and touches nothing
• Reload runs the same safe merge, so hand edits are checked rather than skipped

Two things worth knowing. Your files are rewritten in the bundled key order and quoting is normalised, though the values themselves are untouched. And a default mission you deleted comes back on the next start, as it always has. To retire one, rename it or empty its rewards.

🛠 Fixes

Place missions with no target material now count. Any PLACE_BLOCKS mission without a target-material silently ignored every block a player placed, so progress sat at zero forever and the quest could never be finished. Three of the four default place missions were affected.

A missing target now means any block counts. Missions that already had one were never affected, and the specific mission types are unchanged. Add target-material to a mission if you want it restricted to one block.

Active quests keep their stored progress, so a stuck place quest resumes counting from wherever it was.

Giving a random quest names the quest. It used to announce the number of quests given instead of the mission's display name. Both the player message and the admin confirmation now name it, and giving several at once lists what was rolled.

📦 Install

Stop the server, replace the old jar in plugins/ with ScrollQuest-1.3.0.jar, and start it again. Your files are migrated in place on first start, with nothing to do by hand. The new worlds section is added to your config with its explanatory comments, empty by default.

🧪 Compatibility

Minecraft 1.16 and newer on Spigot or Paper, Java 17 or higher.