Note: This repository is primarily on Forgejo — the GitHub repository is a mirror. To contribute to this repository, you must do it on Forgejo. You can log in to Forgejo with a GitHub account.

unbted (Una's NBT Editor) is a command-line interactive NBT editor. That's about it, really. Since it's command-line, it can be easily used over SSH connections on remote servers, instead of having to download the file and edit it locally with one of the many GUI editors.

Releases are on Forgejo. 1.2.1 and prior are also on GitHub.

Run the JAR (e.g. unbted-1.2.jar) with any JRE. You can then put a shell script like the following in your PATH:

#!/bin/sh
java -jar /opt/unbted/unbted-1.2.jar "$@"

• ANSI-colorized output for more distinctive and easier to skim output
• Can convert NBT files to well-formed JSON for processing by anything that can parse JSON
  • A special NBT JSON format is supported that can be roundtripped. Want to edit an NBT file with jq? Now you can.
• Support for "inferred" types when printing NBT trees in its default format. This includes:
  • JSON - JSON objects such as generatorOptions in level.dat will be colorized, indented, and split into multiple lines for easier reading
  • Old-style UUID - Pairs of long NBT tags with names ending in Most and Least will be printed as a UUID
  • New-style UUID - Int arrays of length 4 will be decoded into UUIDs
    • The set command supports both forms of UUIDs, which makes working with them easy
  • Forge registries - Lists containing compounds with only two children, K and V, will be printed in a condensed format for easier skimming, and sorted by their value
  • Booleans - unbted will try to guess whether or not an NBT byte is a boolean, and if it thinks it is, will print 0 as false and 1 as true.
• Support for all NBT tags, including int and long arrays
• Full help included
  • Since the help is just plain text files, you can view it online:
    • Usage: https://git.sleeping.town/unascribed/unbted/src/branch/trunk/src/main/resources/switches-help.txt
    • Commands: https://git.sleeping.town/unascribed/unbted/src/branch/trunk/src/main/resources/commands-help.txt
• Full line editing and tab completion
• Persistent history
• Compression autodetection
• Written in Java and compiled to a native statically linked executable
• Support for little-endian legacy Pocket Edition NBT files
• SNBT (i.e. command block format) support for set --compound

• Anvil file support
• Scripting

gradle build, as per usual. Your JAR will be in build/libs.

unbted - Una's NBT Editor
Copyright (C) 2018 - 2023 Una Thompson (unascribed)

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.