Home›Java›Mods›ChunkDeleter
ChunkDeleter
ModsJava

ChunkDeleter

by BloodRed · on Modrinth

Advanced chunk cleaner plugin that deletes unused chunks for Paper/Folia servers. Free Minecraft Java mod for 1.20.1, 1.20.2, 1.20.3.

Which build do you need?

This mod ships a separate file for every mod loader and every version of the game. Pick both, then download — the wrong build installs fine and then does nothing in the game.

Mod loader

Minecraft version

⬇ Download for 1.21–1.21.7 · Bukkit⬇ Download for 1.21–1.21.7 · Folia⬇ Download for 1.21–1.21.7 · Paper⬇ Download for 1.21–1.21.7 · Purpur⬇ Download for 1.21–1.21.7 · Spigot
I don't know my version or loader
Open the Minecraft launcher and look at the profile you play on — it names both, like fabric-loader-1.21.4. The version also shows in the bottom-right corner of the game's main menu.
No loader in the profile name? Then it's plain Minecraft, and these mods won't run — you need Fabric or NeoForge installed first.
Open in MC Java ModsGet it on Google Play →

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

🛡️ Smart Protection System

⚙️ Flexible Configuration

📊 Basic Tracking & Logging

🎛️ Easy Management

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

Advanced Commands

Aliases: /cd, /chunkdel

Permissions

Configuration

The plugin uses a modern camelCase configuration format. The config file includes:

# 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            # Log chunk deletions to console
  logStatistics: true           # Log statistics periodically
  statisticsInterval: 60        # Statistics interval in minutes
  debug: false                  # Enable debug logging

# Database settings
database:
  type: SQLITE                  # Database type (SQLITE, MYSQL, or MEMORY)
  sqliteFile: "chunkdata.db"   # SQLite file name
  mysql:                       # MySQL settings (if using MYSQL)
    host: "localhost"
    port: 3306
    database: "chunkdeleter"
    username: "username"
    password: "password"

Logging System

ChunkDeleter includes a basic logging system that tracks all chunk deletions:

Log File Location

Log Entry Format

[2024-01-15 14:30:25] CHUNK_DELETED: World=world, ChunkCoords=[15,11], BlockRange=[240,176] to [255,191], Info=Automatic cleanup
[2024-01-15 14:31:02] Manual cleanup triggered by admin
[2024-01-15 14:35:10] Cleanup cycle: Processed 45, Deleted 12, Protected 33 chunks

Log Management Commands

PerfoBooster Integration

ChunkDeleter automatically detects and integrates with PerfoBooster for optimal performance:

Automatic Detection

Easy Installation

Performance Benefits

When PerfoBooster is installed on compatible servers:

How It Works

  1. Chunk Tracking: The plugin tracks when players enter chunks using move and teleport events
  2. Database Storage: Access times are stored in a SQLite database for persistence
  3. Regular Cleanup: Configurable cleanup cycles check for old chunks
  4. Protection Checks: Multiple protection systems prevent important chunks from deletion
  5. Safe Deletion: Chunks are safely unloaded and removed from tracking
  6. Basic Logging: All operations are logged with detailed coordinates and timestamps

Performance Considerations

Compatibility

Support

For support, join discord: https://discord.gg/yUghaxRSZs

Verified by MCModsHub

These come from our own check of the pack file, not from the source page.

Explore more

All Mods for JavaAll Minecraft Java modsJava mods for 1.20Java mods for 1.21