https://github.com/unascribed/unbted
Una's NBT Editor - an advanced interactive command-line NBT editor
https://github.com/unascribed/unbted
minecraft nbt nbt-editor
Last synced: 10 months ago
JSON representation
Una's NBT Editor - an advanced interactive command-line NBT editor
- Host: GitHub
- URL: https://github.com/unascribed/unbted
- Owner: unascribed
- License: gpl-3.0
- Created: 2018-09-10T17:05:19.000Z (over 7 years ago)
- Default Branch: trunk
- Last Pushed: 2023-08-29T06:38:07.000Z (over 2 years ago)
- Last Synced: 2025-03-18T13:44:59.902Z (10 months ago)
- Topics: minecraft, nbt, nbt-editor
- Language: Java
- Homepage:
- Size: 271 KB
- Stars: 42
- Watchers: 2
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Una's NBT Editor
**Note**: This repository is primarily on [Forgejo](https://git.sleeping.town/unascribed/unbted) —
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 (**U**na's **NBT** **Ed**itor) 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.
## Downloads
Releases are [on Forgejo](https://git.sleeping.town/unascribed/unbted/releases). 1.2.1 and prior are
also on GitHub.
## Running
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:
```sh
#!/bin/sh
java -jar /opt/unbted/unbted-1.2.jar "$@"
```
## Features
* 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`
## Planned features
* Anvil file support
* Scripting
## Building
`gradle build`, as per usual. Your JAR will be in build/libs.
## License
```
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 .
```