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:

- End (`world_the_end`): Higher limits for spawn areas and main world - End (`world_the_end`): 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:

- auto-unload timeout: Lower for slower servers (25-50), higher for powerful servers (100-200) - auto-unload timeout: Larger values for more powerful servers, conservatively lower for shared hosting - auto-unload timeout: 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