Simplex Trimmer

Simplex Trimmer

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 everything via a clean inventory interface.

Smart Filtering: Uses Minecraft's native InhabitedTime to distinguish between active player bases and temporary flyover terrain.

Massive Space Savings: Drastically reduces world folder size (often by 40-70%).

Visual Reports: Get a detailed chat report showing exactly how many MB were saved after the restart.

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.

Paper: ✅ Highly Recommended (1.21+)

Purpur: ✅ Fully Supported

Pufferfish: ✅ Fully Supported

Spigot: ⚠️ Not recommended (Missing libraries)

Folia: ❌ Not Compatible (Threading issues)

Velocity/Bungee: ❌ Not Compatible (Proxies have no worlds)

📖 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

/trimworld — Permission: trimmer.admin Opens the main trimmer GUI.

⚙️ Configuration

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

Click to view default config.yml

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."

⚖️ 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/bStats/config.yml.