你的模组规则¶
感知的“物理”规则(雨、材质、黑暗、伪装……)都有逼真的默认值,但每个模组都可以拥有自己的规则。
模组之间不会冲突
规则在感知者一侧生效:同一个声音,你的模组的生物按你的规则来听, 另一个模组的生物按它们自己的规则来听。没有人会修改全局规则。
创建你的规则¶
public static final SentienceRules RULES = SentienceRules.create("mymod")
.hearing(h -> h
.ignoreRain()
.muffled(25f)
.addAmbientSource((world, pos) -> isBlizzard(world, pos) ? 55f : Float.NaN)
.addNoiseModifier((event, db) -> isMyMachine(event.soundId()) ? Float.NaN : db))
.sight(s -> s
.sneak(0.3f)
.addStealthModifier((observer, target) -> wearsCamo(target) ? 0.2f : 1f))
.scent(s -> s.ignoreRain().lifetime(6000).blood(3f))
.build();
Agent.builder(this).rules(RULES)...build();
如果不调用 .rules(...),智能体会使用 SentienceRules.DEFAULT,它永远不会改变。
变体¶
可以为特定生物派生一套规则:
public static final SentienceRules BOSS_RULES = RULES.derive(Identifier.of("mymod", "boss"))
.sight(s -> s.invisibility(1f)) // 能看见隐身的玩家
.build();
听觉¶
| 设置 | 默认值 | 方法 |
|---|---|---|
| 空气吸收 | 0.35 dB/格 | airAbsorption(db) |
| 最大遮挡 | 60 dB | maxOcclusion(db) |
| 失聪阈值 | 85 dB | deafening(db) |
| 背景噪音 洞穴 / 地表 / 雨 / 雷暴 | 12 / 18 / 42 / 50 dB | ambient(...)、ignoreRain() |
| 流水 / 岩浆 | 38 / 30 dB | fluidAmbient(water, lava) |
| 羊毛、地毯 | 18 dB | muffled(db) |
| 关闭 / 打开的门 | 7 / 0.5 dB | doors(closed, open) |
| 树叶 | 1.5 dB | leaves(db) |
| 实心方块 | 9 + 硬度 × 0.2(不可破坏 25) | solids(base, factor, unbreakable) |
| 薄方块(玻璃、台阶……) | 3.5 dB | thinSolids(db) |
| 穿过的水 / 岩浆 | 4 / 6 dB | fluids(water, lava) |
扩展点:
addNoiseModifier((event, db) -> newDb)——修改声音的强度,或返回Float.NaN忽略它。event.soundId()提供原始的 Minecraft 声音(例如minecraft:block.wool.step)。addBlockAcoustics((world, pos, state) -> 分贝或 null)——方块的衰减值,优先于内置规则。addAmbientSource((world, pos) -> 分贝或 Float.NaN)——额外的背景噪音。
视觉¶
| 设置 | 默认值 | 方法 |
|---|---|---|
| 完全黑暗中的可见度 | 0.05 | darknessFloor(v) |
| 周边视觉 | ×0.3 | peripheral(f) |
| 潜行 | ×0.5 | sneak(f) |
| 隐身 | ×0.08 | invisibility(f) |
| 移动 | ×1.3 | movement(f) |
| 手持火把 / 着火 / 发光效果会暴露 | 是 | lightInHandReveals、fireReveals、glowingReveals |
| 立即发现 | < 2.5 格 | instantDetection(distance) |
| 可透视的方块 | 玻璃、玻璃板、铁栏杆 | seeThrough(predicate) |
扩展点: addStealthModifier((observer, target) -> 系数)——伪装、斗篷、涂料……
嗅觉¶
| 设置 | 默认值 | 方法 |
|---|---|---|
| 气味持续时间 | 2400 tick(最大 12000) | lifetime(ticks) |
| 雨的影响 | 持续时间 ×0.5 | rainLifetime(f)、ignoreRain() |
| 水会切断踪迹 | 是 | waterBreaksTrail(bool) |
| 潜行时的气味 | ×1 | sneakStrength(f) |
| 血迹吸引力 | ×1 | blood(f) |
| 气味可穿过的墙 | 1 个实心方块 | maxWallBlocks(n)(-1 = 无限) |
扩展点: addPointModifier((agent, point) -> 系数)——除味药水、偏好的猎物……