Simplex Trimmer
PluginLicenseRef-All-Rights-Reserved

Simplex Trimmer

Effortless World Optimization. Reduce file size by removing unused chunks.

18
Downloads
0
Followers
2 months ago
Updated
📦
2
Versions

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

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