Delete README.zh.md
Browse files- README.zh.md +0 -141
README.zh.md
DELETED
|
@@ -1,141 +0,0 @@
|
|
| 1 |
-
---
|
| 2 |
-
title: "智能MC建筑生成器"
|
| 3 |
-
emoji: "🏗️"
|
| 4 |
-
colorFrom: "blue"
|
| 5 |
-
colorTo: "purple"
|
| 6 |
-
sdk: "streamlit" # 或 gradio 取决于你的 web 界面
|
| 7 |
-
app_file: "main.py"
|
| 8 |
-
pinned: false
|
| 9 |
-
---
|
| 10 |
-
|
| 11 |
-
# 智能MC建筑生成器
|
| 12 |
-
|
| 13 |
-
## 项目介绍
|
| 14 |
-
智能MC建筑生成器是一个基于人工智能的工具,能够根据用户输入的提示词(如“平顶”、“深色橡木墙”)自动生成《我的世界》(Minecraft)中的建筑。项目结合了数据增强、3D生成模型和Minecraft数据格式转换技术,支持从单张图像或文本提示词生成10x10x10大小的建筑,并导出为 `.schem` 文件。
|
| 15 |
-
|
| 16 |
-
---
|
| 17 |
-
|
| 18 |
-
[🇨🇳 简体中文](./README.zh.md) | [🇬🇧 English](./README.en.md)
|
| 19 |
-
|
| 20 |
-
---
|
| 21 |
-
|
| 22 |
-
## 主要功能
|
| 23 |
-
1. **数据加载与解析**:支持加载 `.schem` 文件,解析其中的方块数据。
|
| 24 |
-
2. **数据增强**:通过旋转和镜像操作,生成多样化的建筑变体。
|
| 25 |
-
3. **可视化**:支持点云、切片和彩色立方体等多种方式预览建筑。
|
| 26 |
-
4. **提示词生成**:根据用户输入的提示词生成建筑。
|
| 27 |
-
5. **导出功能**:将生成的建筑保存为 `.schem` 文件,供Minecraft使用。
|
| 28 |
-
|
| 29 |
-
---
|
| 30 |
-
|
| 31 |
-
## 依赖项
|
| 32 |
-
• **Python 3.8+**
|
| 33 |
-
• **主要库**:
|
| 34 |
-
• `numpy`
|
| 35 |
-
• `pyvista`
|
| 36 |
-
• `nbtlib`
|
| 37 |
-
• `torch`(用于模型训练)
|
| 38 |
-
• `flask`(用于Web界面)
|
| 39 |
-
|
| 40 |
-
**安装依赖项**:
|
| 41 |
-
```bash
|
| 42 |
-
pip install numpy pyvista nbtlib torch flask
|
| 43 |
-
```
|
| 44 |
-
|
| 45 |
-
---
|
| 46 |
-
|
| 47 |
-
## 使用方法
|
| 48 |
-
|
| 49 |
-
### 1. 数据加载与解析
|
| 50 |
-
将 `.schem` 文件放入项目目录,运行以下代码加载和解析数据:
|
| 51 |
-
```python
|
| 52 |
-
from main import process_block_data
|
| 53 |
-
process_block_data("WoodHouse_3.schem")
|
| 54 |
-
```
|
| 55 |
-
|
| 56 |
-
### 2. 数据增强
|
| 57 |
-
对现有建筑数据进行旋转和镜像增强:
|
| 58 |
-
```python
|
| 59 |
-
from main import generate_rotated_and_mirrored_data
|
| 60 |
-
generate_rotated_and_mirrored_data()
|
| 61 |
-
```
|
| 62 |
-
|
| 63 |
-
### 3. 可视化
|
| 64 |
-
使用以下命令预览建筑:
|
| 65 |
-
```python
|
| 66 |
-
from main import preview_point_cloud, preview_cubes_with_colors, preview_slices
|
| 67 |
-
preview_point_cloud(output_data) # 点云预览
|
| 68 |
-
preview_cubes_with_colors(output_data) # 彩色立方体预览
|
| 69 |
-
preview_slices(output_data) # 切片预览
|
| 70 |
-
```
|
| 71 |
-
|
| 72 |
-
### 4. 提示词生成
|
| 73 |
-
根据提示词生成建筑:
|
| 74 |
-
```python
|
| 75 |
-
from main import generate_from_prompt
|
| 76 |
-
generate_from_prompt("A small house with a flat roof and dark oak walls")
|
| 77 |
-
```
|
| 78 |
-
|
| 79 |
-
### 5. 导出为 `.schem` 文件
|
| 80 |
-
将生成的建筑保存为 `.schem` 文件:
|
| 81 |
-
```python
|
| 82 |
-
from main import save_as_schem
|
| 83 |
-
save_as_schem(house_data, "generated_house.schem")
|
| 84 |
-
```
|
| 85 |
-
|
| 86 |
-
### 6. Web界面
|
| 87 |
-
启动Web服务器,提供用户交互界面:
|
| 88 |
-
```bash
|
| 89 |
-
python main.py
|
| 90 |
-
```
|
| 91 |
-
访问 `http://Not_created_yet`,输入提示词生成建筑。
|
| 92 |
-
|
| 93 |
-
---
|
| 94 |
-
|
| 95 |
-
## 文件结构
|
| 96 |
-
```
|
| 97 |
-
MC_Building_Generator/
|
| 98 |
-
├── schem/ # 存放 .schem 文件
|
| 99 |
-
│ └── WoodHouse_3.schem
|
| 100 |
-
├── npy/ # 存放 .npy 文件
|
| 101 |
-
│ └── block_data_0.npy
|
| 102 |
-
├── main.py # 主程序
|
| 103 |
-
├── block_data.txt # 解析后的数据
|
| 104 |
-
├── metadata.txt # 元数据
|
| 105 |
-
└── README.md # 项目说明
|
| 106 |
-
```
|
| 107 |
-
|
| 108 |
-
---
|
| 109 |
-
|
| 110 |
-
## 示例
|
| 111 |
-
1. **加载 `.schem` 文件**:
|
| 112 |
-
```bash
|
| 113 |
-
python main.py
|
| 114 |
-
```
|
| 115 |
-
2. **输入提示词生成建筑**:
|
| 116 |
-
• **提示词**:`A small house with a flat roof and dark oak walls`
|
| 117 |
-
• **生成文件**:`generated_house.schem`
|
| 118 |
-
|
| 119 |
-
---
|
| 120 |
-
|
| 121 |
-
## 注意事项
|
| 122 |
-
1. 确保 `.schem` 文件符合Minecraft的格式要求。
|
| 123 |
-
2. 提示词应尽量简洁明确,避免歧义。
|
| 124 |
-
3. 生成的建筑数据会保存在 `block_data_*.npy` 文件中。
|
| 125 |
-
|
| 126 |
-
---
|
| 127 |
-
|
| 128 |
-
## 未来计划
|
| 129 |
-
1. 支持更多建筑类型和尺寸。
|
| 130 |
-
2. 优化生成模型,提高生成速度和精度。
|
| 131 |
-
3. 开发更友好的用户界面,支持实时预览。
|
| 132 |
-
|
| 133 |
-
---
|
| 134 |
-
|
| 135 |
-
## 联系信息
|
| 136 |
-
如有任何问题或建议,请联系:
|
| 137 |
-
• **邮箱**:3467025700@qq.com
|
| 138 |
-
• **GitHub**:[https://github.com/fallingstars123/MC-AI-BuildingGenerate](https://github.com/fallingstars123/MC-AI-BuildingGenerate)
|
| 139 |
-
• **Discord**: thomasw2004
|
| 140 |
-
|
| 141 |
-
---
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|