Complete Language System - Full Message Customization

• ✓ Comprehensive language file support with lang/en.yml for all plugin messages
• ✓ Support for multiple languages (create lang/de.yml, lang/fr.yml, etc.)
• ✓ All GUI text, commands, holograms, errors, and success messages are now customizable
• ✓ Placeholder system for dynamic content (%player%, %cost%, %chunk%, etc.)
• ✓ Automatic fallback to English if translation keys are missing
• ✓ Easy language switching via config.yml setting
• ✓ Over 200+ customizable message keys organized by category

Custom Items Integration - Oraxen & MMOItems Support

• ✓ Full support for Oraxen custom items in biome unlock requirements
• ✓ Full support for MMOItems custom items in biome unlock requirements
• ✓ Structured format support for advanced item configurations
• ✓ Automatic detection of custom item plugins at runtime
• ✓ Visual display of custom items in unlock GUI and holograms
• ✓ Mix vanilla items and custom items in biome requirements

Minecraft 1.21.10 Support

• ✓ Upgraded from 1.20.4 to latest Minecraft version 1.21.10
• ✓ Fixed API compatibility issues for Paper 1.21.10
• ✓ Updated teleport listener for new switch expression syntax
• ✓ Replaced deprecated Enchantment.DURABILITY with UNBREAKING
• ✓ Full compatibility with latest Paper API features

Enhanced GUI System

• ✓ Improved unlock GUI with localized messages throughout
• ✓ Better visual feedback for insufficient funds/items
• ✓ Enhanced success messages with detailed unlock information
• ✓ Improved help system with step-by-step guides
• ✓ Money-based unlock UI with formatted currency display
• ✓ Material-based unlock UI with progress tracking

Modular Configuration System

• ✓ Split monolithic config.yml into focused modular files
• ✓ Separate configs for economy, holograms, borders, teams, worlds, etc.
• ✓ Automatic migration from old configuration format
• ✓ Better organization and maintainability
• ✓ Enhanced inline documentation in all config files
• ✓ 10+ focused configuration files for easy management

Biome Unlocks System Improvements

• ✓ Support for both flat and structured format configurations
• ✓ Auto-detection of format type (no manual configuration needed)
• ✓ Enhanced validation and error messages
• ✓ Better documentation with comprehensive guides
• ✓ Support for complex multi-item requirements
• ✓ Mix vanilla items with custom items seamlessly

Enhanced Error Handling

• Better error messages with language system integration
• More descriptive validation errors
• Improved logging for troubleshooting
• Graceful fallbacks for missing configuration

Performance Optimizations

• Message caching system for language files
• Optimized hologram updates
• Better state tracking to prevent duplicate operations
• Improved border update system

Language System Integration

• All hardcoded messages replaced with language keys
• Consistent message formatting across all systems
• Proper placeholder replacement throughout
• Fixed missing language keys in GUI and commands

Configuration Migration

• Improved automatic migration from old config format
• Better handling of legacy configuration files
• Preserved all existing settings during migration
• Enhanced validation during migration process

API Compatibility

• Fixed switch statement syntax for Paper 1.21.10
• Replaced deprecated enchantment API calls
• Updated teleport cause handling for latest API
• Fixed compatibility issues with latest Paper builds

Custom Item Detection

• Improved runtime detection of Oraxen and MMOItems
• Better error handling when custom item plugins are missing
• Fixed custom item display in GUI and holograms
• Enhanced validation for custom item requirements

Important: Please read before updating!

• Configuration format has changed - automatic migration provided
• Language files now required (default English included)

Upgrading from v2.0 or earlier?

• Old configs automatically migrate on first load - no manual work needed!
• Language files are generated automatically on first run
• Custom item integration requires Oraxen 1.195.1+ or MMOItems 6.10.1+
• All your data is preserved - no data loss during migration
• Backup recommended before updating (always good practice)

Required:

• Paper 1.20.4+ (or Spigot/Pufferfish)
• Java 17+

Optional (Enhanced Features):

• Oraxen 1.195.1+ - For custom items in biome requirements
• MMOItems 6.10.1+ - Alternative custom items plugin support
• FancyHolograms 2.4.2+ - For enhanced hologram displays
• Vault 1.7+ - For money-based economy integration

Quick Update Steps:

1. Download Chunklock-2.1.0.jar from releases
2. Stop your server
3. Replace old JAR file in /plugins folder
4. Start your server
5. Configs will auto-migrate on first load
6. Language files will be generated automatically
7. Configure new features as desired
8. Done! Enjoy v2.1.0

New Installation:

1. Download Chunklock-2.1.0.jar
2. Place in /plugins folder
3. Start server (configs auto-generate)
4. Run /chunklock setup 30000 to create world
5. Configure settings in plugins/Chunklock/
6. Players can use /chunklock start

New Features to Try:

• Language System: Customize all messages in lang/en.yml - make it your own!
• Custom Items: Add Oraxen/MMOItems items to biome-unlocks.yml for unique requirements
• Modular Config: Edit specific config files instead of one huge file - much easier!
• OpenAI (Optional): Set API key with /chunklock apikey <key> for AI-powered costs
• GUI System: Players can right-click blocks to open unlock GUI - super convenient!

Need Help?

• Complete Wiki: Full Documentation
• Installation Guide: Step-by-Step Setup
• Configuration Reference: All Config Options
• Discord Support: Join Our Community
• GitHub Issues: Report Bugs