适用于 Minecraft 1.12.2, 26.3 的 MMD OreSpawn 模组

重要提示：请确认您要找的是哪个 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 旧版指南

使用上方的 Files 标签选择与您的 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 范围
• 每区块尝试次数
• 固定或范围的方块数量
• 均匀、中心峰值或深层偏置的高度分布
• 母岩方块、母岩标签和配置的岩石族
• 包含或排除的生物群系和地质域
• 加权输出方块和加权母岩
• 洞穴壁上可能保留多少可见矿石
• 该规则是否参与矿石追溯生成

内置矿床模式包括：

模式 结果

Compact 密集、连通的矿床

Vein 蜿蜒的矿化路径

Normal cloud 广阔、弥散的矿床

Precision 确定性的密集填充

Clusters 若干个邻近的连通节点

Under fluids 放置在所选流体下方的矿床

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

地下流体矿床

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

深度、频率、半径、垂直形状、瓣叶、母岩材料、固体顶盖、固体外壳、生物群系和地质域偏好可以分别配置。这些是有意的地下矿床，而不是暴露的原版湖泊。

生物群系和世界材料

OS4 可以将提供方生物群系添加到现有生物群系源，或在适当的情况下提供完全由提供方控制的样式。

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

维度、模板和原版特性

规则可以通过注册表 ID 针对主世界、下界、末地或已安装的自定义维度。命名模板可以为玩家或整合包描述完整的可选世界样式。

OreSpawn 还可以在有意启用这些选项时管理已声明的原版矿石特性和压平基岩。除非所选配置要求，否则两者均处于关闭状态。

使用 OreSpawn 的方式

与内容模组一起安装

这是正常的玩家体验。

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

当某个模组将 OreSpawn 列为必需依赖项时，请在客户端和服务器上安装匹配的 OreSpawn 构建。

自行配置世界

OreSpawn 也可以在没有完整地质内容模组的情况下使用。

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

构建整合包

整合包作者可以：

• 调整提供方规则而无需编辑模组 jar
• 协调来自多个兼容模组的矿石放置
• 选择每条规则可以使用的维度和母岩材料
• 选择或创建完整的世界模板
• 在整合包需要单一事实来源时管理原版矿石
• 发布会复制到每个新世界的全局默认值
• 使用服务器命令检查提供方状态和活动配置

在发布整合包之前，使用完整模组列表测试最终配置。缺失的方块、已移除的提供方和冲突的原生生成器在全新的测试世界中比在玩家已有的存档中更容易发现。

集成其他模组

大多数集成可以通过打包在以下位置的提供方文件来描述：

data/<modid>/orespawn/provider.json

提供方可以只贡献矿石，也可以贡献岩石、地质域、流体矿床、生物群系调色板、维度材料、地形维度和模板。需要程序化构建的模组可以使用受支持的 zone.moddev.mc.orespawn.api Java API。

OreSpawn 是普通的必需依赖项。不要将其引擎遮蔽或复制到另一个模组中。

创建世界

对于正常的 OS4 设置：

• 在客户端和服务器上安装匹配的 Forge 版 OreSpawn 及其提供方模组。
• 在创建世界时打开 OreSpawn World Generation。
• 为已安装的提供方选择 Recommended Defaults。
• 如果您想自定义设置，请在创建世界前调整地质、岩石、矿石、矿床、生物群系或世界材料。
• 当某项设置不熟悉时，使用 Help & Guide 或控件工具提示。
• 按 Done 并正常创建世界。

当没有任何内容选择启用时，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 复制到新创建世界的默认值

&lt;world&gt;/serverconfig/orespawn-worldgen.json 属于一个世界的最终配置