自然生成数据
配置生成分组、环境条件、群体数量与局部密度限制。
自然生成定义控制服务端遭遇选择及有边界的分组间隔。Minecraft 的数量上限与实体限制仍然生效,增加权重并不保证生成成功。
文件放在哪里
使用 data/<namespace>/natural_spawning/*.json,支持子目录。每个文件定义一个分组设置、条目规则或敌对生成压力配置,相对资源路径就是 ID;相同 ID 由最高优先级数据包覆盖。不同定义按优先级升序,再按 ID 字典序执行。最后匹配的 group 定义提供整组设置,不从之前的定义逐字段继承。
规则修改运行中的自然生成。新区块动物填充保留群系条目,只读取 group 设置中的 generation_probability。动物默认配置面向 minecraft:overworld,压力默认配置还覆盖 minecraft:the_nether 与 minecraft:the_end;每个定义都必须明确列出世界。
最小示例
{
"kind": "group",
"group": "creature",
"dimensions": ["minecraft:overworld"]
}
这个有效的 group 定义继承间隔和填充概率,也不改变高度采样。随包动物文件在这一结构上填写了明确设置。
字段
| 字段 | 类型 | 默认值 | 说明 |
|---|---|---|---|
kind | enum(group, rule, pressure) | 必填 | 选择间隔与采样设置,或候选条目规则。 |
group | string | 必填 | 可选 monster、creature、ambient、axolotls、underground_water_creature、water_creature、water_ambient。 |
dimensions | array<identifier> | 必填 | 非空世界 ID 列表,最多 128 项;重复 ID 去重。这里使用维度 ID,不是维度类型 ID。 |
priority | integer | 0 | 范围 −1000–1000,数值较大的后执行;同值按定义 ID 排序。 |
interval_ticks | integer | -1 (继承) | 仅用于 group 的 creature 分组。填写时为 20–24000 ticks(1–1200 秒),调整运行中的动物尝试间隔;不填则继承。 |
surface_chance | number | 0 | 仅用于 group。现有尝试中改在最上方非树叶阻挡地表采样的比例,范围 0–1;仅 creature 或 monster 可填写非零值。 |
surface_budget | number | omitted | 仅用于 group 的 monster 分组;填写时为 0.1–0.9,将原有全局怪物名额的这一比例预留给地表,其余预留给洞穴。 |
generation_probability | number | -1 (继承) | 仅用于 group 的 creature 分组。填写时范围为 0–0.35,覆盖新区块种群填充概率,不替换该阶段条目。 |
conditions | object | {} | 用于 rule 或 pressure,全部条件通过后定义才生效;字段见共用条件表。 |
spawn_chance | number | 1 | 仅用于rule,作为该规则新增条目的默认通过概率,范围0–1。选中遭遇后只判定一次;失败便跳过本组,不重新选择。不会控制移除、替换或已有群系条目。 |
mode | enum(merge, replace) | merge | 仅用于 rule。merge 保留未指定的条目,replace 清空原群系池;两者均保留结构专用和外部替换池。 |
remove | array<entity id> | [] | 仅用于 rule。添加条目前先移除指定已注册实体类型的全部条目,最多 128 个 ID。 |
encounter | object | omitted | 仅用于 rule。在选中的尝试内预先安排可行队伍;省略则保留原版放置方式。 |
encounter.radius | integer | 6 | 水平搜索半径,2–16 格。地表成员使用高度图,洞穴成员上下搜索 2 格。 |
encounter.attempts | integer | 32 | 每次遭遇最多尝试 8–64 个位置;有效成员不足 entries[].min 时取消整组。 |
encounter.cooldown_ticks | integer | 2400 | 成功后持久化的安静期,20–240000 ticks(1–12000 秒);默认 120 秒。 |
encounter.cooldown_radius | integer | 64 | 安静区域半径,16–128 格,向上取整至 16 格单元。覆盖所在区段及上下各一区段;按规则 ID 分开记录。 |
entries | array<object> | [] | 仅用于 rule,最多 64 项。replace 配合空列表会在条件匹配的位置主动禁用此群系池。 |
entries[].entity | entity id | 必填 | 已注册实体,生成分组必须与规则一致;实体自身的生成限制仍然生效。 |
entries[].weight | integer | 1 | 相对选择权重,范围 1–1000;不是百分比,也不保证生成率。 |
entries[].spawn_chance | number | 规则的spawn_chance | 覆盖规则默认值,范围0–1,两者不相乘。0始终跳过选中的遭遇,1不增加概率检查;其他生成限制仍生效。 |
entries[].min | integer | 1 | 请求的最小群体数量,范围 0–8。min 至 max 之间的整数等概率抽取;抽到 0 时跳过本组生成。原版实体群体限制仍生效。 |
entries[].max | integer | min | 请求的最大数量,范围 0–8,且不小于 min。min 为 0、max 为 1 时,选中该条目后有一半概率跳过本组;两者均为 0 时始终跳过。启用 encounter 时必须容纳最小队伍;否则原版放置失败仍可能使实际群体更小。 |
entries[].slime_size | integer | 0 (实体默认) | 填写时仅接受 1、2、4,且只能用于 minecraft:slime;自然生成加入世界前会以指定体型检查碰撞。不填使用实体默认行为。 |
entries[].local_limit | integer | 0 (关闭) | 填写时为局部盒状范围内同一地表或洞穴环境中的匹配存活实体上限,范围 1–64;所有体型和持久化生物都计入。不填则关闭额外上限。 |
entries[].local_radius | integer | 32 | 候选方块盒体沿水平 X/Z 轴的扩展距离,8–64 格;配合 local_limit 使用。 |
entries[].local_vertical_radius | integer | 16 | 盒体向上及向下扩展的距离,1–64 格;配合 local_limit 使用。 |
entries[].density_tag | entity type tag id | omitted | 合计此实体类型标签中存活的成员,包括持久化生物;只统计同属地表或洞穴的个体。省略时按本实体类型计数,未解析的标签没有成员。 |
entries[].conditions | object | {} | 附加条目条件,与规则条件使用相同字段;不会放宽规则或实体限制。 |
entries[].group | object | omitted | 让支持此功能的异界怪物在本次自然生成群体中共享持久身份;省略时各自行动。其他实体类型忽略此对象。 |
entries[].group.cohesion_radius | number | 6 | 超出此距离后跟随已加载的领队,范围 2–32 格。 |
entries[].group.assist_radius | number | 20 | 搜索已加载同伴和共享可见威胁的最大范围,cohesion_radius–48 格。 |
entries[].group.max_attackers | integer | 2 | 群体同时预留动作的成员数,范围 1–8;预留会到期,并在动作取消时释放。 |
群体身份随实体保存。领队消失时,附近已加载的成员重新选出领队,不会加载区块。群体行为不绕过种群上限。成组放置在一次已有调度尝试内,按独立的位置尝试预算执行。六种哥布林均使用 rules/goblins.json 配置地表巡逻队,使用 rules/cave_goblins.json 配置洞穴群体。
地表栖息地标签在 #isekaiexpansion:pasture_animals 的基础上加入沼泽、红树林沼泽、风袭森林和稀疏丛林。洞穴标签包含这些群系,并加入繁茂洞穴、溶洞及可选的世界根之窟(isekaiexpansion:worldroot_hollow_ancient)。两条规则均要求方块光照不高于 7。地表巡逻队要求原始天空光照至少为 1,白天也可生成;洞穴群体通过 habitat: cave 要求天空光照为零,因此同一位置不会重复加入两套哥布林条目。常见近战变体的权重最高,全部变体每组均请求 3–5 只。每个生成群体只请求一种装备变体;附近兼容的巡逻队可以组成同一群体,但不保证每支队伍都有混合兵种。
敌对生成压力
使用 kind: pressure 与 group: monster。沿用优先级及 ID 排序,最后匹配的配置整组生效。条件可按群系 ID、标签、高度及下方列出的其他环境字段选择区域。玩家、有效随从、驯养伙伴或绑定召唤物击败自然生成的敌对生物,才计入一次击杀贡献。刷怪笼、召唤、命令生成及环境死亡均不计入。
进度由同维度的玩家共享,按地表与洞穴两套独立的 16 × 16 × 16 格单元存档。每次击杀影响死亡位置周围的方形区块范围与配置的垂直区段,不加载这些区块。达到击杀预算后,击杀抑制倍率降至 minimum_chance。每次有效击杀重置安静计时,之后按恢复周期线性消退整份抑制值,因此未完全清剿的区域恢复得更早。已有敌人保留。倍率在每次选中的自然遭遇中只判定一次,包括结构专用自然生成池,不拦截脚本遭遇。
| 字段 | 类型 | 默认值 | 说明 |
|---|---|---|---|
base_chance | number | 0.35 | 每次选中怪物遭遇的基础通过率,范围 0–1,再乘击杀抑制和边缘倍率。 |
local_limit | integer | 5 | 接纳新怪物时使用的局部数量上限,范围 0–64。设为零可关闭怪物自然生成。 |
local_radius | integer | 48 | 候选方块包围盒沿 X、Z 轴各向两侧扩展的距离,范围 8–64 格。 |
local_vertical_radius | integer | 16 | 包围盒向上及向下扩展的距离,范围 1–64 格。 |
kills_to_clear | integer | 16 | 恢复前累计这些有效击杀后达到完整抑制;范围 1–10000。 |
radius_chunks | integer | 2 | 水平单元半径,范围 0–8 个区块;默认影响 5 × 5 个区块。 |
vertical_radius_sections | integer | 1 | 垂直单元半径,范围 0–8 个 16 格区段;默认覆盖 3 段。 |
quiet_ticks | integer | 12000 | 击杀后开始恢复前的等待,范围 0–2400000 ticks(0–120000 秒);默认 600 秒。 |
recovery_ticks | integer | 24000 | 安静期结束后消退完整抑制所需时间,范围 20–2400000 ticks(1–120000 秒);默认 1200 秒。 |
minimum_chance | number | 0 | 完整抑制时剩余的自然生成倍率,范围 0–1;零完全停止补充,一表示不抑制。 |
随包普通主世界配置为 12 次击杀、12000 ticks 安静期(600 秒)及 24000 ticks 恢复期(1200 秒)。黑森林、沼泽、红树林沼泽与深暗之域使用 18 次击杀、6000 ticks 安静期(300 秒)及 18000 ticks 恢复期(900 秒)。下界使用 32 次击杀、2400 ticks 安静期(120 秒)及 12000 ticks 恢复期(600 秒)。末地使用 24 次击杀、6000 ticks 安静期(300 秒)及 18000 ticks 恢复期(900 秒)。最低生成倍率均为零。
普通主世界、危险主世界群系、下界、末地的基础通过率依次为 35%、55%、75%、65%,局部上限依次为 8、10、10、8。群体中的每个候选位置都统计周围已加载范围内怪物分组的存活生物,只计同属地表或洞穴的个体,也包括其他来源的怪物。离最近禁生区边缘越近,概率和上限越低,32 格外恢复全值,缩放后的上限向上取整。怪物移动或指定生成可使实际数量超过此上限。
要调整主世界的普通地区,可以从随包配置开始:
{
"kind": "pressure",
"group": "monster",
"dimensions": [
"minecraft:overworld"
],
"priority": -100,
"kills_to_clear": 12,
"radius_chunks": 2,
"vertical_radius_sections": 1,
"quiet_ticks": 12000,
"recovery_ticks": 24000,
"minimum_chance": 0,
"base_chance": 0.35,
"local_limit": 8,
"local_radius": 48,
"local_vertical_radius": 16
}
计时依据游戏刻,睡觉或更改昼夜不推进恢复,服务器离线期间也不恢复。成功重载后立即重新选择配置;已存单元保留上次有效击杀确定的恢复计划,直到下一次击杀更新。每 1200 ticks(60 秒)清理已恢复单元,每个维度的每种环境最多保存 65536 个有效单元。达到上限后继续更新已有单元,腾出空间前不再为新单元累积贡献。
共用条件
以下字段同时适用于 conditions 与 entries[].conditions,所有检查都需通过。cave 条件也会匹配有遮蔽的房间,并非地质洞穴识别器。原始天空光不表示昼夜,需要通过有效亮度或时段区分。
| 字段 | 类型 | 默认值 | 说明 |
|---|---|---|---|
conditions.biomes | array<string> | [] | 匹配任一群系 ID 或 #namespace:tag 即可,空列表接受所有群系;最多 128 项。 |
conditions.excluded_biomes | array<string> | [] | 匹配任一 ID 或标签便拒绝,即使同时命中包含列表;最多 128 项。 |
conditions.habitat | enum(any, surface, cave, water, lava) | any | surface:脚下位置无流体,且达到或高于最上方非树叶阻挡高度。cave:脚下无流体,原始天空光为零,也包括遮蔽房间。water/lava:脚下流体符合相应标签。 |
conditions.min_y | integer | -2032 | 最低方块 Y,范围 −2032–2031。 |
conditions.max_y | integer | 2031 | 最高方块 Y,范围 −2032–2031,不小于 min_y。 |
conditions.min_light | integer | 0 | 最低有效亮度,范围 0–15,计入环境暗度。 |
conditions.max_light | integer | 15 | 最高有效亮度,范围 0–15,不小于 min_light。 |
conditions.min_sky_light | integer | 0 | 最低原始天空光,范围 0–15。 |
conditions.max_sky_light | integer | 15 | 最高原始天空光,范围 0–15,不小于 min_sky_light。 |
conditions.min_block_light | integer | 0 | 最低方块光,范围 0–15。 |
conditions.max_block_light | integer | 15 | 最高方块光,范围 0–15,不小于 min_block_light。 |
conditions.time_start | integer | 0 | 起始时刻(含),范围 0–23999 ticks;一天为 24000 ticks(1200 秒)。起始值大于结束值时跨越午夜。 |
conditions.time_end | integer | 23999 | 结束时刻(含),范围 0–23999 ticks。两端相等时每天仅匹配一个 tick。 |
conditions.ground_tag | identifier | "" | 候选位置正下方方块的标签 ID,不带 #;空字符串关闭该检查。 |
完整示例
随包洞穴规则只在标签指定的黑暗洞穴栖息地中添加按体型加权的史莱姆,并在移除原群系史莱姆条目的随包规则之后执行。
地表和洞穴规则均使用spawn_chance: 0.60:选中的史莱姆遭遇有60%继续,40%在后续检查前跳过。实际存活数量仍受上限和可用位置影响,不保证同比减少。权重与群体数量仍独立配置;即使通过概率检查,群体数量抽到零时也会跳过。
{
"kind": "rule",
"group": "monster",
"spawn_chance": 0.60,
"dimensions": [
"minecraft:overworld"
],
"priority": 10,
"conditions": {
"biomes": [
"#isekaiexpansion:cave_slime_habitats"
],
"habitat": "cave",
"max_light": 7
},
"entries": [
{
"entity": "minecraft:slime",
"weight": 10,
"slime_size": 1,
"local_limit": 4,
"local_radius": 48
},
{
"entity": "minecraft:slime",
"weight": 4,
"slime_size": 2,
"local_limit": 4,
"local_radius": 48
},
{
"entity": "minecraft:slime",
"weight": 2,
"slime_size": 4,
"local_limit": 4,
"local_radius": 48
}
]
}
校验
缺少必填字段、未知字段、错误 JSON 类型、非有限数值、整数位置填写小数、无效标识符、未知实体、条目实体分组不符或超出范围,都会拒绝整个自然生成重载。空文件无效,空条目列表的规则有效。最多接受 256 个定义资源,不读取旧字段名或别名。
群系与方块标签在查询时对照当前世界解析。语法合法但不存在的群系或标签不匹配任何内容;不存在的维度不会收到尝试。同一实体的多条条目分别参与加权,除非后续规则移除该类型。后执行的 merge 规则可以在 replace 规则之后继续添加条目。
各项限制共同生效:水生条目仍需满足水生实体的生成条件,需要黑暗的敌对生物不会因为 max_light 允许高亮度就能白天生成。普通史莱姆使用重新设计的生成条件。局部上限只查询已加载实体,不加载区块,也不删除已有生物。结构专用池及外部替换池原样保留。
重载
服务端在资源重载及 /reload 时读取定义,全部验证后替换快照。客户端不选择条目,也不会收到该规则数据库。删除定义后,其效果会在下次成功重载时移除,已有实体保持原状态。无效定义会保留之前的自然生成快照,但不保证回滚其他模组的重载监听器。
拥有权限等级 2 后,可用 /ise ecology inspect creature 或 /ise ecology inspect monster 查看当前规则和上限。群系标签通过数据包的常规标签重载生效。
每个条目会显示实际生效的spawn-chance;检查命令与候选池查询都不抽取概率。