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:

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