ChunkDeleter

# ChunkDeleter Advanced chunk cleaner plugin for Paper/Folia servers that automatically deletes chunks that haven't been entered by players for a specified amount of time. ## Features ### 🚀 Advanced Scheduling - **Folia Support**: Fully compatible with Folia's threaded region scheduler - **Paper/Spigot Support**: Falls back to standard scheduler for Paper/Spigot servers - **Thread-Safe**: All operations use appropriate schedulers for thread safety - **PerfoBooster Integration**: Automatic detection and optimization with PerfoBooster plugin ### 🛡️ Smart Protection System - **Spawn Protection**: Protects chunks around world spawn points - **Player Protection**: Protects chunks near online players - **Structure Protection**: Protects chunks containing important structures (portals, beacons, etc.) - **Tile Entity Protection**: Protects chunks with storage blocks, furnaces, and other important blocks - **Build Detection**: Recognizes player-built structures and protects them ### ⚙️ Flexible Configuration - **CamelCase Configuration**: Modern, clean configuration format - **Configurable Time Limits**: Set how long chunks must be unused before deletion - **Grace Period**: Two-phase deletion with marking and grace period - **World-Specific Settings**: Enable/disable for specific worlds - **Performance Tuning**: Adjustable batch sizes and processing limits ### 📊 Basic Tracking & Logging - **SQLite Database**: Efficient chunk access tracking - **File Logging**: Detailed chunk deletion logs saved to `logs/latest.txt` - **Coordinate Logging**: Precise chunk and block coordinate tracking - **Statistics**: Detailed statistics on scanned, deleted, and protected chunks - **Real-time Monitoring**: Track chunk access in real-time ### 🎛️ Easy Management - **In-Game Commands**: Full command interface for management - **Log Management**: View, tail, and clear log files in-game - **Permission System**: Granular permission control - **Hot Reload**: Reload configuration without restart - **Manual Cleanup**: Trigger cleanup cycles manually - **Auto-Optimization**: One-click PerfoBooster installation ## Installation 1. Download the ChunkDeleter JAR file 2. Place it in your server's `plugins` folder 3. Restart your server 4. Configure the plugin in `plugins/ChunkDeleter/config.yml` 5. (Optional) Use `/chunkdeleter optimize` to install PerfoBooster for enhanced performance ## Commands ### Core Commands - `/chunkdeleter help` - Show help information - `/chunkdeleter reload` - Reload plugin configuration - `/chunkdeleter stats` - Show chunk statistics - `/chunkdeleter clean` - Manually trigger cleanup - `/chunkdeleter toggle` - Enable/disable chunk deletion - `/chunkdeleter info` - Show plugin information ### Advanced Commands - `/chunkdeleter optimize` - Download and install PerfoBooster plugin - `/chunkdeleter logs` - View log file information - `/chunkdeleter logs tail ` - Show recent log entries (1-50 lines) - `/chunkdeleter logs clear` - Clear the log file - `/chunkdeleter debug` - Toggle debug mode (admin only) **Aliases**: `/cd`, `/chunkdel` ## Permissions - `chunkdeleter.*` - Access to all features (default: op) - `chunkdeleter.admin` - Full administrative access - `chunkdeleter.reload` - Permission to reload config - `chunkdeleter.stats` - View statistics - `chunkdeleter.clean` - Trigger manual cleanup - `chunkdeleter.toggle` - Enable/disable plugin - `chunkdeleter.optimize` - Download PerfoBooster plugin - `chunkdeleter.logs` - View and manage log files ## Configuration The plugin uses a modern camelCase configuration format. The config file includes: ```yaml # Enable/disable the plugin enabled: true # Chunk deletion settings chunkDeletion: timeBeforeDeletion: 30 # Minutes before chunk is eligible for deletion maxChunksPerCycle: 50 # Maximum chunks to process per cycle cleanupInterval: 300 # Cleanup interval in seconds immediateDeletion: false # Enable immediate deletion or use grace period gracePeriod: 5 # Grace period in minutes for marked chunks # World settings worlds: enabledWorlds: # Specific worlds to enable (empty = all worlds) disabledWorlds: # Worlds to exclude - "world_nether" - "world_the_end" spawnProtectionRadius: 10 # Chunk radius around spawn to protect # Protection settings protection: protectPlayerChunks: true # Protect chunks near players playerProtectionRadius: 3 # Player protection radius in chunks protectStructures: true # Protect chunks with structures protectTileEntities: true # Protect chunks with storage/functional blocks minTileEntities: 1 # Minimum tile entities to protect chunk # Performance settings performance: asyncScanning: true # Use async processing maxProcessingTimePerTick: 10 # Max processing time per tick (ms) batchSize: 25 # Batch size for operations # Logging settings logging: logDeletions: true #