本教程以 Windows 为例。提前安装 Python 3、Git 和 Minecraft 基岩版。

整个流程：下载地形数据 → Python 生成行为包 → 导入游戏生成地图。

1. 下载项目

打开 Windows PowerShell，执行：

git clone https://github.com/2024080911015/minecraft-taiwan.git
cd minecraft-taiwan

后面的 Python 命令都在这个项目目录中运行。

2. 安装 Python 依赖

创建独立环境，再安装需要的库：

py -m venv .venv
.\.venv\Scripts\python.exe -m pip install numpy pillow rasterio

下面直接使用这个环境里的 Python，不需要另外激活环境。

3. 下载台湾地形数据

打开 OpenTopography，进入全球高程数据页面：

  1. 选择 Copernicus GLO-30 数据集。
  2. 在地图上框选台湾，四周留出一些海域。
  3. 选择 GeoTIFF 格式，按页面提示提交并下载数据。
  4. 将下载的 .tif 文件重命名为 taiwan_dem.tif，放到项目根目录。

框选范围可以参考：

西：119.5° E    东：122.2° E
南：21.7° N     北：25.5° N

DEM 就是记录各个位置海拔的数据。放好后，目录应包含：

minecraft-taiwan/
├── taiwan_dem.tif
├── 01_dem_to_png.py
└── 02_png_to_bedrock_pack.py

4. 生成高度图

回到 PowerShell，执行：

.\.venv\Scripts\python.exe 01_dem_to_png.py

生成两张图片：

  • output/taiwan_height.png：越亮，地形越高。
  • output/taiwan_mask.png：白色是陆地，黑色是海洋。

打开图片，确认能看到完整的台湾轮廓，再继续。

5. 生成 Minecraft 行为包

执行：

.\.venv\Scripts\python.exe 02_png_to_bedrock_pack.py

完成后找到：

output/TaiwanTerrainBP.mcpack

这个文件就是要导入基岩版的行为包。

6. 导入行为包

双击 TaiwanTerrainBP.mcpack，等待 Minecraft 打开并提示导入成功。

如果双击没有打开游戏，右键选择“打开方式”，选择 Minecraft。

7. 新建世界并启用行为包

在 Minecraft 基岩版中创建一个新的测试世界，设置：

  1. 创造模式。
  2. 平坦世界。
  3. 开启作弊。
  4. 在“行为包 → 我的包”中，激活 Taiwan Terrain Generator。

地图生成会修改方块，第一次使用新世界操作。

8. 输入命令，等待生成

进入世界，打开聊天栏，输入：

/function taiwan/generate

程序会分块生成地形。过程中角色会被自动传送，这是为了加载接下来要生成的区域。

等待完成提示，期间不要退出世界或重复输入生成命令。 完成后就可以飞起来查看台湾地形。

可选：调整地图效果

先用默认参数完成一次。需要调整时，再修改对应脚本：

想调整什么修改哪里
地图大小01_dem_to_png.py 的 TARGET_WIDTH，数值越大，生成耗时通常越长
山的高度02_png_to_bedrock_pack.py 的 MAX_Y
地形平滑程度02_png_to_bedrock_pack.py 的 HEIGHT_SMOOTH_RADIUS
地图方向02_png_to_bedrock_pack.py 的 FLIP_X、FLIP_Z

改完第一个脚本，需要重新运行两个脚本；只改第二个脚本，重新运行第二个即可。然后重新导入生成的行为包，在新的测试世界中查看效果。

项目源码：minecraft-taiwan