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 polished, immersive GUI.

Now updated for v11.0 with Scheduled Maintenance and Audio Feedback!

⚠️ 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 with sound effects and immersive visuals.
• Scheduled Maintenance (New!) Don't just kick players instantly. Schedule your optimization with a built-in Countdown Timer (Immediate, 1m, 3m, or 5m). The server will broadcast warnings and play ticking sounds to alert players.
• Smart Filtering & Risk Analysis Utilizes Minecraft's native InhabitedTime to distinguish between active bases and flyover terrain. Items in the GUI now display Risk Levels and Potential Savings to help you decide.
• Dynamic Tool Updater The plugin automatically connects to the GitHub API to fetch the absolute latest version of the MCASelector binary, ensuring you always have the most compatible tools.
• Massive Space Savings Drastically reduces world folder size (often by 40-70%).
• Safety Lock Includes aggressive chunk unloading to prevent file locks, a mandatory chat confirmation, and a countdown system to prevent data corruption.

✅ Compatibility

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

📖 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.
• 3 Minutes (3600 Ticks) — Moderate (New!) Bridges the gap between casual travel and short stops.
• 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

1. Permission: Ensure you are OP or have the trimmer.admin permission.
2. Open Menu: Type /trimworld.
3. Select Worlds: Click the icons of the worlds you wish to optimize. They will glow when selected.
4. Choose Filter: Click the Clock icon to select a time threshold. Check the lore for "Risk Level".
5. Update Tool (Optional): Click the Anvil to force a check for the latest binary.
6. Next Step: Click the Emerald Block ("Proceed").
7. Confirm: Type CONFIRM in the chat when prompted.
8. Schedule: A new menu will appear. Select Immediate, 1m, 3m, or 5m to start the live countdown.

📜 Commands & Permissions

⚙️ Configuration

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

trimmer-heap: "4G"
metrics: true

messages:
  prefix: "§8[§bTrimmer§8] §7"
  download-start: "§eDownloading optimization tool..."
  download-success: "§aTool ready."
  # New in v11.0
  warn-broadcast: "§c§lWARNING: §7World optimization starts in §e%time%§7."
  countdown: "§cTrimming in %seconds% seconds..."