FallingStars123 commited on
Commit
e0da6dd
·
verified ·
1 Parent(s): a1ddc35

Upload Muti_language_Readme/README.zh.md with huggingface_hub

Browse files
Files changed (1) hide show
  1. Muti_language_Readme/README.zh.md +141 -0
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
+ ---