Scripted effect

play_music_cue_once

play_music_cue_once = { TRACK = … }

game/common/scripted_effects/00_music_effects.txt, line 3 (12 lines). Parameters: $TRACK$ .

play_music_cue_once is a scripted effect in Crusader Kings III, written at line 3 of its file. A call passes 1 parameter: TRACK. The game's script calls it in 16 places, among them A New Flame (event intrigue_temptation.3020), birth.1100 (event) and Children of My Blood (event birth.1010). Patch 1.20.1.2, from game/common/scripted_effects/00_music_effects.txt.

The comment above it in the file

plays a music cue once per player character's lifetime
example use : play_music_cue_once = { TRACK = "mx_cue_combat_stinger"	}

What it does

Every line of it is script with no tooltip text: the script is below.

The script as written (12 lines of game script)

play_music_cue_once = {
	if = {
		limit = {
			is_ai = no
			NOT = {
				has_character_flag = played_$TRACK$
			}
		}
		add_character_flag = played_$TRACK$
		play_music_cue = $TRACK$
	}
}

As written in game/common/scripted_effects/00_music_effects.txt.

Where it is used

Every place in common/, events/ and history/ that calls play_music_cue_once.

Events (16)

A New Flameintrigue_temptation.3020
birth.1100
Children of My Bloodbirth.1010
Love Prevailsmarriage_effect.1001
Love Prevailsmarriage_effect.1002
Making It Rightmarriage_effect.0001

10 more

Making It Rightmarriage_effect.0002
Making It Rightmarriage_effect.0003
Making It Rightmarriage_effect.0011
Making It Rightmarriage_effect.0012
Making It Rightmarriage_effect.0013
My …birth.1001
My … and Heirbirth.1003
Twice Blessedbirth.2002
Wedding Celebrationmarriage_effect.2001
What's In A Name?birth.9002

Source: game/common/scripted_effects/00_music_effects.txt and every file of common/, events/ and history/ that calls it, Crusader Kings III 1.20.1.2.