BDXSuperTool

一个用于 Minecraft 基岩版 BDX 格式的多功能工具集：mcfunction 批量转 BDX、BDX 导出 mcfunction 等。

快速开始

启动图形界面

# Windows
scripts/启动GUI界面.bat

# Linux/Mac
scripts/start_gui.sh

命令行使用

python src/mcfunction_to_bdx.py

功能特点

• 批量转换多个mcfunction文件为单个BDX文件
• 自动创建优化的命令方块链结构
• 支持命令方块的各种属性设置（如条件、延迟等）
• 图形界面，简单易用
• 提供中间JSON文件选项，方便调试
• 增量更新：智能检测文件变化，只生成变更的链，大幅提升生成效率
• 热键功能：支持F8/F9/F10快速转换剪贴板内容
• 优化链支持：第一行文本可自动生成优化链结构

安装依赖

# Windows
scripts/install_dependencies.bat

# Linux/Mac
scripts/install_dependencies.sh

热键功能

安装热键依赖

# Windows
scripts/install_hotkey_dependencies.bat

# Linux/Mac
scripts/install_hotkey_dependencies.sh

使用说明

• F8: z-方向延伸（向北）
• F9: y+方向延伸（向上，不延伸）
• F10: y-方向延伸（向下，起点~1）

优化链支持

从第一行文本自动生成优化链：

• #{延迟}命令内容 - 循环命令方块优化链
• #[延迟]命令内容 - 脉冲命令方块优化链
• #命令内容 - 简单优化链（延迟0）

详细说明请参考 docs/热键功能使用说明.md

增量更新功能

增量更新功能可以大幅提升重复生成BDX的效率：

使用方法

1. 在GUI界面中勾选"启用增量更新（仅生成变更的命令链）"
2. 点击"开始转换"
3. 系统会自动对比文件变化，只生成变更的链

主要特性

• 智能对比：自动检测新增、修改、删除的文件
• 多项目支持：支持同时缓存多个源文件夹的数据
• 安全警告：当链变短时提示手动清理多余方块
• 性能提升：修改10%文件即可节省~90%时间

详细说明请参考 docs/incremental_update.md

项目结构

BDXSuperTool/
├── src/                      # 源代码
│   ├── core/                 # 核心功能模块
│   ├── gui/                  # 图形用户界面
│   ├── tests/                # 单元测试
│   ├── utils/                # 工具函数
│   └── web/                  # Web 服务端
├── web/                      # Web 前端 (Vue 3 + Tailwind)
├── deploy/                   # 部署脚本 (Nginx/shell)
├── docs/                     # 项目文档与 spec
├── examples/                 # 示例文件
├── assets/                   # 静态资源
├── images/                   # 说明图片
├── pyproject.toml            # Python 项目配置
└── LICENSE                   # MIT License

使用指南

详细的使用说明请参阅 docs/使用指南.md 文件。

技术文档

• 修复记录
• 开发文档
• BDX格式说明

注意事项

• 建议使用英文文件名和路径，避免编码问题
• BDX文件生成后可直接在Minecraft基岩版中通过导入器使用
• 如果在游戏中导入失败，请查看技术文档获取解决方案

许可证

本项目基于 MIT 许可证开源。详见 LICENSE 文件。

技术支持

如有技术问题，请参阅 documentation/修复总结.md 或提交问题到项目仓库。