自定义业余无线电播放器模组 (V2.6) (V2.5) (v2.0) V1.4) x 客户端 一个使用业余无线电定制的音乐播放器,将其改装为便携式音乐播放器

自定义业余无线电播放器模组 (V2.6) (V2.5) (v2.0) V1.4) x 客户端 一个使用业余无线电定制的音乐播放器,将其改装为便携式音乐播放器

CustomHamRadioPlayer模组强化了《七日杀》,新增了一套半功能完整的业余无线电系统,使玩家能在游戏中播放自定义音乐曲目,支持两种模式,并能放置无线电设备实现(基于距离的音频播放)。

音频

自定义业余无线电模组为《七日杀》增添了一项半功能完整的业余无线电系统,让玩家能在游戏中播放自定义音乐曲目。它支持两种模式:放置收音机实现(基于距离的音频),或使用背包中的收音机随身收听(非空间音频)。

该模组提供了一个交互式放射菜单、控制台命令和强大的音乐管理功能,所有功能无缝集成到游戏环境中。

最新更新日志:

V3.9 (V2.6)

感谢谷歌的反重力智能代理IDE和Gemini 3.1 Pro AI模型

以下是您的原始代码与优化代码之间确切差异的清晰分解,重点说明了这些更改为何对“7 Days to Die”模组的性能至关重要。

  1. 区块扫描延迟峰值(CheckForRadioPlacement)

    • 之前:当玩家放置收音机时(通过检测库存数量减少),你的代码运行了一个三层嵌套的for循环。它会检查玩家周围11x7x11的网格,在单帧内调用GameManager.Instance.World.GetBlock()超过1180次。这会导致严重的CPU卡顿峰值。
    • 之后:游戏已经通过 BlockAddedPatch 告诉我们何时放置了方块,从而填充了 PlacedRadios 字典。优化后的代码不是扫描 1,180 个方块,而是仅针对 PlacedRadios 中已知存在的少数收音机进行一次简单的距离计算(Vector3.Distance)。
  2. 字符串分配内存泄漏(UpdateInteractionPrompt)

    • 之前:玩家每次看向电台(每秒超过60帧),你的代码都会获取玩家的按键绑定,去掉曲目名称的文件扩展名(LastIndexOf(‘.’)),并生成全新的字符串($"Press {keyMarkup}...")。这会带来严重的“垃圾回收”(GC)压力,导致Unity在清理丢弃的字符串时出现微卡顿。
    • 之后:我添加了缓存变量(lastFocusedPos、lastIsRadioActive等)。提示字符串现在仅在查看收音机时构建一次,并且仅在曲目更改或收音机暂停时更新。不带.mp3扩展名的曲目名称也在加载时永久缓存。
  3. 字典查找瓶颈(GamePrefs.GetFloat)

    • 之前:在UpdateProximityAudio和UpdateInventoryRadio中,代码每帧都会调用GamePrefs.GetFloat(EnumGamePrefs.OptionsMusicVolumeLevel)来检查音乐滑块。GamePrefs在底层是一个字典查找,导致持续调用时速度异常缓慢。
    • 之后:我创建了一个 CurrentMusicSlider 属性。它每秒检查一次游戏的音量设置并缓存该值。模组的其余部分仅读取缓存的变量。
  4. 反射瓶颈(更新中的Enum.TryParse)

    • 之前:为了检查玩家是否按下了切换键,你的Update()循环每一帧都运行了Enum.TryParse(Config.toggleKey, out result)。Enum.TryParse使用了Reflection和字符串解析,这是Unity中经典的性能杀手。
    • 之后:配置.json中的字符串在模组首次加载时被精确解析一次,并保存到cachedToggleKey中。更新循环现在仅执行近乎免费的Input.GetKeyDown(cachedToggleKey)。
  5. 缓慢的组件搜索 (GetComponent)

    • 在您的静态方法(如 PlayCurrentTrack() 和 StopMusic())中,您通过 musicObject.GetComponent<HamRadioManager>().StartCoroutine(...) 启动了协程。GetComponent 会强制 Unity 搜索游戏对象上附加的脚本,这个过程较慢。
    • 之后:我在 Awake() 中添加了一个静态 Instance 变量。协程现在通过 Instance.StartCoroutine(...) 立即触发,完全跳过了组件搜索。
  6. 音频源属性垃圾信息

    • 之前:在Update中运行的方法每帧都在不断覆盖AudioSource上的属性(如volume、spatialBlend和mute),即使这些属性没有发生任何变化。
    • 之后:这些属性严格在InitializeAudioSource()期间设置。音量只在淡入/淡出或当CurrentMusicSlider检测到游戏设置发生变化时更新。
  7. 径向菜单数组分配(BlockActivationPatch)

    • 之前:每当游戏检查收音机的径向菜单命令时,你的Harmony补丁就会运行新的BlockActivationCommand[] { ... },每次都创建一个新的数组到内存中。
    • 之后:这6个命令的数组现在是静态的(cachedCommands)。它会被创建一次并永久复用。

