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 glowing effects
• 8 Mission Types - Walk, Mine, Chop, Harvest, Place, and specific material missions
• Multiple Reward Types - Money (Vault), XP, and custom commands
• Real-time Progress Tracking - ActionBar and Title notifications
• 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/dropped quests

✨ 5 Rarity Tiers

• COMMON - White color, 10-50 progress, basic rewards
• UNCOMMON - Green color, 25-100 progress, decent rewards
• RARE - Blue color with glowing effect, 50-150 progress
• EPIC - Purple color with glowing effect, 100-250 progress
• LEGENDARY - Gold color with glowing effect, 200-500 progress

8 Mission Types

• WALK_BLOCKS - Walk any distance
• CHOP_TREES - Chop any tree logs
• CHOP_SPECIFIC_TREE - Chop specific wood types (Oak, Spruce, Birch, etc.)
• HARVEST_CROPS - Harvest any crops
• HARVEST_SPECIFIC_CROP - Harvest specific crops (Wheat, Carrots, Potatoes, Beetroots)
• MINE_ORES - Mine any ore blocks
• MINE_SPECIFIC_ORE - Mine specific ores (Coal, Iron, Diamond, Ancient Debris, etc.)
• PLACE_BLOCKS - Place any blocks

Flexible Reward System

• MONEY - Give economy money (requires Vault)
• XP - Give experience points
• COMMAND - Execute custom console commands with %player% placeholder
• Multiple rewards per quest supported
• Custom reward display names in quest lore

Progress Tracking

• Real-time ActionBar showing quest name, progress bar, and percentage
• Title notifications for quest completion
• Live lore updates on quest items
• Progress shown as visual bar: ██████████
• Stack mode: Choose if identical missions progress simultaneously or one-by-one

⚙️ Advanced Configuration

• Customize min/max progress amounts per rarity
• Configure sounds for quest completion, claims, and failures
• Adjust title/subtitle timings and messages
• ActionBar format customization with placeholders
• Automatic quest cleanup system with configurable intervals
• Toggle progress stacking for identical missions
• Hex color support in all messages

Commands:
Permissions:
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
Legendary: Ancient Relic Hunter (1000 Ancient Debris!)

• Minecraft Version: 1.18+ (Paper/Spigot)
• Java Version: 17
• Dependencies: None (Vault optional for economy)
• API Version: 1.18
• Performance: Lightweight with async data processing
• Database: None required (uses NBT data storage)

• Unique Physical System - Unlike database-driven quest plugins, ScrollQuest uses physical items making quests feel tangible and tradeable
• Randomized Content - No two quests feel the same with randomized goals within rarity ranges
• Zero Database Setup - No MySQL, SQLite, or file storage needed—everything stored via NBT
• Beautiful Visual Feedback - Progress bars, hex colors, glowing effects, and title animations
• Highly Configurable - 3 config files with extensive customization options
• Performance Optimized - Efficient progress tracking and automatic cleanup systems
• 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 30+ 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 Servers - Add daily quest systems