音乐活动

# ==========================================
# 通用设置
# ==========================================
[universal]
server_nbt_sync = ["warden_spawn_tracker"]

# ==========================================
# 事件 (触发器)
# ==========================================
[[events.mobs]]
event_name = "warden_undetected_4"
priority = 204
detection_range = 25.0
sync_group = "warden_proximity"
resource_name = ["minecraft:warden"]

[[events.player]]
event_name = "shrieker"
priority = 300
event_delay = 6.0
nbt_match = ["{warden_spawn_tracker:{warning_level:3}}"]

[[events.mobs]]
event_name = "warden_undetected_3"
priority = 203
detection_range = 50.0
sync_group = "warden_proximity"
resource_name = ["minecraft:warden"]

[[events.mobs]]
event_name = "warden_undetected_2"
priority = 202
detection_range = 75.0
sync_group = "warden_proximity"
resource_name = ["minecraft:warden"]

[[events.mobs]]
event_name = "warden_detected_4"
priority = 214
detection_range = 25.0
mob_targeting = true
sync_group = "warden_proximity_detected"
resource_name = ["minecraft:warden"]

[[events.mobs]]
event_name = "warden_detected_3"
priority = 213
detection_range = 50.0
mob_targeting = true
sync_group = "warden_proximity_detected"
resource_name = ["minecraft:warden"]

[[events.mobs]]
event_name = "warden_detected_2"
priority = 212
detection_range = 75.0
mob_targeting = true
sync_group = "warden_proximity_detected"
resource_name = ["minecraft:warden"]

[[events.mobs]]
event_name = "warden_detected_1"
priority = 211
detection_range = 100.0
mob_targeting = true
sync_group = "warden_proximity_detected"
resource_name = ["minecraft:warden"]

[[events.mobs]]
event_name = "angel"
priority = 100
detection_range = 50.0
mob_targeting = true
require_fov = 2
resource_name = ["weeping_angels:weeping_angel"]

[[events.mobs]]
event_name = "warden_undetected_1"
priority = 201
detection_range = 100.0
sync_group = "warden_proximity"
resource_name = ["minecraft:warden"]

[[events.mobs]]
event_name = "dweller"
priority = 101
mob_targeting = true
require_fov = 1
resource_name = ["cave_dweller:cave_dweller"]

• play_when_paused = true/false：确定在游戏菜单暂停时是否允许播放该音轨。
• muffling_when_paused = 1.0：游戏暂停时应用的消音效果倍率。（推荐值：1.0）。
• underwater_muffling = 1.0：玩家浸入水中时应用的消音效果倍率。（推荐值：1.0）。
• gui_muffling = 1.0：当 GUI 界面激活时应用的消音效果倍率。（推荐值：1.0）。
• gui_muffling_delay = 20：GUI 消音效果生效前的延迟时间（以秒为单位）。
• gui_muffling_blacklist = ["InventoryScreen"]：绕过消音效果的 GUI 类列表。 使用模组的调试屏幕来了解您当前正在查看的 GUI。
• pause_volume_multiplier = 0.5：游戏暂停时应用的音量控制倍率。
• remember_track = true/false：如果启用，事件会记住其在变为非活动状态前播放的最后一条音轨，并在重新激活时重播该音轨，而不是选择新的随机音轨。
• resume_from_timestamp = true/false：如果启用，当事件重新激活时，它将直接从暂停的确切时间点（时间戳）恢复播放。
• seamless_handoff = true/false：启用平滑的音轨转换。如果事件 A 过渡到事件 B，并且两者在其播放列表中共享当前正在播放的音轨，则该音轨将无缝地继续播放，无需重新开始或淡出。
• fade_in = 2.0 / fade_out = 2.0：指定事件激活或停用时音频音量的过渡持续时间（以秒为单位）。
• persistence = 10.0：定义在其激活条件不再满足后，事件强制保持活动状态并继续播放音乐的持续时间（以秒为单位）（例如，怪物死亡后仍保持战斗状态 10 秒）。
• time_between_audio = 60.0：指定在一段音轨播放完毕后，事件能够触发后续音轨播放之前的冷却持续时间（以秒为单位）。
• jukebox_behavior = "ignore"/"pause"/"muffle"：确定音轨如何响应附近原版点唱机播放的音乐唱片。
• cooldown_group_time = 120.0 / cooldown_group_events = ["eventA", "eventB"]：关联多个不同事件间的音轨冷却时间。如果某个事件完成播放一段音轨，则 cooldown_group_events 中列出的所有事件在允许再次播放前，都将共享指定的 cooldown_group_time 冷却时间。
• mob_blacklist = ["minecraft:slime", "minecraft:vex"]：禁止全局激活怪物事件的实体 ID 列表。
• priority = 50：决定多个事件同时激活时播放优先级的整数值。数值越高，优先级越高。
• hard_interrupt = true/false：强制立即终止当前音轨，绕过并忽略标准的持久性和淡出参数。
• locked = true / unlocks_event = "phase_2" / relock_when_inactive = true：允许顺序事件激活的状态管理参数。事件默认可以是 locked 状态，只有其他事件调用其 unlocks_event 时才会变为活动状态。
• sync_group = "battlefield_crescendo"：将事件分配到同步组。同一 sync_group 内的顺序事件将继承先前活动音轨的精确播放时间戳。适用于共享相同节奏/布局的分层或多阶段音频文件。

