Minecraft World Trimmer
github.com
- Free plan
- Windows
- macOS
- Linux
What Minecraft World Trimmer is
Minecraft World Trimmer is a free tool for reclaiming storage by removing low-usage regions from Minecraft Java worlds. It identifies regions with little player activity and deletes them; the default threshold is 10 minutes, or 600 seconds, of player time per region. Users can set a different threshold in seconds with `-t`, and change the CPU core count with `-c`; by default, the program uses all available cores. It displays a live progress counter and offers `-q`, `-u` and `-v` output options. Running it without command-line arguments opens an interactive terminal interface for trimming worlds. That mode can discover dimensions and world folders or use a Minecraft saves folder, and supports 2011–2025 and 2026 world formats. The program handles `.mca` region files and batch operations on Linux, macOS and Windows. Windows users can download an executable ZIP from the GitHub release tab. On other systems, installation requires Python and source dependencies, including cursesplus and anvil-parser2. The README warns against running it on a new world because chunks containing player data could be destroyed.
Who it suits
It may suit Minecraft Java players who want to remove inactive regions from existing worlds and are comfortable using a command-line tool or terminal interface. macOS and Linux users need to install Python and the source dependencies.
Good to know, and what to watch
- Free under the MIT License
- Threshold and CPU core count are configurable
- Includes an interactive terminal interface
- Supports batch operations on Linux, macOS and Windows
- No binary is available for non-Windows systems
- macOS and Linux require Python and source dependencies
- Running it on a new world may destroy player data
Plans
Every plan and priceMIT License
Free plan
Getting started
- Open the project page at https://github.com/Enderbyte-Programs/minecraft-world-trimmer
- Windows users download the executable ZIP from the GitHub release tab
- macOS or Linux users install Python and the required source dependencies
- Start without arguments to open the interactive terminal interface
- Select a world or saves folder, or run with options such as -t and -c
- Review progress output while the batch trim runs
The Club's review
Minecraft World Trimmer is a free utility for removing little-used regions from Minecraft Java worlds. It is best suited to players who want focused storage cleanup and are comfortable with terminal tools. Its controls are useful, but deletion can remove chunks containing player data, so cautious use is essential.
Overview
The program targets regions with low player-time usage and deletes them to reduce world storage. It is a region cleanup tool, not a broad editor: it works with .mca region files, but does not edit terrain or entities. That narrow scope is an advantage for players who only need to prune a world, and a poor fit for anyone looking to reshape or inspect its contents.
The default cutoff is 10 minutes (600 seconds) of player time per region. Users can adjust it with -t, which gives control over what qualifies for removal. The maker warns not to run the tool on a new world, since it may destroy chunks containing player data. This is not a routine optimization to run casually; the deletion risk calls for deliberate choices about the world being trimmed.
Key features
Threshold and processing controls
The adjustable threshold lets users tune the cleanup, while -c sets a custom core count; by default, the program uses all available CPU cores. A live progress counter and -q, -u, and -v output options help tailor what appears during a run. These controls serve users who want to manage processing and output, but they do not change the destructive nature of the operation.
Interactive terminal mode
Starting the program without command-line arguments opens an interactive terminal interface. It supports 2011–2025 and 2026 world formats and can discover dimensions, world folders, or a Minecraft saves folder. This provides a guided route for users who would rather not supply command-line arguments, though it remains a terminal tool rather than a graphical desktop editor.
Pricing
Minecraft World Trimmer is free under the MIT License: free, provided as-is with no warranty. The license permits use, copying, modification, distribution, sublicensing, and sale. There are no paid tiers or stated seat limits to weigh; users do accept the no-warranty terms.
Platforms
The software supports Windows, macOS, and Linux, but installation differs sharply. Windows users can download a ZIP containing an executable from the GitHub release tab. There is no binary for macOS or Linux, so users on those systems must install Python and source dependencies, including cursesplus and anvil-parser2. Windows interactive mode additionally requires windows-curses. That extra setup makes the non-Windows route less convenient, particularly for users unfamiliar with Python environments.
Who it's for
This is a fit for Minecraft Java players who want to reclaim storage by trimming low-usage regions and are comfortable with a terminal workflow. It also suits users who value adjustable thresholds and CPU controls. It is not the right choice for players seeking terrain or entity editing, or for anyone unwilling to accept the possibility of losing chunks with player data.
Pros and cons
Pros
- Targeted cleanup: It deletes low-usage regions rather than presenting itself as a general terrain or entity editor.
- Configurable operation: Threshold, core count, and output controls let users adjust how trimming runs.
- Interactive option: The terminal UI can discover world folders and dimensions, reducing reliance on command-line arguments.
- Free and permissively licensed: The MIT License allows modification and redistribution as well as use.
Cons
- Destructive risk: The maker warns that new worlds may contain player data in chunks the tool deletes.
- No non-Windows binary: macOS and Linux users must install Python and dependencies themselves.
- Narrow editing scope: It does not edit terrain or entities, limiting its usefulness beyond region cleanup.
- No warranty: The free plan is provided as-is.
Alternatives
Minecraft World Editors is a useful place to compare broader editing options. For another free, cross-platform choice, biomed is available under an MIT license. MCA Selector is also free and offers downloadable Windows, macOS, Linux, and universal JAR builds. Choose WorldPainter if a free, open-source tool under GPL version 3 better fits your licensing preference.
MCBE Inventory Editor, Chunker, Dovetail, LiveNBTEditor, and MCA JSON are additional alternatives.
Verdict
Minecraft World Trimmer is a practical free choice for Java players who want configurable, focused cleanup of low-usage regions. Its interactive mode and command-line controls provide flexibility, but the warning about losing player data should weigh heavily. Choose it if careful region deletion is the goal; look elsewhere for terrain or entity editing, or a non-Windows installation without Python setup.
The verdict
Minecraft World Trimmer offers configurable cleanup for Java world regions, with both command-line controls and an interactive mode. Treat the warning about new worlds seriously, and account for the extra setup required outside Windows.
Questions people ask
How much does Minecraft World Trimmer cost?
It is free under the MIT License and provided as-is with no warranty.
Which platforms and worlds does it support?
It supports Windows, macOS, and Linux for Minecraft Java worlds using .mca region files.
What does the default trim rule do?
The default deletion threshold is 10 minutes, or 600 seconds, of player time per region. The -t option changes the threshold.
Is there an interactive mode?
Yes. Running without command-line arguments starts a terminal interface that can discover dimensions, world folders, or a Minecraft saves folder.
How is it installed outside Windows?
There is no non-Windows binary, so macOS and Linux users install Python and source dependencies such as cursesplus and anvil-parser2.
Is trimming safe for a new world?
The README warns against running it on a new world because chunks containing player data may be destroyed.
What the maker publishes
- Default threshold
- The default deletion threshold is 10 minutes, or 600 seconds, of player time per region. source
- Dependencies
- The required libraries include cursesplus and anvil-parser2, with windows-curses additionally required for Windows interactive mode. source
- Interactive mode
- Running without command-line arguments starts an interactive terminal UI for trimming worlds. source
- License
- The software is released under the MIT License with permission to use, copy, modify, publish, distribute, sublicense, and sell it. source
- Multiprocessing
- The program uses all available CPU cores by default and supports a custom core count with -c. source
- Non-Windows installation
- There is no binary for non-Windows operating systems, so users must install Python and the source dependencies. source
- Progress controls
- It provides a live progress counter and supports -q, -u, and -v output options. source
- Purpose
- Minecraft World Trimmer clears unused chunks from Minecraft worlds to save storage space. source
- Release features
- Version 1.1 added interactive mode and a Windows EXE. source
- Safety limitation
- The README warns never to run the trimmer on a new world because it may destroy chunks containing player data. source
- Support contact
- The maker's GitHub profile lists [email protected] as a contact address. source
- Threshold control
- Users can change the threshold with the -t option in seconds. source
- Trimming method
- It finds low-usage regions and deletes them. source
- Windows download
- Windows users can download a ZIP containing a Minecraft World Trimmer executable from the GitHub release tab. source
- World formats
- Interactive mode supports 2011–2025 and 2026 world formats and can discover dimensions, world folders, or a Minecraft saves folder. source
Checked against the maker's pages on 1 Oct 2026.