ChunkPreLoader999

## 🌟 Key Features ### 🚀 Lightning-Fast Chunk Loading - Load rectangular areas with precise coordinates - Radius-based chunk loading from a center point - Async chunk generation to prevent server lag - Configurable loading speeds to match your server's performance ### ⚙️ Advanced Configuration - World-specific settings for different performance limits - Adjustable maximum area sizes per world - Performance warnings for large area loading - Auto-unload areas after periods of inactivity ### 📊 Smart Management System - Automatic saving of loaded areas to preserve state across restarts - Detailed area information with chunk counts and coordinates - Real-time server status monitoring - Comprehensive command system for easy management ### 🛡️ Performance Optimized - Batch loading to reduce server impact - Configurable chunks-per-tick settings to prevent lag - Memory-efficient chunk management - Automatic cleanup and data persistence ## ⚙️ Configuration The plugin comes with extensive configuration options in `config.yml`: ```yaml enabled-worlds: - world - world_nether - world_the_end performance: # Maximum number of chunks to load per tick for performance chunks-per-tick: 100 # Maximum area size in chunks (length x width) max-area-size: 10000 # Show performance warnings when loading large areas show-warnings: true auto-unload: # Enable automatic unloading of areas after inactivity (in minutes) enabled: false # Time in minutes after which areas are automatically unloaded timeout: 1440 # 24 hours autosave: # Interval in seconds for auto-saving loaded areas to data.yml interval: 300 # 5 minutes world-specific: world: max-area-size: 10000 chunk-load-speed: 100 world_nether: max-area-size: 5000 chunk-load-speed: 50 world_the_end: max-area-size: 5000 chunk-load-speed: 50 ``` ## 🎮 Commands | Command | Description | Example | |--------|-------------|---------| | `/cpl start <x1,z1> <x2,z2> <name>` | Load a rectangular area defined by two corners | `/cpl start 100,200 300,400 spawn_area` | | `/cpl center <x,z>` | Set the center point for radius loading | `/cpl center 0,0` | | `/cpl radius <number>` | Load chunks in a radius from the center point (in chunk radius) | `/cpl radius 10` (loads 10 chunk radius = 160 blocks) | | `/cpl unload <name>` | Unload and remove a previously loaded area | `/cpl unload spawn_area` | | `/cpl list` | List all currently loaded areas | `/cpl list` | | `/cpl info <name>` | Show detailed information about a specific area | `/cpl info spawn_area` | | `/cpl status` | Show server status including loaded chunks and memory usage | `/cpl status` | | `/cpl reload` | Reload configuration settings | `/cpl reload` | ### Command Tips - Coordinates are chunk-based (multiples of 16), not block-based - Area names should be unique and descriptive - The radius command calculates radius in chunks (1 radius = 16 blocks) - All loaded areas are automatically saved and restored on server restart ## 🌍 World-Specific Settings Configure different performance settings for each world: - **Overworld (`world`)**: Higher limits for spawn areas and main world - **Nether (`world_nether`)**: Reduced limits to maintain performance - **End (`world_the_end`)**: Separate settings for end-specific areas Each world can have its own: - Maximum area size (in chunks) - Chunk loading speed (chunks per tick) - Auto-unload behavior ## 🔧 Performance Tuning For optimal performance, adjust these settings based on your server's specifications: - **chunks-per-tick**: Lower for slower servers (25-50), higher for powerful servers (100-200) - **max-area-size**: Larger values for more powerful servers, conservatively lower for shared hosting - **show-warnings**: Keep enabled to avoid performance issues - **auto-unload timeout**: Use to automatically free memory after periods of inactivity ## 📈 Use Cases ### Spawn Area Pre-Loading Keep the spawn area loaded to prevent lag when players join: ``` /cpl center 0,0 /cpl radius 20 ``` ### Player Base Protection Ensure player builds stay loaded: ``` /cpl start 500,500 700,700 player_base ``` ### Event Areas Pre-load areas for planned events or PvP zones: ``` /cpl start -1000,-1000 -800,-800 arena ``` ## 🔄 Auto-Unload Feature Enable automatic unloading of areas after periods of inactivity: - Prevents memory leaks from unused loaded areas - Configurable timeout periods (default: 24 hours) - Areas are automatically re-loaded when needed ## 📊 Monitoring and Management - Monitor loaded areas with `/cpl list` - Check detailed area information with `/cpl info` - View server status with `/cpl status` - Track memory usage and total loaded chunks