总结:你的原始逻辑运行得很完美,但每秒都在进行成千上万不必要的计算和内存分配。优化后的代码执行完全相同的操作,但缓存了繁重的计算部分,因此只使用了少量CPU和内存。

2026年5月11日

最后但同样重要的是,修复了径向图标问题,哇!!!

Even Semi 最新更新日志:

V3.8(V2.5)

  • 更新并修复了该模组不允许用户在该场景中结算容器或搜刮物品的问题
  • 由于模组中的方块激活文本和获取命令代码,应该修复!这样它就不会被隐藏了。
  • (径向图标问题仍然存在)

半最新更新日志!

V3.7 (V2.5)

  • 已更新至V2.5版本,特别感谢HeyWood1010!!哇!感谢你在Discord上联系我,再次表达我的感激之情,能有志同道合的创作者无条件地做这样的事情,真是最珍贵的支持!
  • 尽管为V2.5升级了,但他们从根本上通过持续改变游戏代码,修复了已发布补丁或方法!就像我会做的一样,但对于这一点,我感激不尽,因为工作和生活平衡一直是个挑战,不过无所谓了。
  • 因游戏内代码变更而导致初始区块补丁激活指令或红色空引用方法的问题
  • 引擎盖下还有更多东西,哈哈
  • 修复了禁用单选按钮或切换时交互问题
  • 修复了音频的方块放置问题,实现了无缝放置以及物品栏2D到3D音频空间切换,太棒了!
  • 修复了切换曲目时命令切换导致音频暂停或销毁关闭,并从播放列表的第一首歌曲重新开始的问题。
  • 修复了测试音效停止播放的问题
  • 但在重新扫描时,它可能会播放该内容,但不会在游戏启动时播放。
  • 修复了可能不显示“未找到业余无线电设备?”工具提示消息的问题
  • 总体功能终于正常工作了!
  • 附注:他使用的是废土模组进行测试,所以我推测它与这个整体大改有所兼容,试试看吧!!
  • 修复了科学名称!耶!
  • 新增配置行,用于在测试期间切换测试音的开启或关闭,如果你决定将其放在配置文件JSON文件的底部的话。
  • 更新了自述文件和CS文件,以添加署名及附加信息。

已知错误:

  • 径向图标
  • 可能是一些学名,哈哈
  • 比如 blockcommands_toggle、blockcommand_play,在之前的版本中,这总体上来说简直太棒了!!

再次强调,这仅适用于客户端。如果安装在专用服务器上,它只会为您的客户端播放,不会共享音乐或音频,但这一点尚无法确认。

最新更新日志:

V3.6 (V2.0)

  • 已为2.0更新
  • 游戏版本 1.4 中的 V3.5 或 V3.4 Beta 同样存在这些问题
  • 修复了2.0升级新错误的显示提示信息问题

主要功能:火腿电台方块:

玩家可以在世界中放置“收音机火腿”方块,它会作为一个音乐源,根据距离播放音频(音量随距离递减,可通过minDistance=2m和maxDistance=30m配置)。而不仅仅是一个装饰性方块。

