可听见的 打碎玻璃罐 的声音

可听见的 打碎玻璃罐 的声音

添加从罐子中饮水导致罐子破碎时的玻璃碎裂声。游戏中的罐子回收率设置完全静音——现在当你失去一个罐子时会听到声音。可配置的音效,支持自定义音频。

音频

这个模组有什么作用?

当你从玻璃罐喝水(水、茶等)时,有一个可配置的“罐子返还百分比”,决定你能否拿回空罐子或它会破碎。问题在于:罐子破碎时没有声音提示——你只能后来检查背包时才会发现。

这个模组会在你的罐子碎裂时播放玻璃破碎的声音。现在你可以立刻知道什么时候损失了一个罐子。


特色

  • 与游戏中的“瓶子返回百分比”设置(0-100%)兼容
  • 包含自定义玻璃破碎音效(免版税)
  • 可以使用内置的游戏音效或您自己的自定义音频
  • 可通过 XML 进行配置
  • 调试模式可用

工作原理

该模组会检测你何时从罐子中喝水,并检查是否有空罐子返回你的库存。如果没有,则会播放提示音。

当音效播放时:

  • 罐子返还 = 0% - 每次(所有罐子破碎)
  • 罐子返还概率 = 50% - 大约一半的几率
  • 罐子归还率 = 100% - 从不(所有罐子归还)

需求

  • 七日杀 V2.5 (b23)
  • 必须禁用 EAC(所有 DLL 模组都需要)
  • 无其他依赖

安装

  1. 下载并解压模组
  2. 将 AudibleBreakingGlassJars 文件夹复制到您的 7 Days To Die/Mods/ 文件夹中
  3. 你应该有:Mods/AudibleBreakingGlassJars/AudibleBreakingGlassJars.dll
  4. 在禁用 EAC 的情况下启动游戏

禁用 EAC:在 Steam 中右键点击游戏 > 属性 > 通用。在 选择启动选项 下拉菜单中选择 启动游戏时不使用 EAC。

卸载:删除 Mods/AudibleBreakingGlassJars/ 文件夹。


配置

在模组文件夹中编辑 Config/config.xml:

<?xml version="1.0" encoding="UTF-8"?>
<config>
    <SoundName>玻璃碎裂</SoundName>
    <DebugMode>false</DebugMode>
</config>

声音选项:

  • 玻璃碎裂声(默认)- 自定义的罐子破碎音效。默认采用此音效是因为游戏音效是为玻璃方块设计的,而非罐子。
  • 玻璃破碎 - 游戏内置音效 - 更响亮,像窗户碎裂的声音
  • 你自己的声音 - 将任意 .ogg 或 .wav 文件添加到 Sounds/ 文件夹中,在配置中设置文件名

使用你自己的声音:

  1. 将你的 .ogg 或 .wav 文件放置于 Sounds/ 文件夹内
  2. 在 config.xml 中将 SoundName 设置为文件名(不含扩展名)

调试模式: 设置 DebugMode 为 true 以获得详细日志。在游戏控制台中查找 [ABGJ-Debug] 消息。


模组兼容性

这个模组应当能很好地与其他模组兼容,因为:

  • 只读 - 检查库存数量,从不修改物品
  • 使用非破坏性的 Harmony 补丁
  • 与背包模组、背包装备扩展等兼容。

已测试环境:

  • ProxiCraft
  • AGF 背包模组

多人游戏

【尚未测试 - 风险自负。】

所有模组均使用标准游戏库存 API,且仅在本地客户端运行。我们预计它们仅需在客户端运行(无需服务器安装),但无法对此做出保证。

如果你尝试在多人模式中使用这些,请报告你的结果! 附加组件是可选的部分原因正是如此——需要更多测试。


源代码

本模组以 MIT 许可证开源。

在 GitHub 上查看


反馈与 Bug 报告

发现了 Bug?有建议?

在 GitHub 上报告问题

或在此模组页面留下评论。


附加模组(可选下载)

这些附加组件独立工作——你可以使用任意组合:


