查看“JSON模组教程-状态效果、特效、音效”的源代码

<span id="状态效果特效音效"></span>
= 状态效果、特效、音效 =

这一节把“战斗表现”拆成三层：状态效果负责数值变化，特效负责视觉反馈，音效负责声音反馈。JSON 能完成绝大多数“表层表现”，但涉及反应联动与复杂行为时仍需要 Java 支持。

<span id="状态效果statuseffect"></span>
== 状态效果（StatusEffect） ==

状态效果是持续作用在单位上的“数值修饰器”。它常常来自子弹、液体、天气或地板。例如子弹可以设置 <code>status</code> 与 <code>statusDuration</code>，液体可以设置 <code>effect</code> 和 <code>status</code>，天气可以定期施加某种状态。理解状态效果的关键是时间单位：Mindustry 以“刻”为单位，<code>1 秒 = 60 刻</code>。因此 <code>damage = 0.1</code> 并不是每秒 0.1 伤害，而是每刻 0.1，折算成每秒约 6 点伤害。

<code>damageMultiplier</code>、<code>healthMultiplier</code>、<code>speedMultiplier</code>、<code>reloadMultiplier</code>、<code>buildSpeedMultiplier</code> 等倍率类字段会直接影响单位的基础数值。<code>speedMultiplier</code> 影响移动速度，<code>reloadMultiplier</code> 影响射速，<code>buildSpeedMultiplier</code> 影响建造与修复速度。<code>damageMultiplier</code> 与 <code>healthMultiplier</code> 会改变单位的输出与血量，但不会改变当前血量的绝对值，只影响“计算时的倍率”。

还有一些更容易被忽略的字段：<code>dragMultiplier</code> 会影响转向和刹车感，适合做“粘滞”或“漂移”类状态；<code>damage</code> 可以为负值，表示持续治疗，这在支援类状态里非常常见；<code>parentizeEffect</code> 与 <code>parentizeApplyEffect</code> 可以让特效跟随单位移动，适合让状态效果“贴身”表现；<code>show</code> 与 <code>outline</code> 则影响数据库是否显示以及图标描边，用于隐藏内部状态或做视觉区分。

如果你需要“间歇式伤害”，可以用 <code>intervalDamage</code> 与 <code>intervalDamageTime</code>。前者是每次间隔造成的伤害，后者是间隔刻数。<code>intervalDamagePierce</code> 设为 <code>true</code> 时会无视护甲。与之对应，<code>damage</code> 是“每刻伤害”，适合持续灼烧与毒素。<code>disarm</code> 会禁用武器，<code>applyExtend</code> 控制“重复施加时是否再次触发 applyEffect”，<code>permanent</code> 则让状态不会自然消失。

状态叠加的逻辑也需要注意：同一种状态再次施加时，持续时间取更长的那一个，不会简单叠加伤害；不同状态之间会先检查反应逻辑，若存在反应则可能触发过渡效果并结束此次施加。<code>reactive</code> 设为 <code>true</code> 的状态本身不会直接施加，它更像“只用于反应”的占位状态。<code>transitionDamage</code> 则用于反应时的附加伤害，但它需要配合 Java 里的 <code>affinity</code>/<code>opposite</code>/<code>trans</code> 才能生效。

视觉层面的字段包括 <code>color</code>（状态染色）、<code>effect</code>（持续特效）、<code>effectChance</code>（持续特效出现概率）、<code>applyEffect</code>（施加瞬间特效）、<code>applyColor</code>（施加特效颜色）、<code>outline</code>（图标描边）与 <code>show</code>（是否在数据库显示）。这些字段决定玩家“看见的状态”，但不改变数值逻辑。

<code>effect</code> 与 <code>applyEffect</code> 的差别很容易被忽略：前者是“持续随机触发”，后者是“施加瞬间触发”。如果你希望玩家每次命中都能感知状态，应该用 <code>applyEffect</code> 或把 <code>effectChance</code> 调高；如果你只想让状态有“淡淡的存在感”，则保持低概率即可。<code>applyExtend</code> 设为 <code>true</code> 时，重复施加也会再次触发 <code>applyEffect</code>，但这会带来更多特效开销，最好结合性能考虑。

'''文件：content/statuses/tutorial-slow.json'''

<pre>{
    "name": "示例迟缓",
    "description": "让单位减速并轻微受伤。",
    "color": "7db6ff",
    "speedMultiplier": 0.7,
    "damage": 0.02,
    "effect": "wet"
}
</pre>
这个例子把速度降到 0.7，并附加少量持续伤害。<code>effect</code> 引用了原版 <code>Fx.wet</code>，因此会出现“潮湿”的粒子表现。

如果你把 <code>damage</code> 设成负值，它会变成持续治疗效果，而不是伤害。这种状态很适合配合支援单位或建筑，让它们在特定区域提供“微量修复”。配合 <code>reloadMultiplier</code> 或 <code>buildSpeedMultiplier</code>，还能做出“修复 + 加速”的复合增益。

