### ️ **CRITICAL BUG FIXES** #### **Asynchronous Operations** - **FIXED:** Critical server errors and instability caused by performing Bukkit API calls (world loading, unloading, deletion) on asynchronous threads. - **FIXED:** Potential server freezes when deleting worlds due to slow file operations blocking the main thread. - **IMPROVED:** All world management operations are now fully thread-safe, preventing data corruption and unexpected crashes. ### **TECHNICAL IMPROVEMENTS** #### ️ **Architecture** - **IMPROVED:** Refactored `WorldManager` and `LilWorldsAPI` to correctly separate heavy, non-API tasks (like file deletion) from main-thread-only Bukkit calls. - **IMPROVED:** The internal list of managed worlds now uses a `ConcurrentHashMap` to guarantee safe access from multiple threads. - **NEW:** The `deleteWorld` process now returns a `CompletableFuture`, providing a more robust and modern asynchronous API for developers. ### ️ **IMPLEMENTATION** #### ⚙️ **Correct Asynchronous Pattern** The API now safely handles threading, allowing developers to call asynchronous methods without worrying about server stability. ```java // Example: Asynchronously and safely deleting a world lilWorldsAPI.deleteWorldAsync("world_to_delete").thenAccept(success -> { if (success) { player.sendMessage("World deleted successfully!"); } else { player.sendMessage("Error: Could not delete the world."); } }); ``` ### **COMPATIBILITY** #### ️ **Backward Support** - **MAINTAINED:** Fully backward compatible. No changes are required for existing code that uses the API. - **MAINTAINED:** All command syntax and behavior remain identical for users. - **MAINTAINED:** No configuration migrations are needed. ### **UPDATE SUMMARY** 1. **Fixed Critical Threading Issues:** Resolved major stability problems by ensuring all Bukkit API calls run on the main server thread. 2. **Eliminated Server Lag:** Moved slow file deletion operations to a separate thread, preventing server freezes. 3. **Enhanced Reliability:** Made the plugin significantly more stable and safe for production environments.

### 🛠️ **CRITICAL BUG FIXES** #### 🚨 **WorldEdit Compatibility** - **FIXED:** Startup crashes when WorldEdit missing (`NoClassDefFoundError`) - **FIXED:** Portal system requiring WorldEdit for basic operation - **IMPROVED:** Graceful fallback to manual coordinates ### 🌐 **LOCALIZATION** #### 📝 **Portal Message System** - **NEW:** 50+ messages moved to `messages.yml` - **NEW:** Consistent formatting and placeholders (`{name}`, `{world}`) - **NEW:** Multi-language support with easy customization ```yaml # Example Messages portal-created-success: "&aPortal '{name}' created successfully!" portal-worldedit-not-found: "&cWorldEdit required for visual selection" ``` ### 🔧 **TECHNICAL IMPROVEMENTS** #### 🔄 **Dependency Handling** - **NEW:** Reflection-based WorldEdit integration - **NEW:** Runtime detection and feature toggling - **IMPROVED:** Clean separation of optional/core features #### 🛡️ **Architecture** - **IMPROVED:** Independent plugin initialization - **IMPROVED:** Enhanced error handling with clear feedback - **IMPROVED:** Better command system resilience ### 🎯 **PORTAL ENHANCEMENTS** #### 🌀 **Creation Flexibility** - **IMPROVED:** Unified workflow (WorldEdit/manual modes) - **IMPROVED:** Automatic detection of available features - **NEW:** Clear guidance for both creation methods ### 🏗️ **IMPLEMENTATION** #### ⚙️ **Reflection Example** ```java // Safe dynamic WorldEdit loading Class<?> worldEditClass = Class.forName("com.sk89q.worldedit.WorldEdit"); ``` #### 📦 **Dependency Config** - **MAINTAINED:** WorldEdit as `softdepend` (plugin.yml) - **MAINTAINED:** Full functionality without WorldEdit ### 🎯 **USAGE EXAMPLES** #### Without WorldEdit: ```bash /portal create myportal world_nether 10 64 10 15 70 15 0 64 0 ``` #### With WorldEdit: ```bash //wand /portal create myportal world_nether ``` ### 🔄 **COMPATIBILITY** #### 🛡️ **Backward Support** - **MAINTAINED:** All existing functionality preserved - **MAINTAINED:** Identical command syntax - **MAINTAINED:** No config migrations needed ### 📋 **HOTFIX SUMMARY** 1. Fixed WorldEdit-related startup crashes 2. Implemented complete message localization

