自定义血月音乐模组 (V2.0) (V1.4) × 客户端血月自定义音乐

自定义血月音乐模组 (V2.0) (V1.4) × 客户端血月自定义音乐

自定义血月音乐模组,通过将默认的血月音效替换为用户自选的定制音乐曲目,为《7 Days to Die》增添个性化体验,强化游戏中的紧张夜晚。本模组不包含音乐,您需要自行提供。

音频

自定义血月音乐模组

通过将默认的血月音频替换为用户选择的定制音乐曲目,为《7 Days to Die》增添个性化色彩,让游戏中的紧张夜晚更具特色。模组不包含音乐,您必须自行提供本地曲目。

这个模组会在血月事件期间(每第7天22:00–04:00)自动播放你选择的音乐,并提供通过配置文件控制播放、随机切换曲目和调整设置的选项。它支持多种音频格式,并通过提示框提供游戏内反馈,让你在抵御尸潮的同时轻松享受自定义配乐。

半最新更新日志 BETA 2

V1.7.1 (V2.0) BETA

  • 重新添加每5秒动态配置,在cycle、loop、notify等命令后保存设置(新功能)
  • 支持无限轨道,但遵循轨道总数为50或150的限制
  • 强化游戏内通知的工具提示,以及用于追踪细节的增强日志,支持顺序或非顺序查看。
  • 清除命令反馈
    • cycle true: "播放列表将[按顺序/随机]循环播放曲目。"
    • cycle false:"关闭循环播放。当前曲目将[循环/播放一次]。"
    • loop true/false with cycleTracks = true: "当 cycleTracks 为 true 时,循环设置被忽略,因为播放列表循环已启用。"
    • 循环开启,cycleTracks = false时:"当前曲目将循环播放,直到下一首/上一首/随机播放。"
    • loop false with cycleTracks = false: "当前曲目将播放一次。"
    • 当循环曲目 = true(无论是否循环),播放列表会循环(顺序或随机播放)并无限循环。
    • 当 cycleTracks = false 时,循环控制单轨行为(循环或播放一次)。
    • 工具提示/日志解释了这些模式,使模组更易于使用。
  • 新增工具提示消息通知命令,感谢用户请求。在控制台中输入 notify true 可启用通知,输入 notify false 则禁用通知,但轨道播放仍会记录日志输出
  • 早期测试版修订:反馈有限。像cycle和loop这样的命令缺乏描述性工具提示/日志,导致行为不明确(例如,当cycleTracks = true时没有说明loop会被忽略)。

EXAMPLE BETA配置

"bloodMoonTracks": "Resources/BloodMoon" "volume": 0.8, "respectMusicSlider": true, "shuffleTracks": false, "fadeDuration": 2.0, "loop": true, "cycleTracks": true, "maxBloodMoonTracks": 150, "restoreVanillaMusic": true, "enableCustomMusicByDefault": false, "toggleKey": "Keypad9" "notifyEnabled": true }

最新更新日志:

V1.7.0 (V2.0) 测试版

  • 已针对《7 Days to Die》2.0版本进行更新
  • 添加了新的控制台命令:loop、cycletracks,是的,媒体播放仍然通过控制台操作
  • 更新了工具提示错误信息,从游戏的旧版本改为新版本。
  • 更新了动态音乐血月组件,因为它们已大幅调整至新系统
  • 移除了动态更新配置JSON的功能,配置JSON作为基础保留不变,游戏内会临时更新但保持配置JSON文件完整
  • 新增文件夹位置,用于在模组文件夹的文本文件中跟踪缓存。
  • 添加了模组文件的标签 (2.0),以保持标签一致性
  • 现在工具提示以"[CBM]"标签开头,取代了冗长的模组名称

问题:循环赛道与循环错误,未完成的代码

主要特点:

自定义音乐播放:

核心功能是在血月事件期间播放用户自定义文件夹中的音乐。该模组支持.mp3、.wav、.ogg和.m4a音频格式。

配置文件:config.json文件支持广泛的自定义设置。

  • 默认启用或禁用该模组。
  • 设置一个自定义热键,在游戏过程中切换音乐的开启和关闭。
  • 调整音乐音量,并选择是否遵循游戏的主音乐音量滑块。
  • 自动打乱播放列表 (shuffleTracks)。
  • 启用播放列表循环(cycleTracks)或单曲循环(loop)。
  • 定义歌曲之间的交叉淡出持续时间。

控制台命令:

