PotatoPeeler

Spec sheet

Purpose

PotatoPeeler removes unused chunks from Minecraft Java Edition worlds to free disk space.Read 8 Oct 2026 · github.com

Security

GitHub’s repository security page says the project has no SECURITY.md policy and no published security advisories.Read 8 Oct 2026 · github.com

License

The project is licensed under the MIT License.Read 8 Oct 2026 · github.com

Maker

The GitHub organization describes itself as SomeBottle’s Minecraft server project and lists its location as China.Read 8 Oct 2026 · github.com

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.Read 8 Oct 2026 · github.com

Backups

For in-place operations, it creates a backup before writing each file and automatically restores the file if writing fails.Read 8 Oct 2026 · github.com

Chunk selection

It identifies chunks for removal by examining their InhabitedTime values.Read 8 Oct 2026 · github.com

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.Read 8 Oct 2026 · github.com

Data limitations

The README says corresponding entities and POI data removal and handling of .mcc files are TODO items.Read 8 Oct 2026 · github.com

Download

The installation instructions direct users to download a PotatoPeeler JAR from the repository's Releases page.Read 8 Oct 2026 · github.com

Dry run

The --dry-run option checks expected behavior without performing write operations.Read 8 Oct 2026 · github.com

File format

The tool currently supports the Anvil file format.Read 8 Oct 2026 · github.com

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.Read 8 Oct 2026 · github.com

Known gaps

The README lists removing corresponding entities and POI data and handling .mcc files as TODOs.Read 8 Oct 2026 · github.com

Output mode

With output directories specified, processed region files are written there and the source region files are left unmodified.Read 8 Oct 2026 · github.com

Protected chunks

It preserves force-loaded chunks, custom protected chunks, and chunks with excessive data.Read 8 Oct 2026 · github.com

Requirements

The README instructs users to install the corresponding version of the Java Runtime Environment before using the downloadable JAR.Read 8 Oct 2026 · github.com

Runtime and download

The README instructs users to install a matching Java Runtime Environment and download a PotatoPeeler JAR from GitHub Releases.Read 8 Oct 2026 · github.com

Server wrapper

When given a Minecraft server JAR, PotatoPeeler can process chunks and then launch that server in the current JVM.Read 8 Oct 2026 · github.com

Supported format

The tool currently supports only the Anvil file format, used by Minecraft Java Edition since version 1.2.1.Read 8 Oct 2026 · github.com

Usage

The tool can process local game worlds or server worlds and can launch a Minecraft server after processing when given a server jar.Read 8 Oct 2026 · github.com

World types

It can be used on local game worlds and server worlds.Read 8 Oct 2026 · github.com

Where Specifiction places it

• Minecraft World Editors#30 of 357.0