上下文音乐管理器 (CMM) 3.0.0 b259 - 2.6 b12 - A20 - A21

上下文音乐管理器 (CMM) 3.0.0 b259 - 2.6 b12 - A20 - A21

实时热切换音乐曲目以符合你的喜好——有选择性地替换《7 Days》原版音乐以适应不同场景。CMM 编辑器可涵盖战斗、血月、商人、生物群系、你的基地、载具、POI、死亡及重生等多种情境。支持MP3、OGG、Opus、FLAC、WAV、AAC、MP4、MKV、WebM格式。

您可以尝试的其他创作者的音乐包

如果您将自己创作的音乐包、免版税或AI生成的内容(您有权合法分发的内容)整合在一起,我会在此处提供链接。

Alpha 20.7, Alpha 21.2, 2.6 尚未在多人游戏中进行测试


V1.0.5 收音机里有什么?(开发中) - 未完成 - 微调中 - 已完成

  • 游戏内收音机对象会发出音乐,曲目存储于/Music/radio(或您定义的任何路径),以真实的空间化、剧情内音效覆盖在您的正常音轨之上——走近扬声器音量会变大,声音会在耳边平移,被墙壁遮挡后会变闷,并带有房间混响。一个共享的“电台”即使在您离开范围后也会继续广播,因此当您返回时,会在歌曲中间重新加入。整个空间感(范围、衰减、遮挡、混响)可通过settings.xml文件实时热调整。扬声器式电台失真效果仍在开发中(正在考虑是否添加类似《辐射3/4》的DJ系统。可能会在1.0.6版本中加入)。
  • 当门打开/关闭时,其状态会从实体/空气更改;损坏的门会漏音。滑动门有一个计时器,因此声音会逐渐变闷/泄漏(我不确定这会影响其他玩家控制的门的处理方式)。
  • 游戏内模组以播放电台(概念构思中;将在多人游戏中禁用)。
  • 可通过添加子文件夹到/Music/radio文件夹来定义多个电台。该文件夹的名称决定了电台的名称。
  • “正在播放”覆盖层
  • DebugHud(已完成,只是尚未随发布版本一起提供)
  • 选项:为上下文禁用“过期”,使其在非活跃状态时永不过期。
  • 快捷键: 禁用不喜欢的曲目,收藏想常听的曲目(尚未开始),禁用战斗上下文。

V1.0.4b

  • 现支持播放列表。您可以将一个上下文指向一个.m3u/.m3u8播放列表文件,而不是一个文件夹,从而精确控制播放哪些歌曲以及它们所处的曲池。
  • 文件夹会自动识别播放列表。如果一个文件夹中有播放列表文件,它们中的歌曲将与散落的音乐文件一起被包含进来(无重复)。
  • 播放列表的更改会立即生效。编辑或添加播放列表后,模组会立即察觉,无需重启——即使在USB驱动器、网络驱动器和其他非标准存储设备上也是如此。
  • 修复
    • 修复了在某些语言设置下音乐失效的问题。在土耳其语和阿塞拜疆语系统中,由于字母“i”的处理方式,某些音乐无法播放——现已修复。
    • 修复了菜单停留在默认游戏音乐的问题。当菜单文件夹包含大量文件时,您的自定义菜单音乐从未生效。现在它会在几秒钟内开始播放。
    • 修复了菜单音乐以最大音量爆发的问题。当自定义菜单音乐播放完毕,游戏自身音乐接管时,它会直接跳到最大音量。现在它会平滑淡入。
    • 修复了某些类型的MKV文件导致的卡死问题
    • 优化了扫描超过100,000个文件的库时的性能

