Metadata-Version: 2.4
Name: bdxsupertool
Version: 1.0.0
Summary: Minecraft 基岩版 BDX 工具集：mcfunction 批量转 BDX、BDX 导出 mcfunction 等
Project-URL: Homepage, https://github.com/Wuxie233/BDXSuperTool
Project-URL: Repository, https://github.com/Wuxie233/BDXSuperTool
Project-URL: Issues, https://github.com/Wuxie233/BDXSuperTool/issues
Author: Wuxie233
License-Expression: MIT
License-File: LICENSE
Keywords: bdx,bedrock,command-block,mcfunction,minecraft
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Games/Entertainment
Requires-Python: >=3.10
Requires-Dist: brotli>=1.0.9
Requires-Dist: chardet>=5.0
Requires-Dist: nbtlib>=2.0.4
Requires-Dist: pycryptodome>=3.17
Requires-Dist: tqdm>=4.64.0
Provides-Extra: cli
Requires-Dist: pynput>=1.7.6; extra == 'cli'
Requires-Dist: pyperclip>=1.8.2; extra == 'cli'
Provides-Extra: web
Requires-Dist: fastapi>=0.115; extra == 'web'
Requires-Dist: python-multipart>=0.0.9; extra == 'web'
Requires-Dist: uvicorn[standard]>=0.30; extra == 'web'
Description-Content-Type: text/markdown

# BDXSuperTool

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

## 快速开始

### 启动图形界面
```bash
# Windows
scripts/启动GUI界面.bat

# Linux/Mac
scripts/start_gui.sh
```

### 命令行使用
```bash
python src/mcfunction_to_bdx.py
```

## 功能特点

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

## 安装依赖

```bash
# Windows
scripts/install_dependencies.bat

# Linux/Mac
scripts/install_dependencies.sh
```

## 热键功能

### 安装热键依赖
```bash
# Windows
scripts/install_hotkey_dependencies.bat

# Linux/Mac
scripts/install_hotkey_dependencies.sh
```

### 使用说明
- **F8**: z-方向延伸（向北）
- **F9**: y+方向延伸（向上，不延伸）
- **F10**: y-方向延伸（向下，起点~1）

### 优化链支持
从第一行文本自动生成优化链：
- `#{延迟}命令内容` - 循环命令方块优化链
- `#[延迟]命令内容` - 脉冲命令方块优化链  
- `#命令内容` - 简单优化链（延迟0）

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

## 增量更新功能

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

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

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

详细说明请参考 [docs/incremental_update.md](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](docs/使用指南.md) 文件。

## 技术文档

- [修复记录](documentation/修复记录.md)
- [开发文档](documentation/mcfunction_to_bdx_dev_doc.md)
- [BDX格式说明](documentation/README_BDXConverter.md)

## 注意事项

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

## 许可证

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

## 技术支持

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