逆行基因

逆行基因

将新安装模组的矿石和结构添加到已存在的区块和世界中

Retrogen

将新加入的模组矿石和结构带入你现有的 Minecraft 世界。

Retrogen 是一个针对 Minecraft 1.21.1 的服务端模组，它能够将新安装模组所兼容的世界生成内容，添加到那些已经生成过的区块中。

无需长途跋涉前往你已探索区域之外的远方，你可以在同一张地图上继续游玩，而 Retrogen 会在旧的区块被加载时，逐步添加新的矿石和结构。

主要特性

  • 在现有区块中生成模组矿石
  • 在现有区块中生成模组结构
  • 使用每个来源模组的原始设置
  • 保留生物群系和高度限制
  • 逐步处理区块以减少服务器卡顿
  • 防止重复生成
  • 支持自定义包含和排除列表
  • 可以根据现有地形调整结构
  • 兼容 Fabric 和 NeoForge

兼容性

  • Minecraft 1.21.1
  • Fabric — 需要 Fabric API
  • NeoForge

每个加载器都有其独立的 JAR 文件。

在专用服务器上，玩家无需在客户端安装 Retrogen。

安装步骤

  1. 备份你的世界。
  2. 安装正确的 Retrogen 版本。
  3. 安装提供新矿石或结构的模组。
  4. 启动世界。
  5. 使用以下命令检查进度：
/retrogen status

配置文件会自动创建：

config/retrogen.json

你可以在不重启服务器的情况下重新加载它：

/retrogen reload

配置

Retrogen 可以自动检测已安装模组中的标准矿石特性。

你也可以精确选择需要处理的模组、矿石、特性和结构。

示例：

{
  "automaticNamespaces": ["create", "alexscaves"],
  "includePlacedFeatures": [
    "anothermod:*_ore"
  ],
  "excludePlacedFeatures": [
    "example:huge_test_ore"
  ],
  "includeStructures": [
    "minecraft:trial_chambers"
  ],
  "excludeStructures": [
    "example:unsafe_castle"
  ]
}

支持通配符模式：

  • * 匹配多个字符；
  • ? 匹配一个字符。

性能

Retrogen 通过队列处理区块，并限制每个服务器刻内执行的工作量。

默认设置为每次刻执行两个操作，并最多处理八毫秒。

这些值可以在配置文件中更改。

现有世界和自定义世界

Retrogen 处理每个区块中已存储的方块。

模组矿石只会替换原模组生成规则所允许的方块。

对于导入的地图和自定义地形，Retrogen 可以尝试向上或向下移动地表结构，使其更好地匹配实际景观。

此调整不能保证对每个结构都完美有效。

重要警告

在安装 Retrogen 之前，请务必进行备份。

Minecraft 无法可靠地区分一个方块是自然生成还是由玩家放置的。

矿石通常只替换合适的方块，但结构可能会与玩家的建筑或修改过的地形重叠。

当 Retrogen 首次安装到现有的模组世界中时，它可能无法检测到所有已经生成的矿石。这可能会导致额外的矿脉出现。

使用包含和排除设置可以获得更好的控制。

局限性

Retrogen 支持标准的 Minecraft 世界生成系统，例如 PlacedFeature 和 StructureSet。

使用完全自定义生成事件的模组可能不受支持。

请勿删除：

data/retrogen_manifest.json

该文件存储了 Retrogen 在该世界中的生成历史。

请勿在未创建备份的情况下，将已处理过的世界在 Fabric 和 NeoForge 之间移动。这两个加载器存储区块数据的方式不同，某些内容可能会被再次处理。

Retrogen 可以重新定位结构，但无法完全重新生成或混合其周围的地形。

命令

/retrogen status
/retrogen reload