LilWorlds

🚀 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