命令百科

effect · scoped_sound_effect

Definition

  • Supported scope:COUNTRY
  • Supported target:none

Description

Plays sound effect only on in current scope's player

实战 · 配合 · 坑

实战内容由 AI 生成,并已对照 vanilla 命令词表校验 —— 请当作起点而非权威依据。上方的定义节才是游戏自带文档原文。

实战用法

scoped_sound_effect 常用于事件或决策触发时，仅让当前国家的人类玩家听到特定音效，而不打扰其他联机玩家或 AI——例如科技突破、外交成功、国家危机爆发等戏剧性节点的音效反馈。在多人联机 mod 中尤其有价值，因为它可以精确投递"属于这个国家"的声音提示。

country_event = {
    id = my_mod.1
    option = {
        name = my_mod.1.a
        # 仅让触发此事件的国家玩家听到胜利号角
        scoped_sound_effect = "my_mod_victory_fanfare"
    }
}

配合关系

  • [country_event](/wiki/effect/country_event) — 事件触发时搭配使用，在 option 块内为玩家播放对应情境的音效，增强叙事沉浸感。
  • [add_political_power](/wiki/effect/add_political_power) — 奖励政治点数的同时播放正向提示音，给玩家即时的听觉反馈。
  • [add_ideas](/wiki/effect/add_ideas) — 添加国策思潮/顾问时同步触发音效，强调"重要变化发生了"的感知信号。
  • [has_country_flag](/wiki/trigger/has_country_flag) — 用作播放音效的前置条件检查，防止在同一流程中重复触发音效。

常见坑

  1. 误用于 STATE 或 UNIT_LEADER 等非 COUNTRY scope：该 effect 仅在 COUNTRY scope 下有效，若在 every_owned_state 或 every_unit_leader 等子块内调用，不会产生任何效果也不会报错，导致音效静默且难以排查。
  2. 误以为所有玩家都能听到：新手常把它当作"广播音效"使用，实际上它只播放给当前 scope 所对应国家的玩家，若需要让多个国家各自听到音效，必须分别进入对应 scope 再各自调用一次。