Minecraft World Utils

A command line tool for Minecraft worlds

Warning

This program has not been rigorously tested and may corrupt your world. Remember to beckup before proceeding.

Usage

The general usage is:

./MinecraftWorldUtils [options] <path/to/world/folder>

Use -v or --verbose to include more information

Note

Currently, the only feature implemented is to remove every chunk's sky light and Starlight data, as well as setting the chunk's Status to light in order to trigger re-lighting to occur,

More features and flexibility hopefully coming in the future

Installation

Grab the latest release here based on your target platform

Alternatively, compile it yourself with the steps below

Compiling

This tool is currently built using Zig 0.16.0-dev.1484+d0ba6642b, get it yourself from the official website, your system's package manager, or using Zig Version Manager.

# Clone this repository locally
git clone https://codeberg.org/Leapofod/MinecraftWorldUtils
# Or download the source code and unpack it somewhere
# Change into the project folder
cd MinecraftWorldUtils/
# With zig in your system PATH, simply run build
zig build

TODO

• Write tests for the NBT parser
• Write tests for the MCR/MCA parser
• Add a dry run option
• Separate functionality into proper subcommands
• Create a dynamic action parser for more complex commands

Special Thanks

• silversquirl for the implementation of CountingWriter
• zig-clap