Upload Muti_language_Readme/README.zh.md with huggingface_hub
Browse files
Muti_language_Readme/README.zh.md
ADDED
@@ -0,0 +1,141 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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 |
+
• **邮箱**:[email protected]
|
138 |
+
• **GitHub**:[https://github.com/fallingstars123/MC-AI-BuildingGenerate](https://github.com/fallingstars123/MC-AI-BuildingGenerate)
|
139 |
+
• **Discord**: thomasw2004
|
140 |
+
|
141 |
+
---
|