### 🚀 **MAJOR NEW FEATURES** #### 🌐 **Complete Portal System** - **NEW:** Built-in portal system with WorldEdit integration (`//wand` support) - **NEW:** Persistent storage in `portals.yml` and cooldown system - **NEW:** Frame customization, API support, and portal management #### 🔧 **WorldEdit Integration** - **NEW:** Visual boundary selection and automatic detection - **NEW:** Fallback to manual coordinates when unavailable - **NEW:** Enhanced UX with seamless plugin integration #### 📡 **Portal Command System** - **NEW:** `/portal create|delete|list|info|tp|reload` - Full management suite - **NEW:** Automatic destination handling and coordinate support #### 🔤 **Intuitive Portal Creation** - **NEW:** Two-step workflow (select area → create portal) - **NEW:** Smart validation and error prevention ### 🔧 **Portal Features** #### 🔄 **Persistent Storage** - **NEW:** Auto-save to YAML with restart persistence - **NEW:** Manual reload capability #### 🏗️ **Advanced Portal Management** - **NEW:** Portal types (NETHER/END/CUSTOM) and frame materials - **NEW:** Multi-world support with conflict prevention #### 🛡️ **Security & Performance** - **NEW:** Granular permissions (`lilworlds.portal.*`) - **NEW:** Cooldown system and world validation - **NEW:** Efficient event handling with minimal impact #### 🎯 **Developer API** - **NEW:** Full lifecycle methods (create/delete/teleport) - **NEW:** Information retrieval and event integration ### 📚 **Portal Documentation & Examples** #### 📖 **Complete User Guide** - **NEW:** Dedicated portals page with tutorials - **NEW:** Permission examples and troubleshooting #### 🎯 **Usage Examples** - **NEW:** WorldEdit/manual workflows + API samples - **NEW:** Configuration structure documentation ### 🔧 **Core Plugin Improvements** #### 💬 **Enhanced Command Structure** - **IMPROVED:** Tab completion and contextual feedback - **IMPROVED:** WorldEdit status indicators #### 🛡️ **Permission System** - **NEW:** Granular controls (`create|delete|teleport|admin|bypass.cooldown`) #### 📝 **User Experience** - **NEW:** Real-time feedback and formatted info displays - **NEW:** Command suggestions and error guidance ### 🔧 **Technical Implementation** #### 🏗️ **Portal Architecture** ``` src/main/java/org/hydr4/lilworlds/portals/ ├── Portal.java # Core data structure ├── PortalManager.java # Persistence layer ├── PortalListener.java # Event handlers └── PortalCommand.java # WorldEdit integration ``` #### 🔄 **Event Integration** - **NEW:** Optimized `PlayerMoveEvent`/`PlayerPortalEvent` handling - **NEW:** Custom `WorldTeleportEvent` triggering #### 📦 **WorldEdit Compatibility** - **NEW:** Dynamic detection and selection API support - **NEW:** Graceful fallback for all selection types ### 🔄 **Backward Compatibility & Version Support** - **NEW:** Added Minecraft 1.21.6 support - **MAINTAINED:** All existing functionality preserved - **MAINTAINED:** Zero breaking changes to configurations - **MAINTAINED:** Uncompromised performance standards ### 🌟 **Portal System Highlights** - **INTUITIVE:** Visual two-step creation - **PERSISTENT:** Restart-proof storage - **FLEXIBLE:** WorldEdit + manual modes - **SECURE:** Permissions + validation - **PERFORMANT:** Low-impact detection - **EXTENSIBLE:** Full API integration

