Skip to content

README.md

Latest commit

 

History

History
54 lines (40 loc) · 1.75 KB

README.md

File metadata and controls

54 lines (40 loc) · 1.75 KB
Raw

中文版 (Chinese Version)

CleanMCA

CleanMCA is a Bash script for cleaning up unnecessary files in the region, poi, and entities directories of a Minecraft world save. By providing a whitelist file, the script will automatically delete any .mca files not listed, helping you reduce world size and free up space.

Features

  • Keeps only the .mca files specified in the whitelist.
  • Processes the region, poi, and entities directories simultaneously.
  • Checks parameters and paths before operation to prevent mistakes.
  • Irreversible operation—please back up your world before use.

Usage

1. Prepare the Whitelist File

The whitelist is a plain text file, with one .mca filename per line, for example:

r.0.0.mca
r.0.1.mca
r.1.0.mca

You can use the Dominion plugin to generate a whitelist based on land claims.

2. Run the Script

In your terminal, execute:

bash CleanMCA.sh --mca <whitelist_file_path> --region <region_directory_path>

Or use short options:

bash CleanMCA.sh -m <whitelist_file_path> -r <region_directory_path>

Parameter description:

  • --mca or -m: Path to the whitelist file.
  • --region or -r: Path to the Minecraft world's region directory.

3. Example

bash CleanMCA.sh -m whitelist.txt -r /path/to/world/region

The script will process the region, poi, and entities directories, deleting files not in the whitelist.

Notes

  • This operation is irreversible. Please back up your world before running the script!
  • Requires a Bash-compatible environment (Linux, WSL, Git Bash, etc.).
  • Requires common command-line tools: getopt, realpath, grep, etc.

License

This project is licensed under the MIT License.