这个工具能做什么
这是一个 7 件套的工具集,打开后先是功能总览页,点卡片进入各自的功能。 所有处理都在浏览器本地完成,文件不上传。
- 结构预览:打开
.mcstructure以创造模式飞行查看; 点方块可读命令方块指令、容器物品与中文名称。WASD 移动、单击方块看详情、 旁观模式下可切层与六向截面。 - 格式转换:基岩
.mcstructure/.bdx与 Java.schem/.nbt/.litematic双向互转, 也能处理.mcworld/.mcpack,以及导出可编辑的 JSON。 - 结构对比:载入两份结构,按方块类型汇总差异并给出逐格差异列表(可导出 CSV)。
- 截图与导出:方块统计 / 命令清单 / 容器物品的 CSV,方块实体与调色板的 JSON; 截图在预览页工具栏。
- 方块检索:按方块中文名 / 英文 ID 或命令关键字检索,一键带着坐标跳进预览并飞过去。
- 命令编辑器:提取结构里全部命令方块,下载命令文本、正则批量替换、
旧版
execute转新语法,再写回.mcstructure下载。 - 存档处理:
.mcworld存档运维 —— 清除主世界/下界/末地、清除指定区块、 按坐标范围导出.mcstructure、直接渲染范围内部。
数据来源:贴图图集与中文名表来自 Minecraft 资源包(26.3),
方块几何按资源包里的模型逐盒还原;NBT 解析用的是预编译的 WebAssembly 模块。
文件永远不会离开你的浏览器:解析、建网格、渲染、转换全在本地完成, 服务器只提供上面这些静态数据文件。工具本体对「用户」及以上身份组开放 (工具箱的统一口径),所以上面那个 iframe 在访客与未登录时不会渲染。
移植说明:本站这一版移植自 mcstructure-3d-viewer 1.19.0(由 Oicca 设计)。
原项目里靠拼 HTML 字符串渲染方块信息的那部分界面,在移植时改成了 DOM + textContent
(见 web/js/mcstructure/dom.js 顶部注释)—— 因为这个工具读的是
用户自己的文件,里面的方块名、命令、告示牌文本都不可信。
上游项目本体已完整并入本仓库的 mcstructure/(含 wasm 源码、
构建脚本、可运行的测试套件与架构文档),见 mcstructure/README-MERGE.md。