• volume = 1.0：音轨音量水平的倍率。
• weight = 50：当一个事件有多个注册音轨时，决定播放概率。权重越高，被选中的机会就越大。
• require_all_events = true/false：如果为 true，则要求 target_events 数组中严格列出的所有事件同时处于活动状态，该音轨才能播放。
• target_events = ["overworld_day", "overworld_night"]：定义该音轨所属并检查其激活状态的特定事件列表。
• upgrade_delay = 5.0 / upgrade_fade_in = 3.0 / upgrade_fade_out = 3.0：动态音轨升级的缓动配置。如果满足事件条件，当前正在播放的音轨可以无缝“升级”到此音轨，利用这些独立的淡入淡出时间，专门绕过标准的事件淡入淡出设置。
• start_time = 15.5：指定音轨开始播放的时间戳（以秒为单位）。通过将其设置为 15.5，音轨将始终从内部第 15.5 秒处开始播放，跳过开头。
• start_x = 2：配置重复。该音轨在完成前将精确重复 2 次。
• loop_start = 10.0 / loop_end = 60.0：创建一个独立的内部播放循环。音轨正常开始，但当播放到达 loop_end（例如 60.0 秒）时，它会无缝跳回 loop_start（例如 10.0 秒），并根据 start_x 的值无限重复该子部分。
• play_once = 1/2/3/4/5：确定音轨可重播的频率。它接受以下数值：
  • 1（轮询）：在所有其他可用于活动事件的音轨播放完毕之前，该音轨不会再次播放。
  • 2（事件生命周期）：只要事件保持连续活动状态，该音轨就只播放一次。
  • 3（会话）：每次加入世界时，该音轨只播放一次。退出并重新登录时会重置。
  • 4（JVM 会话）：每次启动游戏时，该音轨只播放一次。当 Minecraft 完全重启时重置。
  • 5（世界持久）：在特定世界中，该音轨只播放一次，永久有效。持久化存储。
• interruptible = true/false：指定该音轨是否可以被更高优先级的事件强制中断。标记为 false 的音轨充当护盾，拒绝被暂停，始终从头到尾播放完毕。
• breakthrough_priority = 500：覆盖音轨的不可中断状态。即使音轨充当护盾，任何优先级等于或高于 500 的事件都可以强行突破并中断它。
• interrupt_whitelist = ["boss_phase_2"]：允许绕过中断标志并暂停该音轨的专属事件名称列表，无论优先级如何。

• /musicevents reload：指示模组对音频引擎执行硬重置，并从文件系统重新加载所有配置和音频内存缓存。
• /musicevents skip：立即跳过当前正在播放的音轨，并评估下一个最佳音轨或事件优先级。
• /musicevents unlock event_name：解锁一个处于锁定状态机的事件，将其标记为活动/可评估状态。
• /musicevents relock event_name：重新锁定特定状态机事件，阻止其激活，除非再次满足其解锁条件。您也可以使用 /musicevents relock all 来重置整个状态进度。
• /musicevents zone pos1 / /musicevents zone pos2：围绕您的确切玩家坐标设置一个维度边界框的第一个和第二个角点。
• /musicevents zone save event_name：将内部的 pos1 和 pos2 边界坐标永久写入特定区域事件！