命令百科

effect · scoped_play_song

Definition

  • Supported scope:COUNTRY
  • Supported target:none

Description

Plays song from database only on in current scope's player

实战 · 配合 · 坑

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

实战用法

scoped_play_song 常用于 mod 中为特定国家触发专属配乐，例如当某国完成关键国策、宣战或发生内战时，为该国玩家播放一首氛围音乐以增强沉浸感。注意它只对当前 scope 所属国家的玩家生效，因此非常适合放在国家级 event 或 focus 完成回调中。

# 某国完成特定国策后播放专属主题曲
focus = {
    id = GER_rise_of_the_reich
    ...
    completion_reward = {
        scoped_play_song = {
            song = "GER_triumph_theme"
        }
    }
}

配合关系

  • [country_event](/wiki/effect/country_event) — 在触发重要事件的同时调用 scoped_play_song，为事件弹窗营造对应的音乐氛围，二者常写在同一执行块中。
  • [add_ideas](/wiki/effect/add_ideas) — 赋予某个国家新 idea（如战争状态、特殊政策）时同步播放主题曲，强化该时刻的叙事感。
  • [complete_national_focus](/wiki/effect/complete_national_focus) — 脚本强制完成国策时配合播放胜利/转折音乐，多见于大型叙事 mod 的关键剧情节点。
  • [has_country_flag](/wiki/trigger/has_country_flag) — 在触发条件中用标志位判断是否已播放过该曲，避免同一首歌反复触发造成体验干扰。

常见坑

  1. Scope 写错导致无声：scoped_play_song 必须处于 COUNTRY scope 下，若不小心在 STATE 或 CHARACTER scope 内调用，游戏不会报错但音乐完全不会播放，排查时容易被忽视。
  2. 多人游戏中误以为所有玩家都能听到：该 effect 只向当前 scope 国家的本地玩家推送音乐，在多人局中其他玩家不会收到，切勿用它做"全局广播"配乐，需要广播效果应对每个目标国家分别 scope 后各自调用。