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+).

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

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.

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."
  # New in v11.0
  warn-broadcast: "§c§lWARNING: §7World optimization starts in §e%time%§7."
  countdown: "§cTrimming in %seconds% seconds..."