V1.0.4a

  • 现支持播放列表。您可以将一个上下文指向一个.m3u/.m3u8播放列表文件,而不是一个文件夹,从而精确控制播放哪些歌曲以及它们所处的曲池。
  • 文件夹会自动识别播放列表。如果一个文件夹中有播放列表文件,它们中的歌曲将与散落的音乐文件一起被包含进来(无重复)。
  • 播放列表的更改会立即生效。编辑或添加播放列表后,模组会立即察觉,无需重启——即使在USB驱动器、网络驱动器和其他非标准存储设备上也是如此。
  • 修复
    • 修复了在某些语言设置下音乐失效的问题。在土耳其语和阿塞拜疆语系统中,由于字母“i”的处理方式,某些音乐无法播放——现已修复。
    • 修复了菜单停留在默认游戏音乐的问题。当菜单文件夹包含大量文件时,您的自定义菜单音乐从未生效。现在它会在几秒钟内开始播放。
    • 修复了菜单音乐以最大音量爆发的问题。当自定义菜单音乐播放完毕,游戏自身音乐接管时,它会直接跳到最大音量。现在它会平滑淡入。

V1.0.4 引擎启动(已发布)

CMM现在作为一个单一构建版本发布,可在Alpha 20.7、Alpha 21.2、2.6和3.0.0上运行。音频引擎已完全与游戏解耦。希望两者都不会引起任何问题。

整个音频引擎现在都是原生C语言

