Kzeroko KTM2

自然生成运行时

服务端生成选择、原版集成边界与普通史莱姆战斗约定。

更新于 2026/11/16 9 分钟阅读

internal.spawning 管理服务端数据与生成候选池组合,internal.slime 管理普通史莱姆战斗;两个包都不是公开门面。玩法见自然生成,数据包格式见自然生成数据。

它做什么

NaturalSpawnHelperMixin 修改自然生成候选池返回值、采样高度与新区块动物概率。NaturalSpawnCadenceMixin 修改 ServerChunkManager.tickChunks 的动物间隔除数。原版调度、种群计数、生成限制、碰撞检查和成功生成回调仍然运行。

条目规则只影响运行中的自然生成。区块生成阶段的条目仍由群系提供,生成线程不会查询实时实体密度;该阶段只从不可变设置快照读取有上限的填充概率。系统不复制或替换地形、群系生成或 Reterraforged 的实现。

运行时模型

NaturalSpawnLoader 为每个定义 ID 读取最高优先级资源,验证全部文件后一次发布不可变快照。语法或语义错误会在发布前抛出,原快照继续有效。定义先按优先级、再按标识符排序,并按维度与生成分组建立索引。定义查询读取该索引。和平结构范围另有按区块保存的元数据缓存。

对每个有效的实时生成位置,SpawnBoundary 取到最近和平结构、Atelier 地标或适用庭院矩形的水平距离,在 32 格内用平滑曲线将倍率从 0 提至 1。选中的遭遇只判定一次边缘、基础通过率及击杀恢复倍率。成员验证不再重复抽取概率;统计已加载的存活怪物,达到向上取整后的局部上限便结束查询,并计入已经安排但尚未加入世界的同伴。

同一条目在候选池查询间保持对象身份。原版会在群体成员的最终位置再次验证池成员资格,群系、时间或光照改变时可以拒绝该成员。局部密度检查位于原版候选验证之后,只查询有限盒状范围内的已加载实体,达到上限便停止。只统计同属地表或洞穴环境的匹配类型或密度标签成员,包括持久化生物。

EncounterPlacement通过原版距离、类型、实例和密度检查预先安排成员,不足最小队伍便全部放弃。成功成员共享初始化数据,并执行正常生成计数回调。EncounterMemory保存按规则区分的安静单元。HabitatBudget在原版已有计数遍历中统计合格怪物,划分原有名额,并立即计入成功生成的成员。HostilePressureState只保存独立的Surface与Caves列表,不读取已退役的共享Cells列表。

FantasySlimeMixin仅作用于EntityType.SLIME;岩浆怪与其他史莱姆子类保留原有目标和机制。SlimeHuntGoal驱动服务端状态机与原版寻路,SlimeHopControl以离散跳跃跟随路径节点。SlimeCombat管理蓄力、锁定后的飞行、单次命中限制及停顿。目标效果暂停会打断控制器,友好阵营关系会阻止直接伤害与弹体伤害。

SlimeTier按体型组织属性、移动、扑击、远程和特殊攻击参数。SlimeAttackPlanner管理独立冷却和距离条件,不访问世界。满足条件的特殊攻击优先于普通攻击,两者同时就绪时交替优先使用。小型和中型史莱姆在远程冷却期间继续追击;大型史莱姆会在目标可见、处于射程内且超出扑击距离时保持原位。视线受阻或目标离开这个区间后,寻路恢复。

SlimeTrajectory按照原版投掷实体在空气中的递推顺序求解有界拦截弹道:先移动,再应用阻力,最后应用重力。SlimeCombat在服务端采样目标位置变化,平滑水平运动,并排除瞬移幅度的样本。发射时才确定有上限的提前量,弹体不会追踪。扑击在预警即将结束时锁定目的地,按距离计算起跳速度,向高处扑击时增加向上的速度。跳跃施加速度后会先将实体标记为腾空,再由原版移动计算阻力,避免首个tick的地面阻力缩短跳跃距离。

阶段及其开始时的世界 tick 会同步到客户端。SlimeTelegraphRendererMixin 按各体型实际的预警和停顿时长,在现有渲染器上追加压缩与拉伸,不修改玩法状态。战斗计时不保存,实体重新加载时战斗控制器从空闲开始。体型和原版属性仍按实体的常规方式持久化。

约定

