跳转至

方块 NBT 读取

外设扩展器的 NBT 读取功能允许你访问任何方块的内部数据，无需方块专门实现 CC:T 外设接口。

基础用法

读取完整 NBT 数据

local pe = require("ccpe.pe")

-- 读取频道 1 的外设扩展器附着方块的所有 NBT 数据
local data = pe.getAll(1)

-- 示例：箱子的 NBT 结构
-- {
--   Items = {
--     [1] = { count = 16, slot = 0, id = "minecraft:diamond" },
--     [2] = { count = 32, slot = 1, id = "minecraft:iron_ingot" }
--   },
--   x = 8,
--   z = 9,
--   id = "minecraft:chest",
--   y = 63,
-- }

读取特定路径

快速获取路径

在 pe 的右键菜单中，点击一行 NBT 数据即可复制该字段的路径。

如果有▶符号，表示该字段是table，左键点击展开/收起，右键点击复制路径。

使用路径语法只读取你需要的字段，提高效率：

local pe = require("ccpe.pe")

-- 读取第一个物品的 ID
local itemId = pe.get(1, "Items[0].id")
print(itemId)  -- "minecraft:diamond"

-- 读取第一个物品的数量
local count = pe.get(1, "Items[0].count")
print(count)  -- 16

路径语法

NBT 路径使用类似 JSON 的语法：

语法 说明 示例
.field 访问对象字段 id
[index] 访问数组元素（从 0 开始） Items[0]
组合 链式访问 Items[0].count

性能提示

优化建议

  1. 使用路径读取 — 只读取需要的字段，避免传输整个 NBT 结构
  2. 合理设置刷新频率 — 根据实际需求调整 sleep() 时间
  3. 缓存不变数据 — 如方块类型、槽位数等固定信息
-- ❌ 低效：每次都读取完整 NBT
while true do
    local data = pe.getAll(1)
    print(data.Items[1].count)
    sleep(0.05)
end

-- ✅ 高效：只读取需要的字段
while true do
    local count = pe.get(1, "Items[0].count")
    print(count)
    sleep(0.05)
end

故障排查

返回 nil

  • 检查频道号是否正确
  • 确认传感器已贴在方块上
  • 确认路径语法正确（注意数组从 0 开始）

数据不更新

  • 数据刷新频率为 50ms（1 tick）
  • 检查配置文件中的 refresh_interval 设置

下一步