What's Changed

Bug Fixes

• Fix critical lag spikes on player quit: Player quit was saving ALL players' stats synchronously on the main thread, causing 10+ second server freezes. Now saves only the quitting player's stats, asynchronously.

New Features

• ASCII mode for challenge broadcasts: Added use-ascii-characters config option in challenges.yml for servers where players can't see Unicode emojis/box-drawing characters. When enabled, uses [1st], [2nd], [3rd] and === instead of medals and fancy borders.

Configuration

Add to your challenges.yml under settings if needed:

use-ascii-characters: true

• Updated Spigot API to 1.21-R0.1-SNAPSHOT for Minecraft 1.21.11 compatibility
• Fixed crafting challenge tracking bug (event cancellation check, improved recipe handling)
• Enhanced crafting challenges with specific item targets (comma-separated support)
• Added 5 new specific crafting challenges (tools, armor, weapons, food, redstone)
• Removed all enchanted book rewards from challenges (they had no enchantments)
• Added editable challenges.yml config file with all default challenges
• Improved challenge announcements to show tracked items

✨ Enchanted Book Support

QuestLogs now supports giving enchanted books with stored enchantments as rewards! Players can receive enchanted books that can be applied via an anvil, just like in vanilla Minecraft.

Example:

rewards:
  ENCHANTED_BOOK: 1
enchantments:
  ENCHANTED_BOOK:
    EFFICIENCY: 3
    FORTUNE: 2

🔄 Quest Reset Command

Admins can now reset player quest progress with a simple command:

/questadmin reset <player> <quest_id>

Works for both online and offline players, and supports all quest types (mining, mob kills, exploration, etc.).

Improvements

• Tab completion for reset command
• Updated examples with enchanted book configurations
• Comprehensive documentation updates

Fixed Bugs

• Quest progress no longer exceeds target amounts
  • Affects mob kill quests, mining quests, placement quests, and crafting quests
  • Progress now properly caps at required amount

🎉 QuestLogs v1.0.0 - Initial Release

The first stable release of QuestLogs! A comprehensive quest and challenge system for Minecraft Spigot 1.21+.

✨ Features

Quest System

• ✅ Multiple quest types: Exploration, Mining, Mob Kills, Crafting, Block Breaking/Placing
• ✅ Beautiful GUI Quest Book interface
• ✅ Quest prerequisites for sequential progression
• ✅ Custom quest icons and GUI positioning
• ✅ Progress tracking with configurable notifications

Player Statistics

• ✅ SQLite database for reliable data persistence
• ✅ Track playtime, blocks explored, quests completed
• ✅ Detailed breakdowns: mining, crafting, combat stats
• ✅ Leaderboard queries for all statistics
• ✅ /queststats command with comprehensive display

Timed Challenges

• ✅ Server-wide competitive mini-games
• ✅ 10 balanced default challenges included
• ✅ Automatic scheduling (configurable)
• ✅ Top 3 players receive rewards
• ✅ Challenge participation and win tracking

Reward System

• ✅ Items with custom quantities
• ✅ Enchanted books with any enchantment level
• ✅ Experience (XP) rewards
• ✅ Automatic inventory management
• ✅ Rewards displayed in GUI and completion messages

📋 Requirements

• Minecraft: 1.21+
• Server: Spigot/Paper
• Java: 21+

📥 Installation

1. Download QuestLogs-1.0.0.jar
2. Place it in your server's plugins/ folder
3. Restart your server
4. Configure plugins/QuestLogs/config.yml and quests.yml
5. Reload with /questadmin reload

🎮 Quick Start

For Players:

• /questbook - Open the quest book GUI
• /queststats - View your statistics
• /challenge - Check active challenge

For Admins:

• /questadmin reload - Reload configuration
• /questadmin complete <quest> <player> - Complete quest for player
• /challengeadmin start <challenge> - Start a specific challenge

📚 Included Examples

• 12+ example quest configurations
• 10 balanced timed challenges
• Comprehensive documentation
• GUI customization examples

🐛 Known Issues

None at this time. Please report any issues on the Issues page.

🙏 Feedback Welcome

This is the first release! Please share your feedback, bug reports, and feature requests.