该方块支持径向菜单(按住E键访问),包含以下选项:打开/关闭收音机、播放/暂停、下一曲、上一曲、随机播放曲目,以及拿起(拾取收音机)。

库存无线电功能:

如果一个玩家,切换了已放置的无线电方块并从径向菜单中选择播放一个曲目,同时他们的物品栏中有火腿无线电物品,我假设他们可以在物品栏中使用切换键将其打开或关闭,但理论上应该播放跟随他们的音乐(非空间化音频,spatialBlend=0)。

确保放置的收音机和库存中的收音机之间通过淡入淡出持续时间实现无缝过渡。

音乐播放:

从以下位置加载自定义音频文件(MP3、WAV、OGG、M4A格式): ‘C:\Program Files (x86)\Steam\steamapps\common\7 Days To Die\Mods\CustomHamRadioPlayer\Resources\HamRadioTracks’ 文件夹或自定义文件夹,请确保在自定义目录中使用双反斜杠。

支持多达 50 个轨道(可配置),并具备缓存功能以优化加载。

功能包括播放、暂停、下一曲/上一曲、随机播放和重新扫描曲目,均可通过径向菜单或控制台命令使用。

控制台命令:

按 F1 键打开控制台,输入以下命令进行媒体播放。

  • hplay:开始或恢复播放。
  • hnext: 跳转到下一曲。
  • 上一曲:跳转到上一个曲目。
  • hpause: 暂停或继续播放音乐。
  • hstop: 停止音乐并禁用收音机。
  • hshuffle: 随机播放曲目列表。
  • hrescan: 重新从文件夹加载轨道。

近距离音频:

  • 对于放置的收音机,音频是空间化的(spatialBlend=1),音量根据与收音机的距离进行缩放(线性衰减)。
  • 若在 config.json 中启用,则尊重游戏音乐音量滑块。

半世界持久性:

  • 世界重新加入或游戏清理时音乐状态会重置,以防止退出游戏前收音机音乐未关闭导致不必要的播放,但重新加入游戏时若保持音乐开启则情况不同。
  • 切换或更换电台时,轨道会正确暂停位置并恢复播放。

配置:

可通过config.json进行配置:

"hamRadioTracks": "Resources/HamRadioTracks",
"volume": 1.0,
"respectMusicSlider": true,
"maxHamRadioTracks": 200,
"debugLogging": true,
"maxDistance": 30.0,
"minDistance": 2.0

允许自定义曲目文件夹、音量、距离设置和调试日志记录。

视觉提示与反馈:

  • 显示游戏内动作的工具提示(例如,“正在播放曲目1/4”、“无可用曲目”)。
  • 广泛的调试日志记录,以协助故障排除。

技术细节:

  • 代码库:使用C#编写,通过Unity和Harmony来修补游戏功能。
  • 使用Harmony修补Block.GetBlockActivationCommands以用于径向菜单选项。
  • 补丁:当与收音机交互时,会拦截《方块。激活方块》事件。
  • 补丁:GameManager.PlayerSpawnedInWorld 和 GameManager.Cleanup 重置无线电状态。

部署

已知的各种问题:

  • 在游戏中加载带有mp3文件的mod时,建议将MP3转换为16位PCM WAV格式(44100Hz,立体声),以避免Unity播放问题。
  • 这是一个很好的细节警告消息,但并非必需。暂时忽略这条消息。
  • 按下R键时,即使在物品栏中,也会显示“未放置的收音机或物品栏中未找到收音机”。
  • 这是R键切换功能的代码,现在改为使用等号键来控制无线电的开启或关闭。旧代码中用于切换的按键如S键或其他切换键,可能会同时切换、更改或播放下一曲目,需要修复这个问题。
  • 如果从等号键按钮禁用无线电模块,它将显示一个提示,说明其禁用的音乐已停止,但为了再次启用该模组,你可以在控制台中输入“htoggle”来重新启用模组及其功能,否则如果不这样做,收音机将只允许你拾取物品。
  • 如果配置设置为循环曲目或循环处于激活状态,它循环的是同一首单曲,而不是它检测到的歌曲播放列表,不仅如此,在播放结束后它也不会切换到下一首。
  • 如果通过配置文件调整音量,也不会动态更新,目前使用音乐滑块应该可以正常工作。
  • 至于最后一个但同样重要的问题,我播放音乐的方式是:我把方块放下来,或者从商人那里拿一个放到别处,按E键打开径向菜单,用播放或下一曲按钮播放曲目,然后再按E打开径向菜单,拿起收音机就能听到音乐播放了,虽然挺酷的,但是有bug——近距离音频不工作,不过放在背包里似乎能正常使用…

