MCStructure 3D Viewer v0.9.6-beta

Minecraft Bedrock Edition .mcstructure 3D 查看器。

使用方式

下载 MCStructureViewer.exe，双击运行。无需安装 Python 或任何依赖。

打开后点击 加载 mcstructure 文件 选择 .mcstructure 文件即可查看。

操作说明

操作	功能
左键拖拽	旋转视图
中键拖拽	平移视图
右键拖拽 / 滚轮	缩放视图
左键点击命令方块	选中并显示详情（黄色高亮）
悬浮命令方块	弹出提示框

功能

• 解析 .mcstructure 文件（基于 TrimMCStruct）
• 3D 渲染方块，支持 MC 原版纹理
• 支持 Bedrock geo.json 几何模型（40 种，含楼梯/台阶/栅栏/灯笼/锁链/末地烛等）
• 面剔除优化 — 相邻全方块遮挡面不渲染
• Y轴层数筛选（拖动条 + 直接编辑）
• 命令方块叠层点击循环选择
• 轨道相机 — 旋转/平移/缩放始终围绕结构中心
• 命令方块方向箭头 + 射线拾取选中 + 悬浮提示 + 完整 NBT 数据
• 命令编辑区视觉自动换行（加大高度）
• Y轴筛选 + 方块信息 独立弹窗（非模态，可后台打开）
• 纹理/纯色切换、线框模式、网格显示
• "仅显示命令方块"模式
• 更多属性筛选弹窗（全选/清除/应用）
• 方块类型统计
• 深蓝主题 UI

显示选项

选项	说明
显示网格	底部 XZ 参考网格
显示命令方块	切换命令方块可见性
线框模式	只显示边框
显示纹理	纹理/纯色渲染切换
仅显示命令方块	隐藏所有非命令方块

信息面板

• 结构尺寸、总方块数
• 命令方块：坐标、命令、朝向、红石模式、条件位等
• 选中命令方块：实时显示基础属性
• 方块类型统计
• 更多属性筛选

坐标系统

轴	颜色	方向
X	红色	东 (East)
Y	绿色	上 (Up)
Z	蓝色	南 (South)

开发环境

pip install PyQt5 PyOpenGL TrimMCStruct numpy
python main.py

打包：

build.bat