加载时将规则级spawn_chance解析到每个新增条目,条目明确填写的值会覆盖默认值。NaturalSpawnHelperMixin只拦截实时spawnEntitiesInChunk中的pickRandomSpawnEntry,由NaturalSpawning.encounter在原版抽取群体数量之前判定一次。空结果沿原版分支结束当前遭遇,不立即选择替代条目;后续成员复用已选条目,不再判定概率。空选择、概率0和概率1均不额外消耗随机数。候选池组合、成员资格检查和检查命令都不抽取概率;未配置的群系或结构条目按概率1直接通过。

边界约定
上限与尝试不安装独立调度器、上限加成、区块票据或消失规则覆盖。成组遭遇在选中的原版尝试内执行有限次数的位置搜索。
候选池归属只有返回池与当前位置群系的池为同一对象时才组合规则。结构专用池和外部替换池直接保留。
组合方式Merge 修改指定类型;replace 清空群系池。两者均不绕过实体生成限制。
区块生成概率覆盖值最高为 0.35。新区块条目与生成否决仍由原版和已有钩子管理。
保护区域已有地下城与地标规则继续注册。庭院还会禁止占地下方怪物分组的自然生成;下方其他分组仍可生成。
体型与碰撞指定体型在史莱姆创建后、原版实例碰撞验证前设置;初始化保留这一体型。
死亡普通史莱姆跳过分裂,但仍执行正常移除。原版史莱姆战利品表替换为有上限的直接掉落。
弹体服务端碰撞决定伤害与腐蚀;黏液弹有存活时限、不破坏方块、不持久化。
伤害属性扑击和冲击波在命中时读取GENERIC_ATTACK_DAMAGE;黏液弹在发射时记录该属性,再乘以对应攻击的系数。攻击没有固定伤害回退值。
移动属性移动跳跃读取GENERIC_MOVEMENT_SPEED,已启动的扑击使用对应体型的有界轨迹。
兼容性返回值组合保留上游候选池结果。其他模组若同时替换史莱姆目标或静态生成条件,仍需集成验证。

原型战斗参数位于 SlimeTier。自然生成定义配置遭遇、群体数量与史莱姆体型,不配置战斗时长。系统只有当前一种格式,没有字段别名或迁移读取器。

庭院规则在创建生物前读取缓存边界,并在服务端世界或区块生成区域接纳实体时再次检查已记录的自然生成来源,不额外加载区块或扫描实体。具体范围与例外见遥空庭院运行机制。

扩展

NaturalSpawning.prepareMob 为 IsekaiCombatMob 安装可选群体配置,实体的 initialize 通过原版群体 EntityData 传递 MobGroup.SpawnData,共享群体身份和初始领队。群体状态保存在实体上,每 40–46 ticks(2–2.3 秒)最多查询 16 个附近已加载成员。Brain 任务负责跟随与共享可见威胁,带到期时间的动作预留限制同时攻击者,无需静态世界注册表。新物种可以覆盖移动方式并添加 Brain 任务,共享动作程序不依赖身体结构。

通过 data/<namespace>/natural_spawning/*.json 添加规则,用群系标签定义栖息地。自定义配色 ID 可以直接加入标签,无需修改 Java。新增环境条件应集中放在 SpawnConditions,验证范围两端,并在开放字段前补上边界测试。

新增史莱姆攻击需要在SlimeAttackPlanner中定义触发条件和冷却,并在SlimeCombat中添加预警和停顿转移。局部伤害检查只在服务端执行,表现通过同步的阶段数据传递。调整数值或掉落时同步维护史莱姆玩法约定。

验证

先运行./gradlew.bat compileJava和语言组装,再到测试世界检查自然生成与史莱姆战斗。

在服务端测试世界中比较新探索与已探索的平原、茂盛高空配色以及繁茂洞穴。在数量未满和已满时检查 /ise ecology inspect creature,用无效定义测试 /reload,并覆盖昼夜、和平难度、关闭生物生成、地下城世界及受保护聚落。确认水生生物仍需满足自身流体生成限制。

战斗测试需覆盖各体型、移动玩家、盾牌、墙壁、斜坡、水域和跳跃目标。验证单次扑击命中、短暂停顿、炮台射程、酸液与冲击波反复施放、死亡不分裂、直接掉落,以及格挡后没有额外酸液耐久损耗。修改攻击伤害属性,确认扑击、两种弹体和冲击波都随之变化。还应在蓄力期间重连、施加暂停 AI 的状态、测试友好阵营,并单独检查岩浆怪。专用服务端启动、多人表现及玩法平衡需要可正常运行的完整模组包验证。

相关页面

自然生成数据、史莱姆、地形生成与 Atelier 结构说明相邻数据和保护约定。