状态颜色也值得斟酌。<code>color</code> 不仅影响状态图标，还会作为 <code>effect</code> 的默认颜色参与渲染。如果你用了透明度较低的颜色，粒子会显得很淡；反之则可能“盖过”其他特效。调色时可以先用原版颜色作参照，再微调饱和度与透明度。

需要注意的是，JSON 里写 <code>affinities</code> 或 <code>opposites</code> 只会影响数据库展示，并不会触发真正的反应逻辑。原版的“潮湿 + 电击”之类的连锁效果是在 Java 里通过 <code>affinity</code>/<code>opposite</code>/<code>trans</code> 注册的，JSON 无法配置这部分，所以仍需代码支持。（注：笔者已经提交了相关的代码，正在等候 Anuke 合并）

== 状态的来源与扩散 ==

状态效果并不只来自子弹。液体在地面形成水洼时可以施加状态，天气可以周期性施加状态，某些地板也会在单位经过时附加状态。这意味着你在设计状态时，不仅要考虑“命中时的效果”，还要考虑它被环境广泛传播后的影响。例如一个过于强力的减速状态，如果被地板或天气传播，很容易让整张地图的战斗节奏失衡。

状态持续时间的刷新也会影响战斗体验。相同状态再次施加时会把持续时间拉到更长的那个值，而不是叠加两倍伤害。这个机制会让“持续补状态”的武器表现稳定，但也会让“低频高强度”的状态不容易在短时间内叠加。设计时要么提高 <code>damage</code>，要么把 <code>intervalDamageTime</code> 设得更短，避免状态存在但伤害不明显。

<code>statusDuration</code> 在子弹、液体、天气中的来源不同，但都需要与你的节奏匹配。持续时间过短，玩家几乎看不到效果；过长又会让状态“像永久一样”覆盖战场。一个常用的做法是先根据武器的 <code>reload</code> 估算触发频率，再反推 <code>statusDuration</code>，保证“效果可见但不会堆满”。

单位免疫是另一层平衡手段。<code>UnitType</code> 的 <code>immunities</code> 可以让单位完全无视某些状态，这常用于“高阶单位”或“Boss”，也可以用来塑造阵营特色。比如你可以让某个阵营对“燃烧”免疫，但对“冻结”更敏感，从而改变玩家的武器选择。

<span id="模组示例饱和火力-3.3.0-的急冻"></span>
== 模组示例：饱和火力 3.3.0 的“急冻” ==

在“饱和火力 3.3.0”里，“急冻”是一个典型的高伤害减速状态。它同时降低速度、生命倍率与射速，还加入了自定义的粒子特效。注意 <code>effect</code> 使用了 <code>ParticleEffect</code> 并指定了 <code>region</code>，这意味着它依赖自定义贴图。下面是该状态的节选：

<pre>{
    "name": "急冻",
    "color": "c0ecff",
    "damage": 1.62,
    "healthMultiplier": 0.7,
    "speedMultiplier": 0.4,
    "reloadMultiplier": 0.45,
    "opposites": ["burning", "melting", "殁火"],
    "effect": {
        "type": "ParticleEffect",
        "particles": 3,
        "lifetime": 26,
        "region": "饱和火力-三角形",
        "colorFrom": "c0ecff",
        "colorTo": "c0ecff"
    }
}</pre>
这个例子展示了“数值压制 + 强视觉效果”的组合。<code>opposites</code> 在 JSON 里只用于显示，但它至少能让玩家在数据库面板上读到“急冻与燃烧对立”的信息。

<span id="模组示例饱和火力-3.3.0-的状态脚本"></span>
== 模组示例：饱和火力 3.3.0 的状态脚本 ==

“饱和火力 3.3.0”里有一批状态是用脚本补逻辑的。例如“阳电/阴电”的亲和反应就写在 <code>scripts/base/status.js</code>，通过 <code>affinity</code> 把两种状态之间的连锁伤害显式编码出来：

<pre>const 阳电 = extend(StatusEffect, "阳电", {
    init() {
        this.affinity(阴电, (unit, result, time) => {
            unit.damagePierce(this.transitionDamage);
            result.set(阴电, Math.min(time + result.time, 60));
        });
    }
});</pre>
这类逻辑无法用 JSON 表达，但它能让状态从“单一数值”变成“反应体系”。当你需要状态之间的联动时，脚本或 Java 才是正确的解决路径。

<span id="特效effect-fx"></span>
== 特效（Effect / Fx） ==

特效是短时视觉片段，常见于炮塔开火、方块建造、生产完成、单位死亡等。JSON 里可以直接写原版 <code>Fx</code> 的名字（字符串），也可以写一个对象并指定 <code>type</code> 来创建自定义特效。若对象里不写 <code>type</code>，解析器会默认把它当成 <code>ParticleEffect</code>。如果你写的是数组，解析器会自动合成为 <code>MultiEffect</code>，多种特效将同时播放。

