ScrollQuest - Paper Quests 1.2.2

ScrollQuest

A Physical Quest System with Randomized Missions & Rewards

⬥  ⬥  ⬥  ⬥  ⬥  ⬥  ⬥

Showcase

⬥  ⬥  ⬥  ⬥  ⬥  ⬥  ⬥

What is ScrollQuest?

ScrollQuest revolutionizes the traditional quest system by giving players physical paper items containing randomized missions. Each quest is unique, with varied tasks, rarities, and rewards. Players receive tangible scrolls they can collect, complete, and claim, making quests feel more immersive and valuable.

• Physical Quest Items: Quests are real items players can hold, trade, and collect
• 5 Rarity Tiers: Common, Uncommon, Rare, Epic, and Legendary with glow effects
• 12 Mission Types: Walk, Mine, Chop, Harvest, Place, Fish, Kill mobs, with specific variants
• Multiple Reward Types: Money (Vault), XP, and custom console commands
• Real-time Progress: ActionBar, Title notifications, and PlaceholderAPI placeholders
• Fully Customizable: Configure missions, rewards, rarities, and messages

⬥  ⬥  ⬥  ⬥  ⬥  ⬥  ⬥

Features

Physical Quest System

• Quests are paper items with custom lore displaying mission details
• Right-click to check progress and claim completed quests
• Each quest has a unique UUID preventing duplication
• Automatic cleanup system removes orphaned and dropped quests

5 Rarity Tiers

• COMMON: White | 10–50 progress | Basic rewards
• UNCOMMON: Green | 25–100 progress | Decent rewards
• RARE: Blue | 50–150 progress | Glowing effect
• EPIC: Purple | 100–250 progress | Glowing effect
• LEGENDARY: Gold | 200–500 progress | Glowing effect

12 Mission Types

• WALK_BLOCKS: Walk any distance
• CHOP_TREES: Chop any tree logs
• CHOP_SPECIFIC_TREE: Chop specific wood types (Oak, Spruce, Birch, Crimson, Warped, etc.)
• HARVEST_CROPS: Harvest any crops
• HARVEST_SPECIFIC_CROP: Harvest specific crops (Wheat, Carrots, Chorus, Kelp, Sweet Berries, etc.)
• MINE_ORES: Mine any ore blocks
• MINE_SPECIFIC_ORE: Mine specific ores (Coal, Iron, Diamond, Ancient Debris, etc.)
• PLACE_BLOCKS: Place any blocks
• CATCH_FISH: Fish in any water body
• CATCH_SPECIFIC_FISH: Catch specific fish types (Cod, Salmon, Pufferfish, Tropical Fish)
• KILL_MOBS: Kill any hostile mobs
• KILL_SPECIFIC_MOB: Kill specific entities (Zombies, Skeletons, Creepers, Endermen, Wither Skeletons, etc.)

Flexible Rewards

• MONEY: Economy integration via Vault
• XP: Experience points or levels
• COMMAND: Custom console commands with %player% placeholder
• Chance-based drops: Set a 0–100% chance per reward, percentages shown in lore
• Max rewards cap: Limit rolled rewards per claim, configurable per mission or rarity
• Stack multiple reward types per quest

Progress Tracking

• Real-time ActionBar with quest name, progress bar, and percentage
• Title notifications on quest completion
• Live lore updates on quest items
• Visual progress bar: ██████████
• Stack mode, choose if identical missions progress simultaneously or one-by-one
• 9 PlaceholderAPI placeholders for scoreboards, tab lists, and chat formats
• Per-player completion stats tracked and persisted, perfect for leaderboards

Advanced Configuration

• Min/max progress amounts per rarity
• Custom sounds for completion, claims, and failures
• Adjustable title/subtitle timings and messages
• ActionBar format customization with placeholders
• Automatic cleanup with configurable intervals
• Toggle progress stacking for identical missions
• Hex color support in all messages
• Full lore localization, 15+ configurable strings, mission names and icons all translatable

Anti-Exploit Protection