### 🚀 **MAJOR NEW FEATURES** #### 🔧 **Complete Developer API System** - **NEW:** Comprehensive API for developers with full world management capabilities - **NEW:** `LilWorldsAPI` - Main API entry point with singleton pattern - **NEW:** `WorldBuilder` - Fluent builder pattern for intuitive world creation - **NEW:** `WorldManager` - Advanced world management operations with async support - **NEW:** `WorldInfo` - Comprehensive world information wrapper - **NEW:** `WorldUtils` - Utility functions for common world operations #### 📡 **Event System** - **NEW:** Custom event system for world operations (all cancellable) - **NEW:** `WorldCreateEvent` - Fired before world creation - **NEW:** `WorldCreatedEvent` - Fired after successful world creation - **NEW:** `WorldDeleteEvent` - Fired before world deletion - **NEW:** `WorldTeleportEvent` - Fired before player teleportation #### ⚡ **Teleport Command** - **NEW:** `/world teleport <world>` command (alias: `/w tp <world>`) - **NEW:** Teleports players to spawn location of specified world - **NEW:** Security validation and rate limiting - **NEW:** Permission checking (`lilworlds.world.teleport`) - **NEW:** Player-only command with appropriate error messages #### 🔤 **Short Command Aliases** - **NEW:** `/w i` (info), `/w cr` (create), `/w cl` (clone) - **NEW:** `/w ld` (load), `/w ul` (unload), `/w rm` (remove) - **NEW:** `/w imp` (import), `/w ls` (list), `/w ss` (setspawn) - **NEW:** `/w sus` (setuniversalspawn), `/w cfg` (config), `/w tp` (teleport) ### 🔧 **API Features** #### 🔄 **Async Operations** - **NEW:** All I/O operations return `CompletableFuture` - **NEW:** Non-blocking world loading, unloading, deletion, cloning - **NEW:** Async world creation with callback support - **NEW:** Thread-safe operations with proper main thread scheduling #### 🏗️ **Builder Pattern** - **NEW:** Fluent world creation: `api.createWorld("name").environment(NORMAL).build()` - **NEW:** Method chaining for intuitive API usage - **NEW:** Callback support for success/failure handling - **NEW:** Async and sync creation methods #### 🛡️ **Advanced Features** - **NEW:** World size calculation and formatting - **NEW:** World backup functionality - **NEW:** Player evacuation from worlds - **NEW:** Safe spawn location detection - **NEW:** World existence checking (loaded/unloaded) ### 📚 **Documentation & Examples** #### 📖 **Complete Documentation** - **NEW:** `API_EXAMPLE.java` - Complete example plugin - **NEW:** Maven/Gradle dependency setup instructions - **NEW:** Best practices and performance tips #### 🎯 **Developer Support** - **NEW:** JitPack integration for easy dependency management - **NEW:** Example implementations for common use cases ### 🔧 **Core Plugin Improvements** #### 💬 **Enhanced Commands** - **IMPROVED:** All commands now support short aliases - **IMPROVED:** Tab completion for all aliases - **IMPROVED:** Help system shows available aliases - **IMPROVED:** Teleport command with full validation #### 🛡️ **Security & Performance** - **IMPROVED:** Enhanced world name validation - **IMPROVED:** Rate limiting for teleport operations - **IMPROVED:** Security logging for sensitive operations - **IMPROVED:** Efficient caching of world information #### 📝 **Messages & UX** - **NEW:** Teleport-specific messages in `messages.yml` - **IMPROVED:** Command descriptions show aliases - **IMPROVED:** Clear error messages for all scenarios - **IMPROVED:** Consistent command structure ### 🔧 **Technical Implementation** #### 🏗️ **API Architecture** ``` src/main/java/org/hydr4/lilworlds/api/ ├── LilWorldsAPI.java # Main API class ├── events/ # Event system ├── utils/ # Utility classes └── world/ # World management ``` #### 🔄 **Async Pattern** - **NEW:** CompletableFuture-based async operations - **NEW:** Proper thread management with Bukkit scheduler - **NEW:** Error handling with callbacks and exceptions - **NEW:** Thread-safe operations throughout #### 📦 **Publishing Ready** - **NEW:** JitPack integration ready ### 🎯 **Usage Examples** #### Basic API Usage: ```java LilWorldsAPI api = LilWorldsAPI.getInstance(); api.createWorld("myworld") .environment(World.Environment.NORMAL) .generator("superflat") .onSuccess(world -> System.out.println("Created!")) .buildAsync(); ``` #### Event Handling: ```java @EventHandler public void onWorldCreate(WorldCreateEvent event) { if (event.getWorldName().startsWith("temp_")) { event.setCancelled(true); } } ``` ### 🔄 **Backward Compatibility** - **MAINTAINED:** All existing commands work unchanged - **MAINTAINED:** Existing configurations remain valid - **MAINTAINED:** No breaking changes to plugin behavior - **MAINTAINED:** Same security and performance standards

