Simplex Trimmer v11.0-ULTIMATE

The "Quality of Life" Update

Simplex Trimmer v11.0 represents a massive leap forward in usability, safety, and automation. We have completely overhauled the execution flow, added dynamic tooling, and polished the user interface with sound and better visuals.

⚠️ CRITICAL UPGRADE NOTES

🛑 CONFIGURATION RESET RECOMMENDED

This update introduces new mechanics for the countdown timer and tool fetching.

• Backup your config.yml before updating.
• The plugin will now attempt to auto-fetch the mcaselector tool from GitHub. Ensure your server has outbound internet access.

⚡ New Features

• Scheduled Optimizations Gone are the days of instant kick-screens. You can now schedule the trimming process!
  • New "Start When?" Menu: Choose to start Immediately, or set a countdown for 1, 3, or 5 minutes.
  • Live Countdown: The server broadcasts warning messages and plays ticking sounds to alert players.
• Dynamic Tool Updater
  • Auto-Fetch: The plugin no longer relies on hardcoded versions. It connects to the GitHub API to detect and download the absolute latest release tag.
  • Update Button: Added a dedicated Update Tool (Anvil icon) button to manually force a check for the latest binary.
• Audio Feedback
  • Interactive GUI: Menus now feature sound effects for opening (PLING), clicking (UI_BUTTON_CLICK), and selecting options (EXPERIENCE_ORB).
  • Atmosphere: Distinct sounds for successful configuration steps and countdown ticks.
• Enhanced Filtering Options
  • New Threshold: Added a 3 Minute (3600 Ticks) option to bridge the gap between 1m and 5m.
  • Risk Analysis: Threshold items now display detailed Risk Level and Potential Savings indicators in their lore.

🛠️ Technical Improvements

📖 Usage Guide (v11.0)

• Open Menu Type /trimworld.
• Select Worlds Click the icons (Glows when selected).
• Choose Filter Select a time threshold (Now includes 3 Minutes).
• Update Tool (Optional) Click the Anvil to force a tool update.
• Next Step Click the Emerald Block and type CONFIRM in chat.
• Start Timer A new menu appears. Select Immediate, 1m, 3m, or 5m to begin the countdown.

⚙️ Configuration Changes

New message keys have been added to support the countdown feature.

messages:
  warn-broadcast: "§c§lWARNING: §7World optimization starts in §e%time%§7."
  countdown: "§cTrimming in %seconds% seconds..."

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.

⚖️ 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.