True Rick的传送枪

此模组尚处于早期开发阶段（Very WIP），因此存在大量 Bug。游玩前请备份重要世界。

模组功能

• 通过提示词控制地形高度、起伏、粗糙度、侵蚀程度以及梯田地貌
• 可配置规模的海洋、岛屿、浮空岛和连通洞穴
• 精确的原版方块材质，包括如钻石块世界等提示词
• 程序化生成的城市
• 原版生物群系配置
• 可保存、分页和重命名的生成世界

相同的提示词、模型版本和 Minecraft 世界种子会生成相同的区块。仅生成玩家已探索的区块。

运行需求

• Minecraft Java版 1.20.1
• Forge 47.4.10 或更新的兼容 Forge 47.x 版本
• Java 17
• 服务端及每个连接的客户端均需安装此模组
• 安装 Ollama 并下载一个文本模型

在单人游戏中，逻辑服务端即玩家电脑。在专用服务器上，仅需服主安装 Ollama 和模型，连接的玩家无需安装。

安装步骤

1. 创建或选择一个 Minecraft 1.20.1 Forge 配置文件。

2. 将 Forge JAR 放入配置文件的 mods 文件夹。对于多人游戏，请在专用服务器和所有客户端上安装相同的 JAR。

3. 安装并启动 Ollama。

4. 在终端中安装默认的多语言模型（qwen3:4b）：

   ollama pull qwen3:4b
   

5. 启动 Minecraft。

使用方法

合成传送枪，或运行以下命令获取：

/give @s ricksgun:portal_gun

有序合成配方如下：

   E   E
I   N   I
   R   I

E = 末影之眼，I = 铁锭，N = 下界之星，R = 红石。

1. 手持传送枪，潜行并右键打开目标界面。
2. 使用 寻找世界 输入描述，或从 世界 列表中选择已保存的目标。使用 主世界 可进入原版和已加载的模组维度。
3. 关闭界面并右键射击。

配置

首次启动会生成 config/ricksgun-ollama.json：

{
  "endpoint": "http://127.0.0.1:11434",
  "model": "qwen3:4b",
  "timeout_seconds": 180,
  "concurrency": 2,
  "queue_capacity": 14,
  "keep_alive": "5m"
}

Alpha 版本限制

• 生成质量和响应时间取决于本地模型和硬件性能。
• Minecraft 的建筑高度范围仍为 -64..319；提示词只能选择可用部分，无法在运行时更改引擎层面的维度高度。
• 由于 Minecraft 无法在启动后安全地注册新的维度类型，生成的目标会占用已注册维度中的独立区块。