该模组提供了一系列用于游戏内控制的命令:

  • 切换音乐:开启或关闭自定义音乐。
  • 下一首:跳到播放列表中的下一首曲目。
  • 上一条:返回到上一个轨道。
  • 暂停:暂停当前曲目。
  • stop:停止音乐播放。
  • shuffle:手动随机播放播放列表并开始播放。
  • 重新扫描:强制模组重新扫描音乐文件夹以查找新曲目。
  • loop:若启用,将循环播放播放列表中的所有曲目;若禁用,则单曲循环。
  • cycletracks:如果启用,则会循环播放列表中的曲目;但如果禁用,则会只播放一首歌曲。

状态处理:

  • 玩家死亡或暂停时,音乐自动暂停。
  • 当玩家在血月期间重生时,如果之前死亡时音乐正在播放,则音乐播放将恢复。
  • 当玩家断开与游戏的连接时,系统会清理其组件。

技术层面上,该模组使用Harmony库来修补游戏代码,专门针对GameManager.Update和AIDirectorBloodMoonComponent等游戏事件,以检测血月的开始和结束。

已更新 2.0 默认配置 JSON 示例

config json

{ "bloodMoonTracks": "Resources/BloodMoon" "volume": 0.8, "respectMusicSlider": true, "shuffleTracks": false, "fadeDuration": 2.0, "loop": true, "cycleTracks": true, "maxBloodMoonTracks": 50, "restoreVanillaMusic": true, "enableCustomMusicByDefault": true, "toggleKey": "Keypad9" }

用于自定义文件夹

使用 "bloodMoonTracks": "C:\Music\Rock", 自定义音乐文件夹路径请使用双反斜杠或正斜杠...

更加通用的模组关键功能:

自动播放:

血月开始时或进入正在进行的血月时会播放音乐,结束时停止播放。 如果设置为 true ,则默认启用自定义音乐,详情请参考下方的自定义设置。

支持的格式

从 Mods\CustomBloodMoonMusic\Resources\ 或自定义文件夹加载 .mp3、.wav、.ogg 或 .m4a 文件。

控制:

控制台命令:/play(开始/继续播放),/next(跳过当前曲目),/pause(暂停),/stop(暂停并记录位置),/shuffle(随机播放曲目),/togglemusic(启用/禁用),/rescan(重新加载曲目)。我认为你不再需要斜杠了,在控制台中直接输入单词即可。

按键绑定:按下数字键盘 9 可开启/关闭此模组。