### 🎯 **Critical Bug Fix** - **FIXED:** `WorldBorderCenterChangeEvent may only be triggered synchronously` error - Fixed async world creation that was causing IllegalStateException - Implemented hybrid async/sync approach for optimal performance - World preparation (reflection, validation, logging) now runs asynchronously - Only the critical `creator.createWorld()` call runs synchronously (required by Bukkit API) - Maintains performance benefits while respecting Bukkit's threading requirements ### 🚀 **Performance Improvements** - **NEW:** `createWorldAdvancedAsync()` method for better async handling - **IMPROVED:** World creation now uses callback-based async pattern - **OPTIMIZED:** Minimal main thread usage - only for world border events - **MAINTAINED:** Legacy synchronous method for compatibility ### 🔧 **Technical Changes** - Added `Consumer<Boolean>` callback pattern for async world creation - Split world creation into async preparation and sync execution phases - Added proper error handling for both async and sync phases - Improved thread safety for world creation operations

### 🎯 **Major Fixes** - **FIXED:** World creation bug that caused `NoSuchFieldException` when using `/w create` command - Fixed reflection issue in `WorldManager.createWorldAdvanced()` method - Now properly accesses private fields using `getDeclaredField()` and `setAccessible(true)` - World creation with all environments (NORMAL, NETHER, THE_END) now works correctly ### 🚀 **Major Improvements** - **REMOVED:** Annoying timeout system for rate limiting - Players can now perform world operations without waiting for cooldowns - Console operations were never rate-limited and remain unchanged - Security validation for world names and other inputs is still maintained - **IMPROVED:** Confirmation system for dangerous operations - Confirmation prompts for world deletion and bulk unloading are **kept for safety** - **REMOVED:** Timeout expiration on confirmations - they no longer expire - Users can now take their time to confirm dangerous operations - Clearer confirmation messages with better formatting ### 🔧 **Technical Changes** - Updated `SecurityUtils.checkRateLimit()` to always return `true` - Updated `SecurityUtils.canPerformOperation()` to bypass rate limiting - Modified world deletion confirmation to not expire - Modified bulk world unload confirmation to not expire - Improved reflection handling in `WorldManager` for better compatibility

🎉 New Features Advanced Configuration Management /world config set <key> <value> for runtime configuration /world config disable <option> for boolean toggles Per-world configuration overrides Configuration validation and error recovery per-world inventories Plugin Integrations PlaceholderAPI integration support BStats metrics integration Hooks for other world management plugins Enhanced Generator System /worlds reload generators for hot-reloading custom generators Advanced generator parameters and options Generator validation and error handling Improved User Experience Colorful initialization messages (no ASCII art as requested) Better command aliases and shortcuts Enhanced confirmation dialogs for destructive operations 🔧 Improvements Performance Enhancements Optimized world loading/unloading processes Better memory management for large world operations Async operations where possible Code Quality Comprehensive logging for all operations Better error handling and recovery Improved modular architecture Configuration System More granular configuration options Better default values and validation Hot-reload capabilities for most settings 🐛 Bug Fixes Fixed world deletion confirmation system Resolved tab completion edge cases Improved error handling for invalid world names Fixed memory leaks in world management operations 📋 Technical Details Full Java 17+ compatibility Enhanced integration package with proper abstractions Comprehensive command system with inheritance Robust configuration management system Complete logging and monitoring capabilities

🎉 New Features Advanced World Operations World cloning with /world clone <source> <target> World importing from external sources Bulk world loading/unloading operations Custom Generator Support Built-in custom generator system Generator configuration files in /generators folder Support for custom world generation parameters Spawn Management /world setspawn for individual worlds /world setuniversalspawn for global spawn Spawn point persistence and management Enhanced Commands /world info for detailed world information /worlds reload with granular reload options Improved error messages and user feedback 🔧 Improvements Better tab completion with context-aware suggestions Enhanced configuration validation Improved logging with more detailed output Performance optimizations for world operations 📋 Technical Details Enhanced BaseCommand inheritance system Improved integration package structure Better memory management for world operations

🎉 New Features Core World Management System Basic world creation with /world create <name> World loading and unloading functionality World deletion with confirmation system Command Framework Base command system with /world and /w aliases Tab completion for all commands Permission-based access control Configuration System Configurable config.yml with world settings Default world generation options Logging configuration Utility Systems ColorUtils for ANSI console colors and Minecraft chat colors LoggerUtils for organized logging with colorful output Error handling framework 📋 Technical Details Minecraft Version Support: 1.16-1.21.5 Package Structure: org.hydr4.lilworlds Dependencies: None (standalone) Initial modular architecture