免责声明:

使用此模组即表示您确认TechFreq不对因其使用而引起的任何问题、崩溃或冲突负责。

自行承担风险。安装任何类型的模组前,请备份您的游戏文件。

感谢下载,希望你喜欢!

安装:

  • 确保和谐模组存在于模组目录中,因为它是必需的。
  • 下载模组文件,解压模组文件。
  • 请备份您的世界、存档和/或游戏文件。
  • 将它们放入你的《7 Days to Die》游戏的Mods目录中。
  • EAC必须被禁用,不过我希望未来这一点能够改变。目前DLLS还无法通过EAC支持,但XML没有问题,不幸的是,这是一个DLL修改。
  • 这仅是客户端侧,但也许这也涉及到服务器端和客户端的兼容性?
  • 无需进一步设置,尽情享受吧!

鸣谢:

感谢TechFreq & AI、ChatGPT或微软Copilot AI、Twitter或X的Grok AI,帮助我创建了这个模组。我几乎没有游戏模组制作经验,边学边做,没有这些工具和整个模组社区的集思广益,我无法完成这项工作。

我非常感激,并且也欢迎对模组的任何反馈。

支持通知:

对于那些想要支持‘TechFreqs’工作的人,此模组可能会或可能不会跨平台发布。通过7daystodiemods网站从ModsFire(基于广告的下载,每次下载都会产生收益)进行下载,如果模组发布在该网站或其他类似的模组网站上,这对我帮助很大。然而!

(尽管每次下载仅需支付10美分)此外还可以直接使用NexusMods网站的镜像,该网站也提供直接链接,但此类链接并非按点击或下载次数计费,而是通过另一种体系以捐赠点数形式运作。支持TechFreq的最佳方式——下载模组、与朋友分享模组、留下反馈并对模组表示认可——已是我所求的全部;但若您想额外支持(非必要),也可通过PayPal或ko-fip平台的捐赠链接给予帮助。再次感谢!

不过,捐款并非强求,每一份支持都能在途中提供帮助,并为未来更多模组、音乐和Bug修复注入动力。再次感谢您阅读本内容,感谢您一直以来如此出色,也感谢您点开这个模组帖子。

社交媒体:

如果你欣赏TechFreqs的工作并希望表示支持,可以使用这个捐赠链接,尽管这不是必须的。

  • Kofi 页面:https://ko-fi.com/techfreq
  • 总的来说,非常感谢你查看模组帖子、分享和享受任何模组。再次感谢!并祝游戏愉快!
  • 喜欢这个模组吗?有反馈、想法或需要解决疑难问题吗?
  • 加入TechFreq Pretty Rad Squad Discord服务器!https://discord.com/invite/SQCnGjNUhw
  • 在Discord上和我们一起聊天、分享梗图,获取更多的模组更新吧!
  • 至于TechFreqs的音乐,它是免版税音乐,可供你在项目中使用或日常聆听!
  • 源音乐文件可随时索取,可在Discord中获取!或获取更多内容!
  • TechFreqs 社交平台:https://beacons.ai/techfreq
  • 看看今天的幕后花絮!再次感谢你查看模组帖子。

之前的版本更新日志:

3.5

  • 将轨道限制更改为200条轨道,注意如果同时加载所有轨道可能会导致性能负载。
  • 删除了其他mod中影响游戏内重叠的其他键位切换相关行
  • 固定的和谐行,用于模组日志
  • 待定,与之前的问题相同,涉及径向菜单图标、文本及近距离语音功能。