# ChunkDeleter<\/p>\n
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.<\/p>\n
## Features<\/p>\n
### \ud83d\ude80 Advanced Scheduling
\n– **Folia Support**: Fully compatible with Folia’s threaded region scheduler
\n– **Paper\/Spigot Support**: Falls back to standard scheduler for Paper\/Spigot servers
\n– **Thread-Safe**: All operations use appropriate schedulers for thread safety
\n– **PerfoBooster Integration**: Automatic detection and optimization with PerfoBooster plugin<\/p>\n
### \ud83d\udee1\ufe0f Smart Protection System
\n– **Spawn Protection**: Protects chunks around world spawn points
\n– **Player Protection**: Protects chunks near online players
\n– **Structure Protection**: Protects chunks containing important structures (portals, beacons, etc.)
\n– **Tile Entity Protection**: Protects chunks with storage blocks, furnaces, and other important blocks
\n– **Build Detection**: Recognizes player-built structures and protects them<\/p>\n
### \u2699\ufe0f Flexible Configuration
\n– **CamelCase Configuration**: Modern, clean configuration format
\n– **Configurable Time Limits**: Set how long chunks must be unused before deletion
\n– **Grace Period**: Two-phase deletion with marking and grace period
\n– **World-Specific Settings**: Enable\/disable for specific worlds
\n– **Performance Tuning**: Adjustable batch sizes and processing limits<\/p>\n
### \ud83d\udcca Basic Tracking & Logging
\n– **SQLite Database**: Efficient chunk access tracking
\n– **File Logging**: Detailed chunk deletion logs saved to `logs\/latest.txt`
\n– **Coordinate Logging**: Precise chunk and block coordinate tracking
\n– **Statistics**: Detailed statistics on scanned, deleted, and protected chunks
\n– **Real-time Monitoring**: Track chunk access in real-time<\/p>\n
### \ud83c\udf9b\ufe0f Easy Management
\n– **In-Game Commands**: Full command interface for management
\n– **Log Management**: View, tail, and clear log files in-game
\n– **Permission System**: Granular permission control
\n– **Hot Reload**: Reload configuration without restart
\n– **Manual Cleanup**: Trigger cleanup cycles manually
\n– **Auto-Optimization**: One-click PerfoBooster installation<\/p>\n
## Installation<\/p>\n
1. Download the ChunkDeleter JAR file
\n2. Place it in your server’s `plugins` folder
\n3. Restart your server
\n4. Configure the plugin in `plugins\/ChunkDeleter\/config.yml`
\n5. (Optional) Use `\/chunkdeleter optimize` to install PerfoBooster for enhanced performance<\/p>\n
## Commands<\/p>\n
### Core Commands
\n– `\/chunkdeleter help` – Show help information
\n– `\/chunkdeleter reload` – Reload plugin configuration
\n– `\/chunkdeleter stats` – Show chunk statistics
\n– `\/chunkdeleter clean` – Manually trigger cleanup
\n– `\/chunkdeleter toggle` – Enable\/disable chunk deletion
\n– `\/chunkdeleter info` – Show plugin information<\/p>\n
### Advanced Commands
\n– `\/chunkdeleter optimize` – Download and install PerfoBooster plugin
\n– `\/chunkdeleter logs` – View log file information
\n– `\/chunkdeleter logs tail [lines]` – Show recent log entries (1-50 lines)
\n– `\/chunkdeleter logs clear` – Clear the log file
\n– `\/chunkdeleter debug` – Toggle debug mode (admin only)<\/p>\n
**Aliases**: `\/cd`, `\/chunkdel`<\/p>\n
## Permissions<\/p>\n
– `chunkdeleter.*` – Access to all features (default: op)
\n– `chunkdeleter.admin` – Full administrative access
\n– `chunkdeleter.reload` – Permission to reload config
\n– `chunkdeleter.stats` – View statistics
\n– `chunkdeleter.clean` – Trigger manual cleanup
\n– `chunkdeleter.toggle` – Enable\/disable plugin
\n– `chunkdeleter.optimize` – Download PerfoBooster plugin
\n– `chunkdeleter.logs` – View and manage log files<\/p>\n
## Configuration<\/p>\n
The plugin uses a modern camelCase configuration format. The config file includes:<\/p>\n
“`yaml
\n# Enable\/disable the plugin
\nenabled: true<\/p>\n
# Chunk deletion settings
\nchunkDeletion:
\n timeBeforeDeletion: 30 # Minutes before chunk is eligible for deletion
\n maxChunksPerCycle: 50 # Maximum chunks to process per cycle
\n cleanupInterval: 300 # Cleanup interval in seconds
\n immediateDeletion: false # Enable immediate deletion or use grace period
\n gracePeriod: 5 # Grace period in minutes for marked chunks<\/p>\n
# World settings
\nworlds:
\n enabledWorlds: [] # Specific worlds to enable (empty = all worlds)
\n disabledWorlds: # Worlds to exclude
\n – “world_nether”
\n – “world_the_end”
\n spawnProtectionRadius: 10 # Chunk radius around spawn to protect<\/p>\n
# Protection settings
\nprotection:
\n protectPlayerChunks: true # Protect chunks near players
\n playerProtectionRadius: 3 # Player protection radius in chunks
\n protectStructures: true # Protect chunks with structures
\n protectTileEntities: true # Protect chunks with storage\/functional blocks
\n minTileEntities: 1 # Minimum tile entities to protect chunk<\/p>\n
# Performance settings
\nperformance:
\n asyncScanning: true # Use async processing
\n maxProcessingTimePerTick: 10 # Max processing time per tick (ms)
\n batchSize: 25 # Batch size for operations<\/p>\n
# Logging settings
\nlogging:
\n logDeletions: true # Log chunk deletions to console
\n logStatistics: true # Log statistics periodically
\n statisticsInterval: 60 # Statistics interval in minutes
\n debug: false # Enable debug logging<\/p>\n
# Database settings
\ndatabase:
\n type: SQLITE # Database type (SQLITE, MYSQL, or MEMORY)
\n sqliteFile: “chunkdata.db” # SQLite file name
\n mysql: # MySQL settings (if using MYSQL)
\n host: “localhost”
\n port: 3306
\n database: “chunkdeleter”
\n username: “username”
\n password: “password”
\n“`<\/p>\n
## Logging System<\/p>\n
ChunkDeleter includes a basic logging system that tracks all chunk deletions:<\/p>\n
### Log File Location
\n– **Path**: `logs\/latest.txt` (in your server root directory)
\n– **Format**: Timestamped entries with detailed coordinate information
\n– **Thread-Safe**: Safe for concurrent access and high-performance servers<\/p>\n
### Log Entry Format
\n“`
\n[2024-01-15 14:30:25] CHUNK_DELETED: World=world, ChunkCoords=[15,11], BlockRange=[240,176] to [255,191], Info=Automatic cleanup
\n[2024-01-15 14:31:02] Manual cleanup triggered by admin
\n[2024-01-15 14:35:10] Cleanup cycle: Processed 45, Deleted 12, Protected 33 chunks
\n“`<\/p>\n
### Log Management Commands
\n– `\/chunkdeleter logs` – View log file information and statistics
\n– `\/chunkdeleter logs tail 20` – Show the last 20 log entries
\n– `\/chunkdeleter logs clear` – Clear the log file (admin only)<\/p>\n
## PerfoBooster Integration<\/p>\n
ChunkDeleter automatically detects and integrates with PerfoBooster for optimal performance:<\/p>\n
### Automatic Detection
\n– **Version Compatibility**: Checks for Minecraft 1.20.1 with RegionScheduler support
\n– **Server Compatibility**: Validates Paper\/Folia\/Purpur server software
\n– **Installation Warnings**: Shows warnings if PerfoBooster is recommended but not installed<\/p>\n
### Easy Installation
\n– **One-Click Install**: Use `\/chunkdeleter optimize` to automatically download and install PerfoBooster
\n– **Version Management**: Always downloads the latest compatible version
\n– **Safety Checks**: Prevents installation on incompatible servers<\/p>\n
### Performance Benefits
\nWhen PerfoBooster is installed on compatible servers:
\n– Reduced server lag during chunk operations
\n– Optimized redstone and entity processing
\n– Enhanced performance for large-scale chunk cleanup operations<\/p>\n
## How It Works<\/p>\n
1. **Chunk Tracking**: The plugin tracks when players enter chunks using move and teleport events
\n2. **Database Storage**: Access times are stored in a SQLite database for persistence
\n3. **Regular Cleanup**: Configurable cleanup cycles check for old chunks
\n4. **Protection Checks**: Multiple protection systems prevent important chunks from deletion
\n5. **Safe Deletion**: Chunks are safely unloaded and removed from tracking
\n6. **Basic Logging**: All operations are logged with detailed coordinates and timestamps<\/p>\n
## Performance Considerations<\/p>\n
– **Async Processing**: Most operations run asynchronously to avoid server lag
\n– **Batch Processing**: Chunks are processed in configurable batches
\n– **Efficient Database**: SQLite with optimized queries and indexing
\n– **Smart Caching**: Frequently accessed chunks are cached in memory
\n– **Folia Optimization**: Uses region schedulers for optimal Folia performance
\n– **PerfoBooster Integration**: Enhanced performance with PerfoBooster plugin<\/p>\n
## Compatibility<\/p>\n
– **Minecraft**: 1.20 (PerfoBooster requires 1.20.1)
\n– **Server Software**: Paper, Folia, Purpur, Spigot
\n– **Java**: 17
\n– **Optional Dependencies**: PerfoBooster (auto-installable)<\/p>\n
## Support<\/p>\n
For support, join discord: https:\/\/discord.gg\/yUghaxRSZs<\/p>\n","protected":false},"excerpt":{"rendered":"
Advanced chunk cleaner plugin that deletes unused chunks for Paper\/Folia servers<\/p>\n","protected":false},"featured_media":40120,"template":"","meta":{"_minecraft_slug":"chunkdeleter","_minecraft_project_id":"hoxwWPn6","_minecraft_author":"BloodRed","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":878,"_minecraft_follows":9,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"chunkdeleter.zip","_minecraft_size_bytes":134609,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-16T09:06:05.762394Z","_minecraft_date_created":"2025-07-14T22:49:43.623243Z","_minecraft_date_modified":"2025-07-15T02:19:33.174071Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/chunkdeleter","_minecraft_icon_attachment_id":40120,"_minecraft_imported_at":"2026-06-01T21:25:25+00:00","_minecraft_import_hash":"f4fd85cf5e39b18fb38a0471d892f596","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,89,126,90,127,128,129,91,123,159],"mod_loader":[130,131,132,133,134],"minecraft_version":[59,36,60,93,94,101,102,62,37,73,74,38,78,79,80],"class_list":["post-40119","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-game-mechanics","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-storage","mod_category-technology","mod_category-worldgen","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7"],"yoast_head":"\n