Retrogen

模组

· 作者 Cat4blep

将新安装的模组中的矿石和结构添加到现有区块与世界

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

最新 1.0 · 1.21.1 · NeoForge

一键开服(送7天)

Retrogen

将新安装模组的矿石和结构添加到现有的 Minecraft 世界中。

Retrogen 是一款针对 Minecraft 1.21.1 的服务端世界生成模组。它在区块加载时处理已生成的区块,并为后来安装的模组添加兼容的矿石和结构。

通常,新的世界生成内容仅出现在未探索的区域。Retrogen 允许你继续使用现有世界,而无需为了寻找新添加的资源或结构而跋涉数千格。

功能特性

  • 向现有区块添加模组矿石
  • 向现有区块添加模组结构
  • 使用源模组提供的原始生成设置
  • 保留生物群系、高度、频率、分布和方块替换规则
  • 支持导入和自定义地形
  • 可调整地表结构以匹配现有地貌
  • 逐步处理区块以减少服务端卡顿
  • 记录已完成的生成尝试
  • 防止重复生成相同内容
  • 支持配置包含和排除列表
  • 支持 Fabric 和 NeoForge

支持版本

  • Minecraft 1.21.1
  • Fabric(需 Fabric API)
  • NeoForge

Fabric 和 NeoForge 使用独立的 JAR 文件。

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

对于单人世界,请将 Retrogen 安装到客户端的 mods 文件夹中。

工作原理

当加载现有区块时,Retrogen 会将其加入处理队列。

区块仅在完全加载后才会被处理。Retrogen 限制每个服务器刻(tick)的操作数量和处理时间。

矿石生成使用源模组提供的原始 PlacedFeature 设置。这意味着 Retrogen 保留了预期的:

  • 生成高度;
  • 矿脉大小;
  • 频率;
  • 生物群系限制;
  • 方块替换规则。

结构通过 Minecraft 的标准结构生成系统创建。

Retrogen 将已处理的内容存储在各自区块内,并将世界的生成历史记录保存在:

data/retrogen_manifest.json

这可以防止每次加载区块时都重新生成相同的矿石或结构。

安装

  1. 备份你的世界。
  2. 安装正确的 Retrogen JAR 文件。
  3. 安装提供新矿石和结构的模组。
  4. 启动服务器或单人世界。
  5. 使用以下命令检查处理队列:
/retrogen status

Fabric 版还需要 Fabric API。

Retrogen 会自动创建其配置文件:

config/retrogen.json

配置

默认配置如下:

{
  "enabled": true,
  "generateOres": true,
  "generateStructures": true,
  "adaptStructuresToExistingTerrain": true,
  "maxOperationsPerTick": 2,
  "maxMillisPerTick": 8,
  "structureReferenceRadius": 8,
  "maxTerrainShift": 96,
  "maxTerrainSampleSpread": 32,
  "maxInhabitedTimeTicks": -1,
  "automaticNamespaces": ["*"],
  "excludedNamespaces": ["minecraft", "retrogen"],
  "includePlacedFeatures": [],
  "excludePlacedFeatures": [],
  "includeStructures": [],
  "excludeStructures": []
}

Retrogen 会自动从允许的命名空间中选择标准的模组矿石特征。

你可以将自动处理限制为特定模组:

{
  "automaticNamespaces": ["create", "alexscaves"]
}

你也可以手动包含或排除单个特征和结构:

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

列表支持通配符模式:

  • * 匹配任意数量的字符;
  • ? 匹配单个字符。

无需重启服务器即可重新加载配置:

/retrogen reload

自定义与导入地形

矿石会在区块内已存在的方块中生成。

模组矿石只能替换源模组生成规则所接受的方块。例如,配置为替换普通 Minecraft 石头的矿石可能不会在自定义石头方块内生成。

Retrogen 还可以调整地表结构以匹配实际地形,而不是仅依赖当前的区块生成器。

启用后,Retrogen 会对现有地表或海底进行采样,并在必要时垂直移动结构。

这是一个尽力而为的系统。某些不常见的结构仍可能需要其原始模组开发者提供特殊支持。

重要警告

在使用 Retrogen 之前,请务必创建备份。

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

矿石通常只替换有效的目标方块,但结构可能会与以下对象交叉:

  • 玩家建筑;
  • 道路;
  • 农田;
  • 地下基地;
  • 其他修改过的地形。

在首次安装时,Retrogen 可能不知道在创建较旧区块时哪些模组矿石已经存在。因此,现有的模组世界可能会接收到额外的矿脉。

在处理重要世界时,请使用包含和排除列表。

局限性

Retrogen 支持通过标准 Minecraft 世界生成系统注册的内容,例如:

  • BiomeGenerationSettings;
  • PlacedFeature;
  • StructureSet。

它无法自动重现通过完全自定义模组事件或独立生成系统生成的内容。

在保持相同注册 ID 的情况下更改生成设置,不会自动触发另一次生成过程。

请勿删除:

data/retrogen_manifest.json

该文件存储了世界的 Retrogen 历史记录。

Retrogen 不会强制加载远处的区块以完成结构。非常大的结构可能需要同时加载其起始区块和远处的部分区块。

Retrogen 可以垂直移动结构,但无法在其周围重新生成自然地形的混合效果。

请勿在未备份的情况下将已处理的存档在 Fabric 和 NeoForge 之间切换。这两个加载器存储 Retrogen 区块标记的方式不同,这可能导致内容被重新处理。

命令

/retrogen status

显示当前处理队列。

/retrogen reload

重新加载配置及可用内容目录。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源