重要：请确认你要找的是哪一个 OreSpawn

此页面介绍的是MMD OreSpawn，一个世界生成前置库

MMD OreSpawn 是一个适用于 Minecraft Forge 的可配置世界生成引擎。
它被模组和整合包用于管理矿石、地质、岩层、地下矿藏、
生物群系以及其他世界生成设置。

本项目与通常被称为“OreSpawn”的另一款冒险与生物模组没有任何关联。它不包含该模组中的龙、
女朋友、DangerZone、可复制矿石的树木、Boss、生物、武器、
维度或其他冒险内容。

如果你要找的是那些内容，那么这不是正确的下载页面。
安装前请确认项目名称、作者和支持的 Minecraft 版本。

如果你需要可配置的世界生成，或正在寻找 Minecraft Mineralogy 等模组所需的前置库，
那么你来对地方了。

单独安装 MMD OreSpawn 通常不会主动产生效果。它的功能需要由兼容的提供模组启用，
或通过为世界选择的设置启用。
关于那款无关冒险模组的问题和漏洞报告，应提交给该项目自己的维护者。

MMD OreSpawn 4

MMD OreSpawn 是一个适用于 Minecraft Forge 的可配置世界生成引擎。它为玩家、整合包和其他模组提供了一个统一的位置，用于控制矿石、岩层、地下流体矿藏、生物群系、世界材料以及相关的世界生成设置。

OreSpawn 不会自行注册新的方块、物品、生物或维度。Minecraft Mineralogy 和 Base Metals 等模组可以提供内容和开箱即玩的设置，而 OreSpawn 则负责验证这些设置并执行生成。

OreSpawn 4 文档 | MMD 项目指南 | 源代码 | 问题追踪器 | MMD Discord

这是 MMD OreSpawn，一个世界生成前置库。

它不是那款添加生物、女朋友、DangerZone 以及其他冒险内容的无关模组。

选择正确的 OreSpawn 版本

OreSpawn 4 和 OreSpawn 3 属于不同代际，使用不同的配置格式。请根据你的整合包中安装的主版本，使用对应的文档。

版本	适用场景	文档
OreSpawn 4	当前 Forge 版本、现代提供模组、新世界以及当前整合包	从 OS4 指南开始
OreSpawn 3	旧版 Minecraft 1.10 和 1.12 安装	打开 OS3 旧版指南

使用上方的文件选项卡，选择与你的 Minecraft 和 Forge 版本完全匹配的构建版本。不要在旧整合包中将 OS4 直接替换 OS3。

OreSpawn 4 有何不同？

OreSpawn 3 已经让整合包作者能够比 Minecraft 的标准生成器更好地控制矿石生成位置。它支持不同的矿脉形状、加权产出和替换方块、生物群系过滤器、分数频率、自定义维度以及重新生成。

之后，Mineralogy 开发出了更加广泛的地质系统。它可以构建岩层，从大范围的地下区域中选择地质类型，让地表生物群系影响其下方的岩石，并在合适的母岩材料中放置矿石和地下矿藏。

OreSpawn 4 将这些理念整合成了一个共享引擎。

内容模组仍然负责自己的方块和玩法。它可以描述自己想要贡献的岩石、矿石、矿藏、生物群系或材料。OreSpawn 会将已安装的内容贡献与整合包设置结合起来，检查所引用的内容是否存在，并将最终结果与世界一同保存。

这意味着多个兼容模组可以使用同一个世界生成系统，而不必分别尝试替换地形或独立放置矿石。

方面	OreSpawn 3	OreSpawn 4
主要用途	可配置的矿石生成	用于矿石、地质、矿藏、生物群系和世界材料的共享引擎
配置方式	位于 `config/orespawn3` 下的 OS3 JSON 文件	提供方默认设置、整合包覆盖设置、模板、全局设置以及保存的世界配置文件
内容归属	由配置指定要放置的方块	每个提供方负责其内容的稳定规则
地质系统	替换方块和矿石母岩	地质类型、岩石族群、深度偏好以及大范围的稳定地层
玩家设置	主要通过配置文件驱动	创建世界编辑器、推荐默认设置、工具提示以及游戏内指南
世界安全性	由整合包作者协调各个生成器	验证、提供方状态、保存的配置文件以及有明确控制的重新生成

OreSpawn 4 可以管理的内容

岩层和地质类型

OS4 可以将普通的地下母岩方块替换为由提供方或玩家选择的岩石构成的大范围地层。

现代的Sky系统使用名为地质类型的地质区域。地表生物群系会影响其下方可能出现的地质类型，但地质类型的边界并不会简单地复制生物群系地图。大范围的区域变化可以让同一个地质省延伸到多个生物群系下方，而边界细节则能避免边缘变成笔直的墙壁。

