Simplex Trimmer Paper MC

Effortless World Optimization for Modern Servers

Simplex Trimmer is the ultimate administrative utility designed to reclaim disk space by intelligently removing unused chunks. Powered by the industry-standard MCASelector technology, it allows you to trim gigabytes of data from your world files directly in-game via a user-friendly GUI.

⚠️ CRITICAL WARNING: READ BEFORE USE

🛑 BACKUPS ARE MANDATORY

This plugin permanently deletes chunk data. Once a chunk is trimmed, it is gone forever and will be regenerated to its original seed state if visited again.

ALWAYS create a full backup of your world folders before running this tool.

DO NOT stop the server once the process has started.

The server will restart automatically upon completion.

⚡ Key Features

GUI-Based Management No complex command-line arguments needed. Control the entire process via a clean, intuitive inventory interface.
Smart Filtering Utilizes Minecraft's native InhabitedTime to intelligently distinguish between active player bases and temporary flyover terrain.
Massive Space Savings Drastically reduces world folder size (often by 40-70%).
Visual Reports Receive a detailed chat report immediately after the restart, showing exactly how many megabytes (MB) were reclaimed.
Safety Lock Includes a mandatory chat confirmation and kicks players during the operation to prevent data corruption.
Expert Mode Allows power users to define custom tick thresholds for precision trimming.

✅ Compatibility

Simplex Trimmer is built for modern Minecraft server software (1.21+).

Platform	Status	Notes
Paper	✅ Recommended	Best performance and stability.
Purpur	✅ Supported	Fully compatible.
Pufferfish	✅ Supported	Fully compatible.
Spigot	⚠️ Not Recommended	May lack required libraries.
Folia	❌ Incompatible	Threading architecture is not supported.
Proxy	❌ Incompatible	Velocity/BungeeCord do not hold world data.

📖 How It Works

Minecraft tracks how long players spend in a chunk using a value called InhabitedTime (measured in ticks). Simplex Trimmer scans your region files and deletes chunks where the InhabitedTime is lower than your selected threshold.

Recommended Thresholds

30 Seconds (600 Ticks) — Safe Removes chunks generated by Elytra flyovers. Keeps almost everything else.
1 Minute (1200 Ticks) — Balanced Good for removing paths traveled briefly.
5 Minutes (6000 Ticks) — Aggressive Removes areas where players haven't stopped to build or mine.
10 Minutes (12000 Ticks) — Very Aggressive Only keeps established bases.

🛠️ Usage Guide

Permission: Ensure you are OP or have the trimmer.admin permission.
Open Menu: Type /trimworld.
Select Worlds: Click the icons of the worlds you wish to optimize. They will glow when selected.
Choose Filter: Click the Clock icon to select a time threshold (default is 30s).
Execute: Click the Emerald Block ("Start Optimization").
Confirm: Type CONFIRM in the chat when prompted.
Wait: The server will enter maintenance mode, kick all players, perform the trim, and auto-restart.

📜 Commands & Permissions

Command	Permission	Description
`/trimworld`	`trimmer.admin`	Opens the main trimmer GUI.

⚙️ Configuration

The plugin works out of the box, but you can configure messages and memory usage in config.yml.

<details> <summary>Click to view default config.yml</summary>

trimmer-heap: "4G"
metrics: true

messages:
  prefix: "§8[§bTrimmer§8] §7"
  download-start: "§eDownloading optimization tool..."
  download-success: "§aTool ready."
  backup-warning: "§e§lBACKUP RECOMMENDATION\n§7It is highly recommended to create a backup first."

</details>

⚖️ Privacy & External Tools

1. MCASelector (Core) To perform the heavy lifting of editing region files safely, this plugin automatically downloads and utilizes the open-source MCASelector tool (JAR) by Querz.

Behavior: The tool is downloaded to plugins/SimplexTrimmer/ on the first run.
Privacy: It runs locally as a subprocess. No world data is uploaded to any cloud server.

2. bStats This plugin collects anonymous usage data to help us improve development.

Data: Server version, Java version, and player count.
Opt-out: You can disable this in plugins/SimplexTrimmer/config.yml.