<code>ParticleEffect</code> 的核心参数是 <code>particles</code>（粒子数量）、<code>lifetime</code>（持续时间）、<code>length</code>（拖尾长度）、<code>sizeFrom/sizeTo</code>（大小变化）与 <code>colorFrom/colorTo</code>（颜色渐变）。这些字段组合后，就能做出火花、烟雾、能量粒子等常见效果。<code>WaveEffect</code> 则更适合做冲击波或环形波纹，它常用 <code>sizeFrom/sizeTo</code> 与 <code>strokeFrom/strokeTo</code> 描绘“扩散与淡出”。如果你想要更复杂的效果，可以用 <code>MultiEffect</code> 组合多种模板，或者直接引用原版 <code>Fx</code>。

特效对象还有一些“行为型”的通用字段。<code>followParent</code> 与 <code>rotWithParent</code> 可以让特效跟随单位或子弹移动并旋转，适合做“贴身效果”；<code>startDelay</code> 能推迟播放，用来制造“延迟爆炸”或“余波”；<code>clip</code> 与 <code>layer</code> 则影响绘制范围与层级，让特效不会被地形遮挡或被 UI 覆盖。你不一定每次都用到这些字段，但当表现“看起来不对”时，往往就是这些细节决定了最终观感。

<pre>"craftEffect": {
    "type": "ParticleEffect",
    "particles": 6,
    "lifetime": 30,
    "length": 6,
    "sizeFrom": 2,
    "sizeTo": 0,
    "colorFrom": "ffffff",
    "colorTo": "a0b4ff"
}</pre>
注意 <code>lifetime</code> 的单位仍然是刻。一个 <code>lifetime = 30</code> 的特效持续约 0.5 秒，过长会显得“拖泥带水”，过短又会看不清。调参时可以先让 <code>lifetime</code> 稍长一些，确认效果后再缩短。

== 特效与性能的平衡 ==

特效是最容易“堆出卡顿”的部分。粒子数量、生命周期和范围都会影响性能，尤其是大量单位同时触发时。一个 <code>particles = 30</code> 的特效看起来很华丽，但如果你的炮塔射速很高，很快就会在战场上堆出几百个粒子。更稳妥的做法是用较少的粒子配合颜色与大小变化，让效果“看起来很强”，而不是“真的很重”。

除了减粒子，还可以调 <code>effectChance</code> 与 <code>lifetime</code> 来控制频率与持续时间。很多持续性武器只需要“稀疏但明显”的特效，完全没必要每一帧都生成粒子。再配合较小的 <code>clip</code> 范围，渲染开销会明显下降，战斗场面也更干净。

另外，特效的风格要与数值一致。高爆发武器可以用明显的冲击波与闪光，持续性武器可以用细小但连贯的粒子。玩家会通过视觉判断武器强度，如果特效与实际伤害差距太大，会造成体验上的“误导”。

<span id="音效sound"></span>
== 音效（Sound） ==

音效来源于 <code>core/assets/sounds</code>。在 JSON 中通常直接引用 <code>Sounds</code> 里的字段名，例如 <code>shootSound</code>、<code>chargeSound</code>、<code>placeSound</code>、<code>breakSound</code>、<code>destroySound</code>、<code>ambientSound</code>。不同方块或武器对音效字段的支持并不完全一致，所以建议先对照原版配置再填写。

若你自带音效，把 <code>ogg</code> 或 <code>mp3</code> 放进 <code>sounds/</code> 目录，文件名就是你要引用的名字。音效的“响度与音高”通常由 <code>soundVolume</code>、<code>soundPitchMin</code>、<code>soundPitchMax</code> 控制，但具体字段是否生效取决于方块或武器的实现。因此更安全的做法是先复用原版字段，再逐步替换。

持续性的声音通常用 <code>loopSound</code> 或 <code>ambientSound</code>，前者更多用于“正在工作”的设备，后者偏向环境氛围。搭配 <code>soundPitchMin/soundPitchMax</code> 做轻微的音高浮动，能让连续播放的声音不至于太机械；而 <code>soundVolume</code> 则是最直接的平衡杠杆，尤其在一屏多个炮塔同时开火时，适当降音量能显著减少“噪声疲劳”。

如果你在一个关卡里同时使用了多种自定义音效，最好先做一次“混音检查”，避免同频段叠加导致刺耳或浑浊。很多时候只需要略微降低音量或缩短音效长度，就能让整体听感更清晰。

== 声音作为设计的一部分 ==

音效并不是“可有可无”的装饰。射击音效能告诉玩家“是否在命中”，充能音效能提示“是否即将开火”，环境音效则能让地图氛围更完整。比如高能武器如果没有明显的充能音效，玩家很难感知它的危险性；而持续性武器如果没有稳定的循环音效，又会显得没有存在感。建议在设计时让“听觉反馈”和“数值强度”保持一致。

如果你的模组里有多种炮塔或单位同时开火，音效的“混响”也很重要。过多高频音效会刺耳，过多低频音效会让战场变得浑浊。你可以通过调整音量或替换音效，让战斗听起来更清晰。

== 小结 ==

状态效果偏数值，特效与音效偏表现。只要理解“时间单位”和“叠加逻辑”，你就能做出稳定且易调的状态体系；再配合合适的特效与音效，就能让战斗表现明显提升。很多模组质感的差异，往往就来自这三者的配合，并且要与武器节奏保持一致，也更耐看。