添加:破损罐子中的碎玻璃

v0.2.0

当玻璃罐因饮用而破碎时,你现在会获得 1x 碎玻璃 (resourceBrokenGlass)。让罐子破碎更真实——玻璃不会直接消失!

特性:

  • 当从饮用中打碎瓶子时,给予 1 块碎玻璃。
  • 先尝试背包,然后是工具带,如果都不行就丢到地上
  • 使用与主模组相同的检测方式(尊重罐子返还百分比)
  • 完全独立 - 无需安装主模组即可运行

安装: 将 AudibleBreakingGlassJars_Addon_BrokenGlass 文件夹复制到 Mods/


插件:制作返还罐子

v0.1.2

酿造时返还罐子规则变更。若使用罐中物品(如水等)进行酿造,空罐将在酿造开始时立即返还——但如果中途取消,液体将不予退还。

问题: 当你用罐子盛装的内容物(如水)进行合成时,原版会将罐子“保留”在合成后的食物中。你只有在吃掉该食物时才有可能取回罐子(基于罐子回收率)。这很奇怪——为什么吃玉米面包会给你一个空罐子?本模组会在你倒出液体开始烹饪时释放罐子。取消合成时,不会归还罐子类材料,液体成分也会丢失。

功能特点:

  • 当工艺任务开始时(而非完成时),返还空罐子
  • 取消操作不会退还罐内物品(水、茶等)
  • 智能检测:仅影响罐装内容配方
  • 例外:罐到罐的配方(水→茶)使用原版行为
  • 动态检测功能适用于具有正确属性的模组 jar 物品
  • 可选的手动物品覆盖 XML 配置

安装: 将 AudibleBreakingGlassJars_Addon_JarReturn 文件夹复制到 Mods/ 目录下

⚠️ 推荐:VanillaJarFix

为了获得最佳效果,请配合使用 VanillaJarFix。原版存在一个数据错误,导致许多固体食物(如玉米面包、煮熟的肉等)错误地具有罐子属性。VanillaJarFix 会移除这些错误的属性。我们的附加组件则会正确处理真正的罐装液体——在你倒出时释放罐子,而不是在食用时。两者结合,让罐子处理变得合理。


附加内容兼容性

  • 主模组 + 碎玻璃: 播放声音并产生碎玻璃
  • 主模组 + 罐子归还: 饮用时播放音效;制作时归还罐子
  • 三者合一: 完整的罐子体验!
  • 不含主模组的附加组件: 可独立正常运行
  • VanillaJarFix: 互补性修正 - 修复错误数据(带有罐子属性的固体食物),我们的附加组件修正行为(当罐子被释放用于实际液体时)

更新日志

v1.1.0 - 可听见的玻璃罐破碎声

  • 已修复:罐子返回工具腰带时错误触发了破裂音效(由 DanColeman86 报告)
  • 已修复:掉在地上的罐子(背包已满)错误触发碎裂音效
  • 播放声音前,现在会检查背包、工具腰带和附近掉落的物品

v1.0.0 - 玻璃罐破碎有声

  • 首次发布
  • 通过物品数量比较检测罐子是否被破坏
  • 自定义音效加载(OGG/WAV)

v0.2.0 - 碎瓶碎玻璃

  • 修复:罐子返回工具带时错误地给了碎玻璃
  • 修复:罐子掉落地面时(背包已满)错误地给出了碎玻璃
  • 现在检查背包、工具腰带和附近地面掉落物

v0.1.2 - 制作时返还罐子

  • 修复:队列已满漏洞 - 当制作队列已满时,不再给予免费罐子
  • 现在能正确检测到制作失败且不消耗材料的情况

v0.1.1 - 制作时返还罐子

  • 添加了调试模式开关(减少日志垃圾信息)
  • 现在只有在启用调试模式时才会显示罐子回收日志

v0.1.0 - 插件初始版本发布

  • 破损罐子的碎玻璃 - 当罐子破碎时获得碎玻璃
  • 合成时返还罐子 - 在开始合成时返还罐子