Sueta

Simplex Trimmer

12.1.2

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

·Plugin
DescriptionUpdates3Version history3AddonsDiscussionReviews
  1. 12.1.2latestSimplex Trimmer 12.1.2Sep 25, 2026

    SimplexTrimmer 12.1.2

    Major v11 rewrite, safer startup trimming, live MCA Selector progress & cleaner shutdown handling
    SimplexTrimmer 12.1.2 is the current standalone release and a major redesign compared with the supplied 11.0-ULTIMATE build.
    Important: This is a destructive world-maintenance tool. Make a complete, usable backup before every trim. The plugin does not create or verify backups for you.
    ---

    🚀 Major changes from 11.0-ULTIMATE

    - Replaced the old live-server trimming workflow with startup-only trimming. - The legacy build kicked players, disabled world autosave, saved/unloaded chunks, ran MCA Selector, and then attempted a restart. - Version 12 stores a one-shot maintenance job, shuts the server down normally, and performs destructive world edits during the next full startup before normal world loading continues. - Added persistent v12 operational storage under plugins/SimplexTrimmer/data-v12/. - Added persistent job state, archived jobs, per-target raw MCA Selector logs, administrator sessions and up to the configured number of history entries. - Added recovery mode for failed or interrupted jobs instead of silently continuing as if everything completed successfully. - Added world/session locking and an external ProcessGuard supervisor to reduce the risk of another process touching the same world while MCA Selector is running. - Added legacy, split-Bukkit and modern namespaced dimension discovery. - Added individual dimension targeting instead of treating every discovered region folder as one generic world operation. - Added explicit terrain, POI and entity paths for MCA Selector. - Added path validation and rejection of unsafe symbolic-link targets during automatic discovery. - Added configurable extra world roots through world-trimmer.additional-world-roots. - Added disk-space preflight checks, MCA Selector runtime/version checks and subprocess timeouts. - Added a configurable MCA Selector heap and process-thread limit. - Reworked the MCA Selector updater: - Uses the official Querz/mcaselector GitHub release. - Verifies the GitHub-published SHA-256 digest before installing the tool. - Installs the download atomically instead of directly replacing the active tool while it is still being downloaded. - Removed the old built-in bStats telemetry path. SimplexTrimmer 12.1.2 contains no telemetry module. ---

    🎮 Interface & administration

    - The complete SimplexTrimmer interface is now English: - Java inventory menus - Native Bedrock/Floodgate forms - Command feedback - Default maintenance messages - Console output - Bundled documentation - Added optional native Bedrock forms through Floodgate while keeping Floodgate fully optional for Java-only servers. - Added paginated dimension and history interfaces. - Added persistent per-administrator selections and settings. - Added /trimworld administration commands for scanning, updating MCA Selector, history, status, custom thresholds, cancellation, clearing selections, recovery and configuration reloads. - Existing trimmer.admin permission remains the primary administration permission and defaults to OP. - Added aliases /simplextrimmer and /strimmer. ---

    ⏱️ Thresholds, countdowns & maintenance flow

    - Preset thresholds remain available for 30 seconds, 1 minute, 3 minutes, 5 minutes and 10 minutes of InhabitedTime. - Custom thresholds can be set with: - /trimworld ticks <20-1728000> - The deletion filter remains strictly: - InhabitedTime < threshold - Chunks equal to the selected threshold are retained. - Added immediate, 1-minute, 3-minute and 5-minute maintenance starts. - Added public countdown messages, title overlays, sounds and countdown cancellation. - Backup confirmation expires and is invalidated when relevant settings change or the server restarts. ---

    🔒 12.1.1 — Paper STARTUP lock fix

    - Fixed startup trimming failing with: - Could not acquire the world lock exclusively - Paper may already own session.lock in the same JVM when a STARTUP plugin runs. This is now recognized as the expected protected state instead of being treated as an external lock failure. - Truly external world locks are still rejected. - Locks acquired by SimplexTrimmer are kept for the complete destructive phase. - ProcessGuard can continue supervising the MCA Selector child process and world-lock state if the parent process changes state. - Added a dedicated guard lock to prevent duplicate trimmer supervisors from running at the same time. - Jobs that failed in 12.1.0 from this exact preflight-only lock bug can be safely retried automatically when no target had started and no active guard remains. ---

    📊 12.1.2 — Live console progress

    - Added live MCA Selector progress reporting to the Paper/server console. - Console progress can show: - Active world/dimension - Percentage - Current/maximum region count when available - Current .mca region filename when available - MCA Selector's carriage-return progress bar is normalized into clean one-line English console messages. - Duplicate redraws are suppressed so the console does not get flooded by identical progress lines. - A heartbeat/status line is emitted after a quiet period when MCA Selector is still working without a new visible percentage update. - Full, unmodified MCA Selector output continues to be stored in the per-target log files under data-v12/logs/ for troubleshooting. - Target completion output now includes reclaimed space and elapsed time. Example console output: 
    [MCA Selector 1/3] world | 12% | 24/200 regions | r.-3.2.mca
