🐛 Expired Quest Progress Fix

A fix for an annoying edge case from the quest expiration system, no more players grinding away on dead scrolls without realizing.

• Expired quests now skip progress entirely - players can't accumulate progress on a scroll that's already past its expiration date
• Stops wasted grinding - previously, players could rack up progress on expired quests but couldn't claim the rewards, leading to frustration
• Existing behavior preserved - players still see the "expired" message when right-clicking, the change only affects silent background progression
• Zero config required - just update the plugin and the fix is live

🗓 Full Date Localization

Building on the rarity and lore localization from previous updates, you can now translate every part of expiration dates and time displays, completing the language overhaul for non-English servers.

• Configurable month names - translate months in messages.yml (e.g. May → Mai, December → Diciembre)
• Configurable time unit labels - swap 9d 23h to 9j 23h for French, or any other language convention
• Configurable AM/PM labels - customize for 12-hour time format to match your locale
• Time of day now shown on expiration - quests now display the exact expiry time, default format: MMM dd, yyyy hh:mm a
• Pairs perfectly with the timezone support from v1.2.0 for a fully localized expiration experience

⏰ Expiry Time Warnings

Building on the quest expiration system from v1.1.9, players now get clear feedback on how much time they have left to finish a quest, no more guessing or losing track of expiring scrolls.

• Right-click message - incomplete quests now show how much time is left when interacted with
• Smart time formatting - displays in readable chunks like 3d 5h, 12h 30m, or < 1m, no clutter like 7d 2h 15m
• Minutes only shown when relevant - kicks in only when less than a day remains, keeping the message clean otherwise
• Fully translatable - new quest-incomplete-expiry key in messages.yml with %time-left% placeholder
• Only appears when relevant - shows up only when expiration is enabled, the rarity has a non-zero duration, and time is actually remaining

🌍 Timezone-Aware Expiration

Expiration dates now respect your server's local timezone, perfect for international communities and accurate display across regions.

• Configurable timezone - set your server timezone via expiration.timezone (e.g. Asia/Kolkata, America/New_York, Europe/Berlin)
• Custom date format - tweak how expiration dates appear on quest lore via expiration.date-format using standard SimpleDateFormat patterns
• Pairs cleanly with the lore expiration display so dates always match what your players actually see on the clock

🔧 Config Auto-Update Fix

• Config auto-update now triggers properly on first load after updating, so new options added in future updates will actually show up in your config.yml without needing manual intervention

🌐 Configurable Rarity Display Names

You can now fully translate or rename every rarity tier, perfect for non-English servers or unique server themes.

• Customizable per rarity - rename Common to "Commun", Legendary to "Mythique", or whatever fits your server
• Full color code support - use hex colors or legacy codes in your custom names
• Set via display-name per rarity in config.yml
• Pairs perfectly with the lore localization from v1.1.4 for a complete language overhaul

⏳ Quest Expiration

Stop quests from piling up in player inventories forever. Now you can set expiration times per rarity to keep your quest economy fresh.

• Per-rarity expiration durations - set short timers for Commons and longer ones for Legendaries (e.g. Common "10d", Legendary "1mo")
• Flexible unit support - use hours (12h), days (7d), or months (1mo)
• Auto-cleanup on interaction - expired quests are removed when right-clicked, with a clear message to the player
• Set 0 to skip expiration for any specific rarity
• Disabled by default - enable via expiration.enabled: true in config.yml, existing quests are unaffected

🐛 Bug Fixes

• Cactus column counting - fixed cactus columns not counting properly due to growth-stage detection treating them as immature
• Bamboo saplings - now properly included in bamboo column counting
• Chorus mission accuracy - chorus plant mid-stages no longer trigger progress, only chorus flowers (the actual harvestable part) count
• Quest display names in messages - quest complete, claimed, received, and ActionBar messages now properly show your configured display name instead of the internal ID
• Color codes in quest names - color codes now render correctly across all quest messages, no more raw & codes showing up

🌾 Column Plant Counting

Harvesting tall plants now feels way more natural, breaking the base of a sugar cane stack credits you for the entire column, not just one block.

• Works on sugar cane, cactus, bamboo, and kelp - all the classic stackable plants
• Breaks count the full column above - chopping the 2nd block of a 5-tall sugar cane gives 4 progress instead of 1
• No more tedious top-down harvesting - players can break from the base like they naturally would
• Toggle-able - set progress-behavior.count-column-plants to false in config.yml if you want strict single-block counting
• Enabled by default - no setup required, just update and go

📊 Per-Rarity Quest Completion Placeholders

Building on the PlaceholderAPI integration from v1.1.6, you can now track how many quests each player has completed at every rarity tier, perfect for tiered leaderboards, role rewards, and player stat displays.

• 5 new placeholders for per-rarity completion counts:
• %scrollquest_completed_common% - Total Common quests completed
• %scrollquest_completed_uncommon% - Total Uncommon quests completed
• %scrollquest_completed_rare% - Total Rare quests completed
• %scrollquest_completed_epic% - Total Epic quests completed
• %scrollquest_completed_legendary% - Total Legendary quests completed
• Case-insensitive - works with any capitalization
• Fully backward compatible - existing %scrollquest_completed% total still works, no config changes needed
• No data loss - existing player-stats.yml files load fine, new completions start tracking per-rarity from this update onward

Includes Fixes for Sweet Berries

🔌 PlaceholderAPI Integration

ScrollQuest now plays nice with PlaceholderAPI, opening up a ton of possibilities for scoreboards, tab lists, chat formats, and custom GUIs.

• 9 new placeholders covering completed quests, active quests, current quest details, and progress info
• %scrollquest_completed% - Total quests completed by the player
• %scrollquest_active% - Number of quests currently in progress
• %scrollquest_quest_name%, _rarity%, _progress%, _target%, _percentage%, _type%, _completed%
• Per-player quest completion stats are now tracked and persisted, perfect for leaderboards
• PlaceholderAPI is a soft dependency, so the plugin still works fine without it

🛡 Anti-Exploit Protection

Stops players from cheesing quest progress by placing and breaking the same blocks over and over.

• Player-placed block tracking - Breaking a block you placed yourself gives zero quest progress
• Fully configurable via anti-exploit.track-placed-blocks in config.yml
• Enabled by default, no setup required

🎁 Smarter Reward Control

More tools to fine-tune your economy and reward balance.

• Chance-based rewards - Set a 0-100% chance per reward in missions.yml. Non-guaranteed rewards now show their drop percentage right in the item lore
• Max rewards cap - Limit how many rolled rewards a player gets per claim, configurable per mission or per rarity
• Fully grown crops only - HARVEST_SPECIFIC_CROP missions now require crops to be fully grown by default, no more breaking baby wheat for free progress

🌱 5 New Missions

Fresh content out of the box, no config tweaking needed.

• Crimson Harvester - Chop crimson stems in the Nether
• Warped Collector - Chop warped stems in the Nether
• Chorus Picker - Harvest chorus flowers in the End
• Kelp Farmer - Harvest kelp underwater
• Sweet Berry Picker - Harvest sweet berry bushes

🐛 Bug Fixes

• Nether wood support - Chop missions now properly recognize crimson and warped stems/hyphae
• End and underwater crops - Harvest missions now correctly count chorus flowers, kelp, and kelp plants
• Block-to-item mismatch - Missions for sweet berries, kelp, and chorus now work no matter which form (block or item) you configure them with
• Auto-migration - Existing servers updating from v1.1.5 will automatically get the new mission defaults and crop settings, no manual config edits needed

Latest version of the plugin