SakuraRealm工具箱 配置生成 · 在线工具 · 技术教程

MC 结构工具

Minecraft 基岩版结构文件的本地查看、检索、对比与转换 —— 预览、转换、对比、导出、检索、命令编辑、存档处理,共 7 项。文件不上传。

回到工具箱

Minecraft 结构预览需要「用户」及以上身份组

工具箱的每个工具都要占用服务端资源(任意精度计算、曲线采样、对外部模型服务的调用、宿主机上的素材文件),所以只对「用户」及以上开放。你还没有登录。

注册默认就是「访客」:签到与阅读满若干天后会自动升为「用户」(个人中心会显示还差几天)。

登录 / 注册 看看还有哪些工具

这个工具能做什么

这是一个 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。