Skip to content

快速开始

开发中

ObsidianNBT 目前处于早期开发阶段,以下内容为计划功能,尚未实现。

安装

从源码构建

需要 Rust 1.88.0 或更高版本。

bash
git clone https://github.com/AptS-1547/ObsidianNBT.git
cd ObsidianNBT
cargo build --release

构建产物位于 target/release/obsidian-nbt

通过 Cargo 安装

bash
cargo install obsidian-nbt

通过 Homebrew 安装(macOS)

bash
brew install AptS-1547/tap/obsidian-nbt

基本用法

查看 NBT 文件

bash
# 以树形结构查看 NBT 文件内容
obsidian-nbt view level.dat

# 输出为 JSON 格式
obsidian-nbt view level.dat --format json

# 输出为 SNBT 格式
obsidian-nbt view level.dat --format snbt

转换格式

bash
# NBT 转 JSON
obsidian-nbt convert level.dat -o level.json

# JSON 转 NBT
obsidian-nbt convert level.json -o level.dat

编辑 NBT 数据

bash
# 设置指定路径的值
obsidian-nbt set level.dat "Data.GameType" int 1

# 删除指定路径
obsidian-nbt delete level.dat "Data.CustomBossEvents"

支持的 NBT 类型

类型 ID类型名称Rust 类型说明
0TAG_End-标记复合标签结束
1TAG_Bytei8有符号字节
2TAG_Shorti16有符号短整数
3TAG_Inti32有符号整数
4TAG_Longi64有符号长整数
5TAG_Floatf32单精度浮点数
6TAG_Doublef64双精度浮点数
7TAG_Byte_ArrayVec<i8>字节数组
8TAG_StringStringUTF-8 字符串
9TAG_ListVec<Tag>同类型标签列表
10TAG_CompoundHashMap命名标签集合
11TAG_Int_ArrayVec<i32>整数数组
12TAG_Long_ArrayVec<i64>长整数数组

Released under the MIT License.