地质类型可以偏好不同的岩石族群，例如沉积岩、变质岩、侵入型火成岩和火山岩。深度随后会帮助选择在特定高度适合使用的岩石族群和具体岩石。

稳定层生成算法会将这些选择转化为大范围、连续的地层，并提供可配置的延伸范围、厚度、起伏度、边缘细节和连续性。较旧的Cyano（Legacy）层样式也可供偏好经典 Mineralogy 风格的玩家和迁移后的世界使用。

OreSpawn 并不要求使用岩层。纯矿石模组可以将矿石放置在普通的原版地形中，同时所有地质控制项都会保持停用状态。

可配置的矿石

每条矿石规则都可以控制：

维度和 Y 轴范围
每个区块的生成尝试次数
固定或范围随机的方块数量
均匀、中心聚集或深层偏置的高度分布
承载方块、承载方块标签和已配置的岩石系列
包含或排除的生物群系和地质群系
加权输出方块和加权承载方块
矿石最多可以在洞穴墙壁上暴露多少
该规则是否参与矿石重生成

内置的矿床生成模式包括：

模式	结果
紧凑型	致密且相互连接的矿床
矿脉型	蜿蜒延伸的矿化路径
普通云团型	范围广泛且分布稀疏的矿床
精准型	确定性的紧凑填充
簇群型	多个彼此靠近且相互连接的节点
流体下方型	生成在指定流体下方的矿床

其他模组可以通过公开 API 注册自己的生成模式类型。生成模式的设置会在区块生成前完成解码和准备，而不是在放置方块时反复解析。

地下流体矿床

提供方和整合包可以定义被覆盖的地下水、熔岩、石油、卤水或其他已安装流体方块的空腔。

深度、频率、半径、垂直形状、凸起、承载材料、实心顶盖、实心外壳、生物群系和地质群系偏好都可以分别配置。这些是有意生成的地下矿床，而不是暴露在外的原版湖泊。

生物群系和世界材料

OS4 可以将提供方生物群系添加到现有的生物群系源中，或在适用时提供完全由提供方控制的生物群系风格。

维度设置还可以控制地表方块和填充方块、水下材料、含水层流体、第二种深层含水层流体、积雪和冰层。未配置的维度会保留其现有的生成器和材料。

维度、模板和原版特征

规则可以通过注册表 ID 指定主世界、下界、末地或已安装的自定义维度。命名模板可以描述一种完整的可选世界风格，供玩家或整合包使用。

OreSpawn 还可以管理已声明的原版矿石特征，并在明确启用相关选项时压平基岩。除非所选配置文件要求启用，否则这两项功能默认关闭。

OreSpawn 的使用方式

与内容模组一起安装

这是普通玩家最常见的使用方式。

Mineralogy 6 提供岩石、矿石、原油、建筑内容和推荐的地质设置。Modern Base Metals 的发行版本可以提供其金属矿石及生成规则。OreSpawn 负责处理共享的世界生成工作。

只要某个模组将 OreSpawn 列为必需前置库，就应在客户端和服务器上安装匹配的 OreSpawn 版本。

自行配置世界

即使没有完整的地质内容模组，也可以使用 OreSpawn。

当没有提供方提供岩石时，岩石编辑器可以从适合的原版材料中开始，并提供可编辑的选择，例如石头、深板岩、花岗岩、闪长岩、安山岩和凝灰岩。你可以添加已安装模组中的合适方块，移除不需要的材料，或禁用地层，仅配置所需的功能。

制作整合包

整合包作者可以：

无需编辑模组 JAR 文件即可调整提供方规则
协调多个兼容模组的矿石生成
选择每条规则可以使用的维度和承载材料
选择或创建完整的世界模板
在整合包需要统一数据来源时管理原版矿石
提供会复制到每个新世界中的全局默认设置
使用服务端命令查看提供方状态和当前配置文件

在发布整合包之前，请使用完整的模组列表测试最终配置。与其在玩家已经建立的存档中排查，不如在全新的测试世界里更容易发现缺失方块、被移除的提供器以及相互冲突的原生生成器。

集成其他模组

大多数集成都可以通过放置在以下位置的提供器文件进行描述：

data/<modid>/orespawn/provider.json

提供器可以只添加矿石，也可以同时添加岩石、地质群系、流体矿床、生物群系调色板、维度材料、地形维度和模板。需要通过程序构建内容的模组可以使用受支持的 zone.moddev.mc.orespawn.api Java API。

OreSpawn 是一个正常的必需依赖。不要将其引擎打包进其他模组，也不要复制其引擎。

创建世界

对于普通的 OS4 配置：

在客户端和服务器上安装匹配的 OreSpawn Forge 构建版本及其提供器模组。
创建世界时打开 OreSpawn 世界生成。
为已安装的提供器选择 推荐默认值。
如果想自定义配置，请在创建世界前调整地质、岩石、矿石、矿床、生物群系或世界材料。
当你不熟悉某项设置时，请使用 帮助与指南 或查看控件提示。
按下完成，然后正常创建世界。

