PotatoPeeler

Free plan LinuxWindows

What PotatoPeeler is

PotatoPeeler is a free Linux and Windows utility for removing unused chunks from Minecraft Java Edition worlds and reclaiming disk space. It selects chunks by examining their InhabitedTime values and currently works with the Anvil region format. You can process local game worlds or server worlds, either changing region files in place or writing processed files to specified output directories while leaving the originals unchanged. Force-loaded chunks, custom protected chunks, and chunks with excessive data are preserved. A --dry-run option lets you check the expected behavior without write operations. For in-place processing, the tool backs up each region file before writing and restores it if writing fails. Supplying a Minecraft server JAR lets PotatoPeeler process chunks and then launch that server in the current JVM. The README requires a matching Java Runtime Environment and directs users to download the JAR from GitHub Releases. Paper servers need care: fixed-chunk-inhabited-time set to 0 or higher can produce unsuitable values. Entity and POI removal and .mcc handling remain listed TODOs.

Who it suits

It suits Minecraft Java Edition players and server operators on Linux or Windows who need to remove unused Anvil chunks. It also fits users who want dry runs, backups, or separate output files.

What it does well

Free plan and MIT License
Works with local and server worlds
Preserves protected and force-loaded chunks
Dry-run mode avoids write operations
Backups restore files after write failures

What to know first

Only supports the Anvil format
Entity and POI removal are TODOs
.mcc file handling is a TODO
Requires a matching Java Runtime Environment

Verdict

PotatoPeeler focuses on reclaiming space from Minecraft Java worlds while offering selection safeguards, dry runs, backups, and separate output directories. Check the Paper-server warning and listed TODOs before relying on it for those data types.

Facts from PotatoPeeler's own pages

Backup behavior: Before writing to each region Anvil file in place, the tool creates a backup and says it will restore the file if writing fails. · github.com, 8 Oct 2026
Backups: For in-place operations, it creates a backup before writing each file and automatically restores the file if writing fails. · github.com, 8 Oct 2026
Chunk selection: It identifies chunks for removal by examining their InhabitedTime values. · github.com, 8 Oct 2026
Compatibility limitation: The README warns that Paper-based servers may produce unsuitable InhabitedTime values if fixed-chunk-inhabited-time is set to 0 or higher. · github.com, 8 Oct 2026
Data limitations: The README says corresponding entities and POI data removal and handling of .mcc files are TODO items. · github.com, 8 Oct 2026
Download: The installation instructions direct users to download a PotatoPeeler JAR from the repository's Releases page. · github.com, 8 Oct 2026
Dry run: The --dry-run option checks expected behavior without performing write operations. · github.com, 8 Oct 2026
File format: The tool currently supports the Anvil file format. · github.com, 8 Oct 2026
Important limit: For Paper-based servers, the README advises against setting fixed-chunk-inhabited-time to zero or higher because it affects the tool's operation. · github.com, 8 Oct 2026
Known gaps: The README lists removing corresponding entities and POI data and handling .mcc files as TODOs. · github.com, 8 Oct 2026
License: The project is licensed under the MIT License. · github.com, 8 Oct 2026
Maker: The GitHub organization describes itself as SomeBottle’s Minecraft server project and lists its location as China. · github.com, 8 Oct 2026
Output mode: With output directories specified, processed region files are written there and the source region files are left unmodified. · github.com, 8 Oct 2026
Protected chunks: It preserves force-loaded chunks, custom protected chunks, and chunks with excessive data. · github.com, 8 Oct 2026
Purpose: PotatoPeeler removes unused chunks from Minecraft Java Edition worlds to free disk space. · github.com, 8 Oct 2026
Requirements: The README instructs users to install the corresponding version of the Java Runtime Environment before using the downloadable JAR. · github.com, 8 Oct 2026
Runtime and download: The README instructs users to install a matching Java Runtime Environment and download a PotatoPeeler JAR from GitHub Releases. · github.com, 8 Oct 2026
Security: GitHub’s repository security page says the project has no SECURITY.md policy and no published security advisories. · github.com, 8 Oct 2026
Server wrapper: When given a Minecraft server JAR, PotatoPeeler can process chunks and then launch that server in the current JVM. · github.com, 8 Oct 2026
Supported format: The tool currently supports only the Anvil file format, used by Minecraft Java Edition since version 1.2.1. · github.com, 8 Oct 2026
Usage: The tool can process local game worlds or server worlds and can launch a Minecraft server after processing when given a server jar. · github.com, 8 Oct 2026
World types: It can be used on local game worlds and server worlds. · github.com, 8 Oct 2026

Where PotatoPeeler stands on Freedom251

Minecraft World Editors#29 of 35