Litematic 圆环生成器

生成一个以 (0,0) 为中心、半径为 r 的空心石头圆环的 .litematic 投影文件（面向 Minecraft 1.20.4）。

快速开始

1. 安装依赖（推荐使用虚拟环境）：

python -m venv .venv; .\.venv\Scripts\Activate.ps1
pip install -r requirements.txt

方案 A：使用图形化界面（推荐）

python gui.py

GUI 应用将启动，你可以在窗口中填入参数（半径、Y 坐标、输出文件名、投影名称、作者）并点击"生成 Litematic"按钮。

方案 B：使用命令行

2. 生成一个半径为 10、Y=64 的圆环：

python make_litematic.py --radius 10--y 64--output circle_10.litematic

生成的文件位于当前目录，命名为 circle_10.litematic。

GUI 界面功能

• 半径 (r)：输入圆环的半径（1-500）。
• Y 坐标：投影所在的高度（-64-320，默认 64）。
• 输出文件名：生成的 .litematic 文件名。
• 投影名称：保存在投影文件中的显示名称。
• 作者：投影的作者信息。
• 生成 Litematic：点击按钮生成文件；进度条显示进行状态，成功后显示文件信息。
• 打开文件夹：快速打开当前工作目录查看生成的文件。

输出日志会实时显示在界面下方的信息框中。

参数

• --radius / -r：圆环半径（正整数，必填）。
• --y：建议的放置高度 Y（默认 64，会写入 OffsetY 字段）。
• --output / -o：输出文件名（默认 ring.litematic）。
• --name：Litematic 名称（默认 CircleRing）。
• --author：作者字段（默认 generated）。

文件结构

.
├── make_litematic.py # 核心脚本：生成 Litematic 的逻辑
├── gui.py # 图形化界面应用（推荐使用）
├── requirements.txt # 依赖列表
└── README.md # 本文件

说明与兼容性

• 该工具使用 litemapy 生成 .litematic 文件（更好地兼容 Litematica 格式）。
• 不同版本的 Litematica 或导入工具对 .litematic 的严格结构可能有差异。如果 Litematica 无法直接加载，请把生成的文件附上给我，我会根据实际的错误信息做调整。

实现细节

• 使用 litemapy 创建一个 Region 并在其上设置方块；通过 Region.as_schematic(...) 生成 Schematic 并保存为 .litematic。
• 圆心位于 (0, y, 0)，Region 的 X/Z 范围为 [-r, r]，Y 为单层 y。
• 圆环判定使用距离阈值：radius - 0.5 <= dist < radius + 0.5，以产生约 1 格厚度的环。

如果你希望：

• 改成“实心圆”或改变环厚度；
• 使用不同方块（例如 minecraft:andesite）；
• 将输出变为 .schem 或支持多层（高度>1）；

告诉我你的偏好，我会继续修改脚本。