在没有任何内容选择启用时，OreSpawn 会刻意保持被动。仅安装它不会悄悄替换石头、移除原版矿石或改变下界。

世界配置与服务器

世界的最终设置会保存于：

<world>/serverconfig/orespawn-worldgen.json

该文件是所选提供器及其设置的独立快照。将单人世界迁移到专用服务器时，请连同此文件一起复制整个世界。服务器上也必须安装相同的必需模组。

全局文件：

config/orespawn-worldgen.json

为新创建的世界提供默认值。它不会替换现有世界中已经保存的配置。

更改通常只会影响新生成的区块。岩层永远不会进行回溯生成。矿石和扁平基岩的回溯生成必须主动启用，并且会跟踪版本修订，每次只处理数量受限的区块。

在更改模组列表、配置或回溯生成设置之前，务必备份世界。

实用命令

命令	用途
`/orespawn status`	显示当前模式、提供器、规则和回溯生成状态
`/orespawn reload`	重新加载提供器和当前世界配置
`/orespawn retrogen [radius]`	为当前已加载的区块安排受支持的回溯生成
`/orespawn dump-biomes`	导出当前安装可见的生物群系 ID

整合包配置文件

位置	用途
`config/orespawn-worldgen.json`	复制到新创建世界中的默认值
`<world>/serverconfig/orespawn-worldgen.json`	属于某个世界的最终配置
`config/<modid>-orespawn.json`	整合包针对某个提供器的权威覆盖配置
`config/orespawn-guide/`	由已安装的 OreSpawn JAR 导出的文档、示例和架构

现有的提供器覆盖配置具有权威性。如果该提供器配置格式错误，该提供器会保持停用状态，而不会静默回退到另一组默认值。这样可以让配置错误显现出来，避免整合包的世界生成设置被悄悄改变。

从 OS3 或更旧版本的 Mineralogy 设置迁移

OS4 可以从以下位置导入兼容的设置：

config/orespawn3/ 和 config/orespawn/ 下的 OreSpawn 2 和 3 配置文件
config/orespawn.cfg 中的兼容标志
Mineralogy 的 config/mineralogy-geomes.json
旧版 OS4 的全局、世界和提供器架构

迁移器支持识别 OS3 中的数量、垂直高度范围、频率小数值、生成模式、加权方块、生物群系筛选器、重新生成标志，以及旧版空维度列表的含义。

迁移过程不会破坏原有数据。源文件会被保留，现有目标配置档会受到保护，同时报告会写入：

config/orespawn-migration/migration-report.txt

请查看该报告，在世界副本上测试迁移结果，并保留原始备份。现有的岩层不会被重写。

文档

公开 Wiki 提供了适合入门的 OS4 系列指南：

对于确切的配置字段，应以已安装 jar 导出到 config/orespawn-guide/ 中的指南为准。该指南与对应的构建版本完全匹配，并包含经过验证的示例和 JSON Schema。

当前公开的源代码文档也可以在 master-1.20 文档文件夹中找到。

问题与解答

OreSpawn 会自行添加矿石或岩石吗？

它不会添加内容方块，而是根据当前启用的配置档放置现有方块。这些方块可能来自 Minecraft、提供器模组，或玩家或整合包所选择的其他已安装模组。

为什么单独安装 OreSpawn 后什么也不会发生？

这是预期中的被动默认行为。请安装 Mineralogy 之类的提供器，在创建世界编辑器中选择独立设置，或添加整合包配置。

OreSpawn 是否需要 Mineralogy？

不需要。Mineralogy 是 OS4 的主要提供器之一，能够提供完整的地质体验，但 OreSpawn 也可以与其他提供器或自定义整合包设置配合使用。

我可以将 OS4 添加到现有世界中吗？

可以，但新设置通常只会在新生成的区块中生效。矿石回填生成仅适用于明确允许该功能的规则，而岩层永远不会进行回填生成。请先备份世界。

OreSpawn 会自动移除重复的原版矿石吗？

只有在 OreSpawn 报告接管已激活后，提供方模组才应停用其原生生成器。整合包作者应在最终整合包中验证每个负责矿石生成的模组的行为，而不要想当然地认为所有原生生成器都会被自动抑制。

我应该在哪里报告问题？

对于可复现的错误，请使用问题追踪器；如需讨论和寻求帮助，请前往MMD Discord。请附上 Minecraft、Forge、OreSpawn 以及提供方模组的版本，并提供相关日志和世界配置。

致谢与链接

MMD OreSpawn 由 Minecraft Mod Development 社区维护，并依据 GNU Lesser General Public License 2.1 版授权。

MMD OreSpawn

介绍