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

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

Full Localization

• 15+ configurable lore strings — Type labels, progress text, reward formats, bar characters, claim instructions
• All 12 mission type names — Translatable to any language
• Mission type icons — Customize emojis or symbols per type
• Rarity display names — Rename Common to "Commun", Legendary to "Mythique", anything goes (with full color code support)
• Perfect for non-English communities or themed servers

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

Quest Expiration System

• Per-rarity expiration durations — set short timers for Commons and longer ones for Legendaries
• Flexible unit support — hours (12h), days (7d), or months (1mo)
• Expiration date shown on quest lore — players always know when their scrolls expire
• Time remaining countdown — incomplete quests show clean countdowns like 3d 5h or < 1m on right-click
• Timezone-aware — configure your server timezone and custom date format
• Fully optional — disabled by default, opt in when you're ready

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
Command Aliases

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

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

• Minecraft Version — 1.16 → 1.21.11 / 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

• 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

• 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

• 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