该版本将几乎整个音频流水线从游戏的管理(C#/Unity)环境中移出,移入一个专门构建的原生C库中。这意味着音乐不再与游戏争夺主线程,也不会被垃圾回收暂停打断——这是卡顿的最大来源。以前是C#的代码现在变成了纯C:

  • CMM现在完全不再通过Unity的音频系统播放音乐。解码、混音和输出现在在模组自己的原生音频引擎(CMM_Decoder.dll)中运行,使用模组自己拥有的线程——完全在游戏的帧循环之外。
  • 交叉淡出不再被破坏。 旧系统只有两个声道(一个A/B对):如果在一个交叉淡出仍在进行时触发了新的上下文,它必须窃取两个声道之一并硬性切断正在淡出的曲目。新的混音器最多支持4个同步声音——新的曲目可以开始,而最多三个较旧的曲目自然完成淡出。快速的上下文变化(环境→紧张→战斗在两秒内)现在听起来就像一个连续的音乐传递,而不是一个突兀的切断。
  • 如果过渡堆积超过限制,混音器只会丢弃最安静的声音——即已经在淡出尾部接近静音的声音——因此“驱逐”是听不到的。传入的曲目永远不会是被牺牲的那个。
  • 每个支持的格式都由原生解码:ogg、opus、flac、mp3、wav、m4a/aac,以及mp4/m4v/mkv/webm容器中的音频。没有托管解码工作意味着音乐引擎基本上不会给垃圾回收器带来压力——在您游戏时它不会引起GC卡顿。
  • 逐曲目响度归一化(EBU R128): 来自不同专辑/来源的曲目以一致的音量播放,而不会出现一首歌震耳欲聋,下一首却轻声细语的情况。每个曲目测量一次,缓存,并在其之上提供逐曲目手动微调的按键绑定。
  • 拔掉耳机或切换默认音频设备不再会让音乐中断——混音器跟随操作系统的默认端点并继续播放。
  • 音乐能挺过加载冻结: 因为引擎在自己的线程上运行,曲目会在游戏主线程在世界加载/卸载期间被冻结时继续播放——甚至前进到下一首曲目——而不会随之停滞。
  • 混音器——混合和流式传输音频的循环现在完全以原生C语言在自己的线程上运行,因此播放不受游戏内掉帧和GC卡顿的影响。
  • 音频输出——一个专用的原生输出引擎(miniaudio)完全取代了旧的Unity/托管播放路径。
  • 音量归一化(响度)——平衡曲目音量的EBU R128分析现在在原生C语言中完成,速度更快,且不在游戏循环中。
  • 文件解码——所有解码(包括MP4/MKV容器)都在原生代码中完成,使用更安全、无竞态的文件读取。
  • 曲目更改、加载或归一化时不再有帧卡顿或断续。
  • 在高负载时刻(尸潮、大型基地、快速加载画面)播放稳定,因为音乐引擎不再与游戏共享线程。
  • 后台工作(响度扫描、曲目预加载、文件夹/配置监控)完全脱离游戏循环,因此编辑设置或添加音乐不会造成延迟。
  • 下一首曲目会预先加载以实现无缝、无间隙的切换。
  • 音量归一化现在适用于任意大小的FLAC文件(以前大型FLAC可能会跳过归一化)。
  • 修复了一个罕见的竞态条件,该问题导致同时加载多个曲目时,某些文件未被归一化(太响/太轻)。
  • 改进了MP4/MKV音频解码。
  • 与游戏内置音乐的切换(包括重新加入时)更平滑。
  • 暂停、退出和快速加载时的淡出更干净。
  • 修复了POI清除检测,使得在清理一个地点后音乐能正确触发过渡。
  • 默认音乐音量现在为0.5,以匹配游戏正常的音乐级别——如果您的音乐听起来比以前更安静,请在设置中调高它。
  • 原版音乐静音现在更干净,不再与游戏冲突。

新功能:小队共享战斗音乐(多人游戏)

  • 纯客户端——不需要服务器模组
  • 您的战斗音乐现在会对整个小队做出反应,而不仅仅是您个人周围的敌人。当附近的队友受到攻击时,您也会进入战斗音乐——即使他们的僵尸远在您自己的检测范围之外。
  • 音乐规模会随着战斗规模而变化:独自对抗一群僵尸与和整支小队并肩作战,现在会被视为不同的音乐时刻。
  • 对加入服务器(客户端)的玩家也能正常工作——即使敌方AI在服务器端运行,战斗也能被检测到。
  • 完全可配置: 设置队友需要多近才能共享他们的战斗(默认30个单位),以及是否仅计入队伍成员/好友或任何附近的玩家。
  • 单人游戏完全不受影响——这仅在存在其他玩家时才会启用。

需求

  • EAC必须关闭
  • 7 Days to Die 版本 3.0.0 B259 - 2.6 b12 - A21.2 b37 - A20.7 b1

亮点

  • 实时热切换 — 在游戏中更改音乐,甚至在曲目播放中也可更改。无需重启即可添加、移除或替换音乐。CMM会在数秒内检测到更改——即使是当前正在播放的曲目。无需菜单,无需编辑配置。只需将文件放入文件夹即可。
  • 智能恢复 — 离开后返回,曲目会从上次中断处继续播放。
  • 随处平滑交叉淡出 — 没有硬性切断。
  • 与原版动态音乐兼容良好(如果您保持开启)。
  • 原生流式解码器 — 一个捆绑的原生库处理所有格式,几乎不产生垃圾回收压力,因此大型音乐库不会影响FPS。
  • 热重载配置 — 在游戏运行时调节音量、淡入淡出和优先级。

上下文(最高优先级优先)

死亡 (100) - 死亡时播放一次,然后返回之前的音乐。中断一切。

POI已清除 (91) - 当您在POI中杀死最后一个潜行者时播放的一次性提示音。

低血量恐慌 (90) - 当您重伤(默认30% - 可配置)且处于战斗时触发。

血月战斗 (71) - 血月之夜期间的战斗;最高战斗优先级,覆盖正常战斗等级。

载具 (70 / 基础 69)

  • 旋翼机、自行车、迷你自行车、摩托车、4x4 各有其专属音乐 → 若其文件夹为空,则回退到通用载具曲目。

生物群落战斗 (62 / 61 / 60) - 每个战斗等级的可选生物群落版本(森林、焦灼森林、沙漠、雪地、废土)。当您在拥有专属战斗音乐的生物群落中战斗时,会播放该音乐而非下方匹配的通用等级;如果该文件夹为空,则直接回退到通用等级。生物群落在战斗开始时锁定——因此在战斗中跨越边界不会切换曲目——如果您离开战斗并在新地点重新交战,则会重新锁定(强度等级仍会从中断处继续)。正好位于通用战斗等级之上(并在战斗期间覆盖载具/探索音乐)。血月战斗保持通用。

战斗 - 强度由对您构成威胁的敌人评分决定。三个等级,每个等级回退到下一个等级,以便缺失的文件夹能优雅降级:

  • 战斗Boss (52) → 战斗高
  • 战斗高 (51) → 战斗低
  • 战斗低 (50) → 如果游戏处于“恐慌”状态,则回退到原版战斗音乐,否则回退到栈。

combat/根文件夹本身就是低等级;_high和_boss子文件夹包含升级版本,每个生物群落都在combat/<biome>/下镜像此结构。

生成 (45) - 您生成时播放一次。

紧张 (30) - 当敌人正在跟踪您并靠近时播放;由于预热时间(2秒),短暂的对峙将被忽略,因此快速冲入战斗会直接进入战斗音乐。

商人 (26 / 基础 25)

  • 乔尔、珍、雷克特、鲍勃、休 各有其专属主题 → 回退到通用商人曲目 → 如果游戏开启了动态音乐,则回退到原版商人音乐。

游泳 (23) - 当您处于足够深的游泳区域时播放;短暂的潜入会因预热时间(5秒)而被忽略。

兴趣点 - 两层,每层按POI难度分为T0–T5:

  • 受侵扰的POI (22 → 基础 20) — 当存在活动潜行者时播放。每个等级(T5…T1)回退到POI_Infested,POI_Infested回退到栈(排除T0,它总是回退到栈)。
  • 已清除/未受侵扰的POI (18 → 基础 16) — 在没有活动潜行者的POI内。每个等级回退到通用POI曲目(排除T0)。

家 (15)

  • 家(夜晚) 播放夜间专属曲目 → 回退到家(您的默认基地音乐)。

环境/生物群落 (12 → 基础 10) — 您的日常探索音乐,最低的自定义层:

  • 每个生物群落(森林、焦灼森林、沙漠、雪地、废土)都有一个白天的曲目和一个可选的_Night变体。
  • 生物群落的夜间曲目 → 回退到通用环境(夜晚) → 回退到栈(如果存在,则为生物群落的白天曲目)。
  • 生物群落的白天曲目 → 回退到环境。
  • 环境 → 如果开启了动态音乐,则回退到原版音乐。

菜单 (0) - 在主菜单循环播放;回退到原版菜单音乐。

哨兵(内置,请勿移除)— 静默和原版是两个终极回退:交还给游戏自身音乐,或播放无声。


音乐的选择方式

CMM维护一个当前与您情境相关的所有信息的栈(处于战斗中、在沙漠中、在夜晚、靠近商人……)并播放优先级最高且有音乐的那个。相同优先级永远不会相互中断,因此正在播放的音乐会一直持续,直到发生真正更重要的事情。

如果一个上下文的文件夹是空的,它不会保持静默——它会跟随该上下文的回退到下一个最佳选择。一些共同的规则:

  • 预热 - 某些上下文必须保持活跃数秒钟才能接管,因此短暂的时刻(快速浸入水中、闪进门廊)不会中断您的音乐。
  • 预热组 - 一个共享标签,用于相互传递的上下文(如白天/夜晚配对);成员共享一个预热计时器,因此它们之间的切换保持无缝,而不是在预热新计时器时短暂地降到较低优先级的音乐。每个上下文仍然保留自己的预热——将组成员设为相等可获得最平滑的效果。当前用于“家”和“家(夜晚)”。
  • 冷却 - 战斗/事件音乐在可以重新触发前会等待几秒钟,以防止快速闪烁。
  • 恢复 - 大多数上下文在您重新进入时会从中断处继续;短事件会重新开始。
  • 过期 - 上下文仅在非活跃状态下有资格从其保存状态恢复,直到它们超时(过期)。
  • 一次性 - 事件提示音会播放至完成,然后交还给之前正在播放的音乐。

可在contexts.xml中自定义的其他属性:

  • 名称 - 上下文的ID。
  • 路径 - 上下文的子文件夹。
  • 子文件夹 - 如果启用,将播放上下文文件夹中子文件夹内的所有音乐。
  • 回退 - 如果上下文缺少文件,回退到哪里——另一个上下文、栈、原版或静默。
  • 淡入时间 - 上下文激活时淡入所需的时间。
  • 优先级 - 在栈上的优先级。
  • 循环 - 选择一首曲目重复播放(不被任何上下文使用,但选项存在),直到它过期。
  • 旁路 - 绕过当前播放曲目的冷却。

settings.xml中值得提及的其他设置:

  • VolumeModifier - CMM曲目相对于游戏音乐滑块(0.0–1.0)的播放响度。
  • MusicPath - 音乐的根文件夹。相对或绝对路径(可以将文件存储在模组目录/驱动器之外的文件夹中)。
  • EnemyDetectRange - 敌人计入战斗/紧张状态的最大距离(游戏单位)。
  • HomeDetectRange - 距离您的睡袋或领地石被视为“家”的距离(游戏单位)。
  • PlayerHealthDangerThresholdPercent - 生命值百分比(0.0–1.0),低于此值时战斗会升级为低血量恐慌。

文件夹映射

Music/
├── ambient/                       探索默认 (最低优先级)
│   ├── _night/                    仅夜间探索曲目 (通用)
│   ├── forest/                    松树林 (白天 + 日常)
│   │   └── _night/                森林,仅夜间
│   ├── burnt_forest/
│   │   └── _night/
│   ├── desert/
│   │   └── _night/
│   ├── snow/
│   │   └── _night/
│   └── wasteland/
│       └── _night/
│
├── home/                          靠近睡袋 / 领地石
│   └── night/                     家,仅夜间
│
├── poi/                           在已清除 / 未受侵扰的 POI 内
│   ├── t0/  t1/  t2/  t3/  t4/  t5/   按 POI 难度等级
│   └── infested/                  在存有活动潜行者的 POI 内
│       └── t0/ t1/ t2/ t3/ t4/ t5/     按 POI 难度等级
│
├── trader/                        在任何开放的商人处
│   ├── joel/  jen/  rekt/  bob/  hugh/   按商人主题
│
├── vehicle/                       驾驶任何载具时
│   ├── gyrocopter/  bicycle/  minibike/  motorcycle/  4x4/
│
├── swimming/                      足够深以游泳
│
├── tension/                       敌人警戒且靠近,尚未交战
│
├── combat/                        战斗 — 低强度 (战斗根目录即为低等级)
│   ├── _high/                     战斗 — 高强度
│   ├── _boss/                     战斗 — Boss 强度
│   ├── blood_moon/                血月之夜战斗 (无生物群落分割)
│   ├── forest/                    松树林 — 生物群落战斗 (低)
│   │   ├── _high/                 森林 — 高
│   │   └── _boss/                 森林 — Boss
│   ├── burnt_forest/              焦灼森林 — 生物群落战斗 (低)
│   │   ├── _high/
│   │   └── _boss/
│   ├── desert/                    沙漠 — 生物群落战斗 (低)
│   │   ├── _high/
│   │   └── _boss/
│   ├── snow/                      雪地 — 生物群落战斗 (低)
│   │   ├── _high/
│   │   └── _boss/
│   └── wasteland/                 废土 — 生物群落战斗 (低)
│       ├── _high/
│       └── _boss/
│
├── events/
│   ├── death/                     死亡时播放一次
│   ├── low_health/                战斗中极低生命值
│   ├── spawn/                     重生时播放一次
│   └── poi_cleared/               最后一个潜行者死亡时的提示音
│
└── menu/                          主菜单 (循环)

常见问题解答与故障排除

问:我必须填满每个文件夹吗? 不。只填您关心的那些——空文件夹会自动回退(最终会回退到游戏的原版音乐)。您可以从仅使用ambient和combat/low开始。

问:这个模组能在 MacOS 或 Linux 上运行吗? 原生音频解码器目前以 Windows 库的形式提供,因此 Windows 是唯一官方支持的平台。它仅在 Windows 上测试过;其他操作系统不受支持。

问:支持哪些音频格式? MP3、OGG (Vorbis)、Opus、FLAC、WAV/AIFF 和 AAC——包括.m4a/.mp4,甚至 MP4/MKV/WebM 视频的音频轨道。

问:我可以在不重启游戏的情况下更改音乐吗? 可以。在游戏运行时添加、移除或替换文件——CMM 会在几秒钟内检测到更改,即使是当前正在播放的曲目。

问:我添加了一个文件,但没有任何反应。

  • 确保它在正确的文件夹中,并且是支持的格式。
  • 该情境可能尚未激活(例如,blood_moon曲目仅在血月之夜播放)。
  • 更高优先级的情境可能正在覆盖它(战斗优先于环境等)。
  • 损坏的文件会被自动拒绝——如果曲目无法播放,请重新导出。

问:一个文件夹中有多个曲目——如何选择? 随机选择,不立即重复。您可以在Config/settings.xml中切换到顺序或纯随机模式(仅无重复的随机模式已通过彻底测试)。

问:音乐太响或太轻了。 CMM 遵循您游戏内的音乐音量滑块,再加上Config/settings.xml中的VolumeModifier(默认 1.0)。调高或调低它——当您保存文件时,如果游戏正在运行,更新后的设置会立即加载。

问:这是否完全取代了原版音乐? 仅在您提供曲目的地方取代。空文件夹会交还给原版动态音乐,因此二者共存。

问:我离开一个区域又回来——为什么音乐重新开始/没有重新开始? 如果您快速返回,曲目会从中断处继续;在上下文“过期”(基于情境可配置)后,CMM 会选择一首新曲目。

问:我可以将我的音乐存储在模组文件夹之外吗? 可以——将Config/settings.xml中的MusicPath设置为任何文件夹(甚至在其他驱动器上)。

问:它能与游戏中的动态音乐设置一起使用吗? 可以。有些文件夹仅在启用动态音乐时才回退到原版,因此您在选项菜单中的选择会得到尊重。

问:AI 被用于制作这个模组吗? AI 被用于帮助编写这个描述页面,并构成了大约 80% 的模组代码。


第三方库

这个模组离不开它所基于的开源库。衷心感谢它们的作者:

  • MoonSharp(BSD 3-Clause + MIT)— Marco Mastropaolo — 运行 context.lua 决策脚本的嵌入式 Lua 解释器。moonsharp.org — GitHub

音频由随模组捆绑的一个小型原生库(CMM_Decoder.dll)解码和播放,该库编译了以下组件:

  • libopus / libopusfile(BSD)— Xiph.Org Foundation — Opus 解码。
  • libvorbis / libvorbisfile(BSD)— Xiph.Org Foundation — OGG Vorbis 解码。
  • libogg(BSD)— Xiph.Org Foundation — Opus 和 Vorbis 使用的 Ogg 容器帧。
  • dr_flac / dr_mp3 / dr_wav(公共领域)— David Reid (mackron) — FLAC、MP3 和 WAV/AIFF 解码。
  • fdk-aac(Fraunhofer FDK AAC 许可证)— Fraunhofer IIS — AAC-LC / HE-AAC 解码。
  • minimp4(CC0)— Lieff — MP4 / M4A 容器解复用。
  • miniaudio(公共领域)— David Reid (mackron) — 跨平台音频播放。

完整的许可证文本包含在模组下载文件内的THIRD_PARTY_NOTICES.txt中。