自定义:编辑 config.json 以设置:

  • 音轨:适用于自定义文件夹和/或使用现有的Resources文件夹,以及该文件夹内的BloodMoon子文件夹来存放你的音频文件。例如,将"bloodMoonTracks"设置为你的自定义路径(如"C:\Music\");留空则使用默认的Resources/BloodMoon文件夹,如果没有音轨,则会播放原版音乐(至少理论上应该如此)。
  • 音量:0.0(静音)至 1.0(最大音量)。
  • respectMusicSlider:true, 启用游戏内音乐滑块集成(默认:true),但如果设置为 false,则回退到配置 json。
  • loop:True表示循环当前曲目;False表示停止,除非处于循环模式。
  • cycleTracks:True 在一首曲目结束后播放下一首。
  • maxBloodMoonTracks:50, 将血月轨迹上限设为(例如 50),但可配置。
  • restoreVanillaMusic:True 在禁用时恢复为游戏音频。
  • 视觉反馈:工具提示显示操作(如"跳到下一曲目")后跟当前曲目信息(如"正在播放曲目 2/3 (track2.mp3)")。
  • enableCustomMusicByDefault:true, - 当设置为 true 时,默认会播放自定义音乐,直接静默原版音乐,无需切换开关。除非你需要使用小键盘按键选项禁用它,此时会禁用并恢复原版音乐。
  • 如果设为假,则在血月期间需要手动激活,如果你更喜欢这种方式的话。

示例 记录日志:

  • 检查日志:%APPDATA%\7DaysToDie\logs\output_log.txt。
  • 像F1这样的预期日志,用于mod日志

配置加载示例:

  • 从以下路径加载配置:[modPath]\config.json
  • 配置已加载 - 曲目数:0,音量:0.8,循环:开,随机播放:开,文件夹:C:\Music\BloodMoonTracks

音频加载:

  • 正在扫描音频文件:C:\Music\BloodMoonTracks
  • 正在尝试加载:C:\Music\BloodMoonTracks\track1.mp3
  • Loaded track1.mp3

指令:

  • 曲目1/X已开始播放(track1.mp3)
  • 工具提示设置:[CBM] 音乐播放中!

使用方法:

  • 如果使用自定义文件夹(例如 C:\Music\BloodMoonTracks),里面包含一些 .mp3、.wav 或 .ogg 文件(无子文件夹),或者使用根文件夹中已有曲目的现有音乐文件夹。
  • 用路径位置更新config.json(使用\或/作为分隔符)。
  • 如果使用Mods资源文件夹,请创建一个,然后为你的音轨添加BloodMoon文件夹,这样如果只想听几首曲子而不是整个自定义音轨文件夹会更方便。
  • 启动时不开启EAC。仅限客户端,意思就是这只在你自己的电脑上有效,不能用在服务器上。每个想自定义音乐的客户端或电脑都需要在自己的电脑上单独安装这个模组,并且用自己的音乐,这样血月激活时才会播放自定义的音乐。
  • 读取存档,触发血月(在第7天设置时间21:00),或者使用DebugMenu调整时间,尽情测试吧!

已知问题:

  • 尝试让它在游戏内的聊天框中工作,但似乎失败了……按T键并输入这些/命令时没有游戏内聊天框……目前只能使用F1控制台命令……
  • 非服务器端...希望未来能实现这个功能
  • 如有任何其他问题,请务必反馈。

说明:

任何损坏的音乐文件都会在日志中显示为FMOD错误,提示不支持的格式。但系统会使用缓存,以便更快地为游戏加载你的曲目,无需每次手动加载。

(i. e 错误:无法为音频片段 "" 创建 FMOD::Sound 实例 (FMOD 错误:不支持的文件或音频格式。) CustomBloodMoonMusic: [2025-03-26 06:19:14] 曲目已缓存到 C:/Program Files (x86)/Steam/steamapps/common/7 Days To Die/7DaysToDie_Data/../Mods\CustomBloodMoonMusic\track_cache.txt )

轨道缓存: 将位于一个名为track_cache_bloodmoon.txt的文件中,以防那些希望在mod文件夹中查看具体加载了哪些歌曲的用户需要额外的日志记录。

不兼容任何其他音频模组,且如果您碰巧使用了任何静音模组、或其它自定义音乐模组或改版音频模组,这些模组也许会或也许不会与上述模组兼容,谁知道呢?可能行得通,但就我的测试而言......这主要是为原版用户准备的,他们想自定义血月音乐,最多算是个小小的罪恶享受。

如果 musicFolder 为空("")或无效,则默认为该 mods 文件夹中的 Resources 文件夹。 如果 tracks 不为空,则使用 musicFolder(若未设置 musicFolder,则使用 Resources)中的这些特定文件。

附注:你不需要在配置JSON中保留//或双斜杠的信息,因为这些只是注释,无论如何它都不会读取这些注释。

免责声明:

使用此模组即表示您承认TechFreq不对由此产生的任何问题、崩溃或冲突负责。 请自行承担使用风险。安装任何类型的模组前,请先备份您的游戏文件。 感谢下载,祝你玩得开心!

安装:

  • 确保 harmony mod 存在于模组目录中,因为它是必需的。
  • 下载模组文件,解压模组文件。
  • 请备份您的世界、存档或游戏文件。
  • 将它们放入你的《7日杀》游戏的Mods目录中。
  • EAC必须被禁用,尽管我希望未来这一点能够改变。截至目前,DLL并未获得EAC的支持,而XML没有问题,但遗憾的是这是一个DLL修改。
  • 这仅限客户端,但也许这可能也涉及服务器端和客户端的兼容性?
  • 无需进一步设置。尽情享受吧!

鸣谢:

再次感谢TheMeanOnes,特别感谢你提供的创意,占了20%,其余80%是我自己的代码!希望未来能看到更多项目和改进!

TheMeanOnes Discord服务器:https://discord.gg/jvDuq9SUQR

7 Days to Mod 官方Discord服务器:https://discord.gg/XVXK7aJpDH

感谢TechFreq & A.I、ChatGPT或Microsoft CoPilot A.I或来自Twitter/X的Grok AI帮助我创建了这个modlet,同时凭借我对游戏极其有限的模组知识以及边学边做,没有它们和整体的头脑风暴以及模组社区的支持,我无法完成这项工作。 我非常感激,同时也欢迎对模组的任何反馈。

支持通知:

对于那些想要支持'TecHfreqs'工作的人来说,这个Mod可能会或可能不会被交叉发布。通过7天死亡模组网站的ModsFire(含有广告,每次下载都会产生收益)下载,并且如果发布在那里或其他示例模组网站上会对我帮助很大,但是! (尽管每次下载需支付10美分)还有一个直接镜像可供使用,通过NexusMods网站也能获取直接链接,但这些链接的收益并非按点击或下载次数计算,而是通过另一种"捐赠积分"系统运作。支持TechFreq的最佳方式——除了下载模组、与朋友分享、留言反馈和为模组点赞之外——仅此而已。但如果你愿意更进一步(虽然非必需),可以通过PayPal或ko-fi页面的捐赠链接支持我,这同样能帮大忙! 然而,并非要求必须进行捐赠,每一份微小的支持都能在前进的道路上起到帮助,并激励未来更多的模组、音乐和漏洞修复。所以再次感谢您的阅读,感谢您一直以来的友善,并感谢您查看模组帖子。

社交媒体:

如果你欣赏TechFreqs的作品并想表示支持,可以使用这个捐赠链接,当然这不是必须的。 Kofi Page: https://ko-fi.com/techfreq

总体而言,我非常感谢您查看模组帖子,分享并享受其中的任何模组。再次感谢您!祝您游戏愉快!

喜欢这个模组?有反馈、想法或需要故障排除? 加入TechFreq Pretty Rad Squad的Discord服务器!https://discord.com/invite/SQCnGjNUhw 来Discord和我们一起聊天、看梗图,还能获取更多模组更新信息! 至于TechFreqs的音乐,它是免版税的音乐,可用于你的项目或作为休闲收听! 源音乐文件已准备好,欢迎随时在Discord中索取!或了解更多内容! TechFreqs 社交媒体:https://beacons.ai/techfreq 今天来看看幕后氛围!再次感谢大家查看模组帖子。

上次更新日志:

V1.6.0

  • 修复了死亡或血月结束时日志中重复出现"bloodmoonactive false"的问题。

V1.5.9

  • 修复了切换按钮开/关时出现的空值错误,第二次启用后和谐补丁失败。
  • 新增配置功能,"shuffleTracks": false,可配置值。若设置为 true,则会随机播放已加载的给定播放列表中的曲目,而非仅播放第一首曲目。您仍可使用 shuffle 命令获得类似效果,无论设置为 true 还是 false 均可。
  • 新增配置功能,"fadeDuration": 2.0,可配置血月音乐开始和结束之间的淡入淡出持续时间,默认值为2秒

V1.5.8

  • 修复了音量系统的问题,现在如果配置json中的respectMusicSlider:设置为false,可以通过配置文件进行调整。
  • 在配置JSON中添加了用于音量检查和动态更新的日志,以便实现更好的音量管理,并限制音量更新带来的日志冗余
  • 音乐滑块集成,使音量随音乐滑块调整,如果失败则回退到配置json。
  • 添加了动态配置重载或文件监视功能,以便在游戏运行过程中因卷标变化而重新加载配置 JSON。
  • 修复了暂停问题,使游戏暂停或玩家断开连接时能正确恢复和暂停自定义或原版音乐。

V1.5.6

  • 修复了在使用自定义动态音乐模组后,音乐被静音的问题,现已更改为自定义探索音乐模组,音乐播放几秒钟后突然结束
  • 修复了当 cycletracks 设置为 true 时,循环播放曲目却只播放一首歌的问题
  • 修复循环问题:现在当播放列表完全循环后,将从第一首歌曲重新开始循环播放。
  • 修复了使其能与自定义探索音乐模组兼容的问题,并在禁用时恢复原版血月音乐。
  • 为血月状态检查增加了更多调试日志,并移除了每条音轨上过多的禁用原版音乐消息,仅当模组启用或禁用时显示。
  • 更好的循环管理,当循环(Loop)启用时,若"循环曲目"设置为真,则循环播放列表中的曲目;若"循环曲目"设置为假,则只循环单个曲目。

V1.2V

-新增加, "enableCustomMusicByDefault": true , 值,以便它能在血月期间自动启动,无需每次手动切换,但若偏好设置为 false,可在配置 json 中进行相应设置。 -新增内容,可配置的小键盘绑定,默认设置为小键盘 9 -新增了更强大的日志功能,减少了冗余信息,同时提供清晰的内容,不再重复时间戳。 -希望与 v1.3 兼容,同时也要与 v1.4 兼容,因为这是我最近更新到的版本。

  • 使用上一首歌曲命令,曲目管理,
  • 移除重复或之前的轨道尝试,在我的另一个模组中已修复,使环境音效(如探索氛围和战斗音乐)能够自定义。

半最新更新日志: -修复了文件夹名称问题。部分用户因文件夹名称标记不正确导致模组无法正常工作——名称标签必须与modinfo.xml中的name属性值完全匹配才能生效。本次小更新已修复该问题,此修复适用于血月模式,经测试有效,但暂不适用于其他探索、战斗及悬疑类音轨。待我有空完全重制时,将推出移除这些内容的更新版。总之,尽情享受吧!

确保你的自定义文件夹路径使用双斜杠,并且"loop"表示循环播放整个播放列表,而不是单首歌曲,除非文件夹中只有一首曲目。如果你想要随机播放,将"cycletracks"设置为"off"以实现随机效果,反之亦然在配置文件中设置。

1.2L 来自 1.2B & D: 新增了更健壮的轨道文件夹,无需再在配置 JSON 中手动定义单个轨道,它会自动扫描文件夹内容,或者你也可以在配置 JSON 中定义,不知道我当时在想啥哈哈 为F1日志添加了/previous和previous命令,以便可以返回到上一个曲目 已添加模组禁用时的工具提示。 添加了额外的功能和调试日志,用于血月音乐活跃时。 添加了更强大的重新扫描或曲目缓存功能,以帮助预加载曲目,但请注意,在使用/rescan或rescan命令进行完整重新扫描时可能会出现卡顿或延迟,因为即使在游戏加载前,它仍然会进行重新扫描以防万一,但有时会使用txt缓存作为缓冲以确保匹配。但再次强调,它会对资源文件夹中音乐文件夹的每个类别进行曲目缓存,甚至可以使用自定义文件夹,并将该曲目缓存存储在模组本身的根文件夹中。 在播放曲目时,在F1日志中添加了更多调试日志或信息,且之前的来源未提及源文件夹。 为未来的构建版本增加了更多配置JSON选项,用于在游戏中操控探索、悬疑和战斗音乐曲目。但由于我遇到的问题比我预想的更多,请忽略这些选项,或者在配置JSON中将其定义为空值。 得益于Rizzrd的Custom Music Mod,我添加了一小段代码,但并没有加入太多,因为我们的概念不同。不过,我很高兴从他的开源代码中引用了一段内容,这帮助我弄清楚了如何使用EnumMusicutils来让血月音乐在禁用后或播放完毕后终于重新响起。

https://www.nexusmods.com/7daystodie/mods/6035 添加了控制音量的功能,嗯,可以算是通过整体音量控制实现的,再次感谢rizzards的代码,可以去看看他的模组,效果也很棒。不过由于这个问题,配置json中依然是独立的。

问题: 注意:如果模组在血月结束后才启用,那么原版音乐会处于静音状态,直到我能在未来的版本中找出解决方案,将探索、悬疑和战斗音乐与血月音乐结合并在更高情况下使用——此时音乐会静音。然而,在配置JSON中,如果将其设置为""而非Resources\CombatMusic文件夹(因为该路径用于识别要使用的曲目),那么如果找不到原版音乐,它将使用(或应该使用)原版音乐,反之亦然。 现在暂时忽略其他代码。 和以前一样的问题,没有内置游戏聊天命令,不是服务器端的,但至少原版的"血月"音乐回来了!

注意:此模组不兼容任何其他音频模组。如果碰巧使用了静音模组、其他自定义音乐模组或全面改造的音频模组,可能无法兼容。谁知道呢?或许能行,但根据我的测试……这主要针对原版玩家,那些想自定义血月音乐的人,最多算是个小小的罪恶快感。

更新的示例默认配置文件

"bloodMoonTracks": "Resources/BloodMoon" "explorationTracks": "Resources/ExplorationMusic" "suspenseTracks": "Resources/SuspenseMusic" "combatTracks": "Resources/CombatMusic" "homeDayTracks": "Resources/HomeDay" "homeNightTracks": "Resources/HomeNight" "volume": 0.8, "loop": true, "cycleTracks": true, "maxBloodMoonTracks": 50, "maxExplorationTracks": 20, "maxSuspenseTracks": 20, "maxCombatTracks": 20, "maxHomeDayTracks": 20, "maxHomeNightTracks": 20, "restoreVanillaMusic": false

V1.3 -将音轨配置功能从 JSON 文件转移到 Resource 文件夹中,以指定音轨所在文件夹的位置,无需再手动输入少量音轨。

  • 现在为 Resource 和 Custom 文件夹缓存曲目

V1.2