mcdr-chest-scanner

MCDReforged 库插件：通过玩家准星指向或指定坐标获取箱子内容，支持大箱子。

安装

在插件 mcdreforged.plugin.json 中声明依赖：

{
  "dependencies": {
    "chest_scanner_lib": ">=0.1.0"
  }
}

依赖	类型
MCDReforged >=2.14.0	插件平台
MinecraftDataAPI	玩家位置/朝向（仅 `find_targeted_chest` 需要）
hjson >=3.1	Python 包（`pip install hjson`）

所有函数成功返回 ({item_id: qty}, None)，失败返回 (None, error_code)。

扫描玩家准星指向的箱子，含双联箱子合并。

items, err = find_targeted_chest(server, "Steve")
if err:
    server.logger.warning(f"扫描失败: {err}")

扫描指定坐标的箱子，含双联箱子合并。

items, err = scan_chest_rcon(server, 10, 64, 20)

函数	返回值	说明
`detect_facing_type(server, x, y, z)`	`(facing, type)` 或 `None`	通过 `execute if block` 探测箱子 block state
`read_double_chest(server, x, y, z, primary_items)`	`dict`	检测 partner 半 + 合并 54 格
`expand_items(items, acc)`	`None`	递归展开嵌套物品（潜影盒）到 `Counter`
`parse_rcon_block_items(raw)`	`(list, None)` 或 `(None, err)`	解析 RCON `data get block` 响应
`parse_block_coords(raw)`	`(x, y, z)` 或 `None`	从 RCON 响应前缀提取坐标

MIT