• Player-placed block tracking: Breaking a block you placed yourself gives zero quest progress
• Fully grown crops only: Harvest missions require fully grown crops by default, no breaking baby wheat for free progress
• Enabled by default, fully configurable in config.yml

Resource Pack Support

• CustomModelData: Assign custom textures per rarity via config.yml
• Dynamic textures: Separate models for in-progress vs completed quests, swaps automatically
• Fully optional: Set to 0 to use vanilla item texture, no resource pack required

⬥  ⬥  ⬥  ⬥  ⬥  ⬥  ⬥

Commands & Permissions

Commands

/quest give <player> <rarity> [amount] - Give random quest of specific rarity
/quest givemission <player> <mission> [amount] - Give specific mission quest
/quests reload - Reload all configurations

Permissions

scrollquest.admin - Access to all admin commands (default: op)
scrollquest.use - Ability to use and complete quests (default: true)

Command Aliases

/quest, /quests, /mission, /missions, /scroll, /scrolls

⬥  ⬥  ⬥  ⬥  ⬥  ⬥  ⬥

How It Works

For Players

1. Receive a quest scroll from an admin or reward system
2. Read the quest details in the item lore: mission type, rarity, rewards
3. Complete the mission objectives as you play
4. Watch your progress in the ActionBar while holding the quest
5. Right-click the completed quest to claim your rewards

For Admins

1. Use /quest give to distribute random quests by rarity
2. Use /quest givemission to give specific mission types
3. Customize missions, rewards, and rarities in missions.yml
4. Configure behavior in config.yml
5. Edit messages and colors in messages.yml

⬥  ⬥  ⬥  ⬥  ⬥  ⬥  ⬥

Example Missions

53 pre-configured and ready to use

Common: Explorer's Journey, Novice Farmer, Apprentice Builder

Uncommon: Wanderer's Path, Forester's Duty, Expert Miner

Rare: Oak Master, Wheat Harvester, Iron Extractor, Marathon Runner

Epic: Legendary Traveler, Diamond Hunter, Titan Builder, Crimson Harvester

Legendary: Ancient Relic Hunter (1000 Ancient Debris!), Chorus Picker

⬥  ⬥  ⬥  ⬥  ⬥  ⬥  ⬥

Technical Info

• Minecraft Version: 1.16 → 1.21.10 / Spigot 26.1 (Paper/Spigot)
• Java Version: 17+ (runs fine on Java 25 JVM)
• Dependencies: None (Vault optional for economy, PlaceholderAPI optional)
• Performance: Lightweight with async data processing
• Storage: No database required, uses NBT data

⬥  ⬥  ⬥  ⬥  ⬥  ⬥  ⬥

Why ScrollQuest?

• Unique Physical System: Unlike database-driven quest plugins, quests are tangible, tradeable items
• Randomized Content: No two quests feel the same with randomized goals per rarity
• Zero Database Setup: No MySQL, SQLite, or file storage, everything via NBT
• Anti-Exploit Built In: Player-placed block tracking and fully-grown crop checks stop progress farming
• PlaceholderAPI Ready: 9 placeholders for scoreboards, tab lists, and leaderboard integration
• Beautiful Visuals: Progress bars, hex colors, glow effects, and title animations
• Highly Configurable: 3 config files with extensive customization
• Performance Optimized: Efficient tracking and automatic cleanup
• Easy to Extend: Simple YAML structure for adding custom missions

⬥  ⬥  ⬥  ⬥  ⬥  ⬥  ⬥

What's Included

• Plugin JAR file
• Pre-configured config.yml with all settings
• Pre-configured missions.yml with 53 missions
• Pre-configured messages.yml with hex color support
• Documentation in YAML files

⬥  ⬥  ⬥  ⬥  ⬥  ⬥  ⬥

Perfect For

• RPG Servers: Give quests as rewards or starter items
• Survival Servers: Add progression and goals for players
• Economy Servers: Create money-making opportunities
• Minigame Servers: Integrate quests into game rewards
• Prison / Skyblock: Add daily quest systems

⬥  ⬥  ⬥  ⬥  ⬥  ⬥  ⬥

Created by zArrowTan

If you enjoy this plugin, please leave a review!