[MCA Selector 1/3] world | 42% | 84/200 regions | r.-2.5.mca
[MCA Selector 1/3] world | 100% | 200/200 regions | r.4.3.mca
[Trim 1/3] Completed | world | Reclaimed: 6.81 GiB | Elapsed: 2m 14s
    ---

    🛑 12.1.2 — Manual-stop fallback

    - Added a shutdown/restart watchdog. - After a maintenance job is safely queued, SimplexTrimmer requests the configured normal server stop/restart. - If Bukkit has not begun normal plugin shutdown within world-trimmer.shutdown-warning-seconds (default: 30 seconds), the console prints a clear English warning: 
    SERVER STOP REQUIRED
The server could not be stopped automatically. Please stop it manually from your hosting panel or server console.
The trim job is already saved and will start automatically on the next full server startup.
    - The watchdog is daemon-only and cannot keep an otherwise successful JVM shutdown alive. - If normal Bukkit shutdown has already started, the warning is not emitted just because saving a large server takes longer. ---

    🧰 Commands

    | Command | Purpose | | :--- | :--- | | /trimworld | Open the automatic Java/Bedrock administration menu | | /trimworld java | Force the Java inventory menu | | /trimworld scan | Rescan dimensions and sizes | | /trimworld update | Download and verify the latest supported official MCA Selector release | | /trimworld ticks <20-1728000> | Set a custom InhabitedTime threshold | | /trimworld clear | Clear the current administrator's dimension selection | | /trimworld history | Open saved trim history | | /trimworld status | Show the current maintenance state; console supported | | /trimworld cancel | Cancel an active countdown before shutdown | | /trimworld recovery CONFIRM | Release recovery after manual inspection | | /trimworld reload | Reload configuration while the trimmer is idle | Permission: trimmer.admin — defaults to OP. ---

    ⚠️ Upgrade notes

    - Stop the server completely before replacing the plugin JAR. - Remove the old SimplexTrimmer JAR before installing SimplexTrimmer-12.1.2.jar. - Keep a full backup of all worlds and plugin data. - Existing v11 operational state is not migrated into data-v12/. - Bukkit preserves an existing config.yml; newly added settings therefore use current defaults unless you copy them into yo
    11 downloads
  2. 11.0-ULTIMATESimplex Trimmer 11.0-ULTIMATEJan 30, 2026

    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
    | Feature | Old Behavior (v6.0) | New Behavior (v11.0) | | :--- | :--- | :--- | | Chunk Safety | Basic save & kick. | Aggressive Unload: Forces c.unload(true) to prevent file locks. | | Tool Version | Hardcoded 2.6.1. | Dynamic: Fetches latest tag from GitHub API. | | Execution | Instant upon confirmation. | Staged: Admins verify settings, then select a countdown timer. | | Visuals | Basic text. | Polished: Added ASCII Console Banner & cleaner chat formatting. | ---
    📖 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. <details> <summary>Click to view new message keys</summary> ```yaml messages: warn-broadcast: "§c§lWARNING: §7World optimization starts in §e%time%§7." countdown: "§cTrimming in %seconds% seconds..."
    453 downloads
  3. 6.0-ULTIMATESimplex Trimmer 6.0-ULTIMATEJan 28, 2026
    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. <details> <summary>Click to view default config.yml</summary> 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." </details> ⚖️ 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.
    23 downloads

Similar projects

Plugin →

VeinMiner

Mine the whole vein on mining a single ore/block. Make the tedious mining experience to something satisfying and fun! FTB Ultimine alternative

99.3MSueta

Simple Voice Chat

A working voice chat in Minecraft!

76.8MSueta

Chunky

Pre-generates chunks, quickly and efficiently

18.4MSueta

VeinMiner Enchantment

Veinminer Addon - Adds vineminer enchantment to enchanting tables. Only tools with the enchantment can veinmine

18MSueta

JourneyMap

Real-time map used for mapping in-game or your browser as you explore.

14.7MSueta

WorldEdit

A Minecraft Map Editor... that runs in-game! With selections, schematics, copy and paste, brushes, and scripting. Use it in creative, or use it temporarily in survival.

11.6MSueta