Terrain Diffusion

模组

· 作者 xandergos

使用专用 AI 生成无限地形,而非传统的噪声函数。

0 本站下载 0 关注 更新于 6 个月前

最新 2.2.0-windows · 1.21.1 · Fabric

一键开服(送7天)

Terrain Diffusion Fabric 模组

这是一个将 Terrain Diffusion 集成到 Minecraft Fabric 的模组。

要求

  • 已安装 Fabric 和 Fabric API Mod 的 Minecraft
  • Windows 系统且配备 GPU。对于 Linux 或仅使用 CPU 的情况,请参阅 GitHub
  • 所需显存 (VRAM):1.5GB
  • 所需内存 (RAM):2.5GB(可能需要增加 Minecraft 的内存分配)

使用方法

  1. 从 Releases 下载与您 Minecraft 版本对应的模组 jar 文件,并将其放入您的 Minecraft mods/ 文件夹中。请确保 Minecraft 版本匹配。
  2. 启动 Minecraft,至少在线运行一次以下载模型(约 2.5GB)。
  3. 创建一个世界,并选择 Terrain Diffusion 世界类型。点击 Customize 以设置 World Scale(参见下方的 按世界设置)。

探索世界

该模组包含一个内置的地形浏览器 Web UI。在游戏中运行 /td-explore 命令;它将打印一个可点击的链接(例如 http://localhost:19801),在浏览器中打开交互式地图。点击左侧的地图以打开“详细视图”。点击详细视图可在左下角获取坐标。您还可以筛选特定的气候类型。

在使用 Minecraft 进行冒险之前,请使用浏览器来侦察大陆、山脉、岛屿和其他有趣的地形。

配置

编辑 config/terrain-diffusion-mc.properties(首次启动时自动创建):

# Terrain Diffusion MC configuration

# 推理设备:"cpu"、"gpu" 或 "auto"(优先尝试 GPU,然后回退到 CPU)。
# "gpu" 在 -windows 构建版中使用 DirectML,或在 -cuda 构建版中使用 CUDA。
# GPU 构建版默认设置为 "gpu",因此如果未检测到 GPU,启动时会报错。
# CPU 构建版默认设置为 "auto":在 macOS 上使用 CoreML,否则使用 CPU。
inference.device=gpu

# 在管道阶段之间将非活动模型从显存卸载。
# 将峰值显存保持在 ~1.5-2 GB。如果您有 ~2.5+ GB 的可用内存并希望获得稍快的生成速度,请将其设置为 false。
inference.offload_models=true

# 验证 .minecraft/terrain-diffusion-models 中现有文件的 SHA-256 哈希值。
# 如果您希望提供自定义模型/配置文件而无需哈希检查,请将其设置为 false。
validate_model=true

# 本地地形浏览器 Web UI (/td-explore) 的端口。
explorer.port=19801

# 出生点搜索:用于在 (0, 0) 附近寻找陆地出生点的粗粒度区域大小。
# 从 initial_size x initial_size 开始,每步扩大 8,直到 max_size x max_size。
# 每个粗粒度像素覆盖大片区域(数百个方块),因此 16–128 通常就足够了。
spawn_search.initial_size=16
spawn_search.max_size=128

按世界设置

对于 Terrain Diffusion 世界,在世界创建界面点击 Customize 并设置:

  • World Scale(整数 1..6)

此值随世界存档保存,并影响:

  • 每个方块代表的实际米数(scale=1 => 30m/block,scale=2 => 15m/block,依此类推)
  • 新创建世界的最大高度(假设最高点为 10000 实际米)
  • 推荐值为 2,以在规模和可玩性之间取得良好平衡。使用 1 可获得更小、更紧凑的世界。
  • 较低的值会给 GPU 带来更大压力(Terrain Diffusion 运行得更频繁),而较高的值会给 CPU 带来更大压力(世界高度更大)。大多数现代 GPU 在比例 2 或 3 左右时可能会受到 CPU 的限制。

常见问题

动态链接库 (DLL) 初始化例程失败

这可能会发生在某些旧版 Java 上。请更新到最新版本的 Java 21 或更高版本。最新的 Microsoft OpenJDK 21 版本已知可以正常工作。

LoadLibrary failed with error 126 (仅限 CUDA 构建版)

这通常是由于 CUDA 或 cuDNN 安装不当所致。请参阅 CUDA_INSTALL.md 中的故障排除步骤。

java.lang.IllegalStateException: Failed to load terrain-diffusion models

这通常表明出现“内存不足”错误(日志中也应显示此信息)。 Terrain Diffusion 的模型占用约 2.5GB 的 RAM,因此请确保分配足够的内存以容纳这些模型。

如果您的问题仍未解决,请在此处 提出。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源