[SBW]SuperbWarfare-隐身—由KarlKarlmann制作—桥梁

[SBW]SuperbWarfare-隐身—由KarlKarlmann制作—桥梁

一个非官方桥接插件,将SuperbWarfare的枪械与Stealth的AI连接起来。

概述

本附加组件专为 SuperbWarfare 枪械设计,以室内战斗——例如在 The Lost Cities 中清理废弃建筑——作为主要目标环境。

  • 室外:发射未安装消音器的步枪会从远处吸引敌人,带来触发怪物潮的紧张感。
  • 室内:为冲锋枪装备消音器并有条不紊地清理房间,可以让你在大部分行动中保持不被发现地清理整栋摩天大楼。

在标准的 SuperbWarfare 环境中,枪声仅作为音效播放,不会传到监守者(Warden)那里,而消音器只是替换音频文件,并不会改变实际可听距离。本附加组件填补了这些空白,以提供真正的潜行射击体验。

特性

  • 真实的枪声传播范围:步枪的声音在开阔区域传播很远,而手枪则保持在较小的范围内,根据每把枪的音量惊动敌人。
  • 墙壁与地板削弱声音:坚固的墙壁、地板和天花板会削弱穿过它们的声音。
  • 声音绕过敞开的门传播:即使直线视线被阻挡,声音也会通过敞开的门、楼梯间和走廊绕过拐角传播。

注意:本模组使用基于 Minecraft 方块碰撞的轻量级启发式算法,而非沉重的声学光线追踪,以保持游戏流畅。

  • 功能性消音器:大幅降低侦测范围(默认降低约 75%)。在原生 SBW 消音器属性的基础上,可以自由配置自定义的属性权衡(默认略微增加子弹散布)。
  • 多人游戏中同步其他玩家的音频:除了怪物 AI 侦测外,多人游戏中其他玩家听到的枪声音频也会按侦测半径等比例缩小。
  • 监守者与幽匿集成:枪声会激怒监守者并触发附近的幽匿感测体。
  • 游戏内声音可视化:在聊天中输入 /superbstealth debug 可看到彩色粒子路径,显示声音如何传播(绿色 = 直接到达,黄色 = 通过门绕行,红色 = 被墙壁削弱)。

一切均可在 config/superbstealth-common.toml 中调整(墙壁削弱惩罚、消音器范围、武器属性倍率等)。

开发与 AI 披露

本模组的代码主要是在 AI 辅助下开发的。虽然我理解整体架构和每个类的作用,但我并不一定了解语法的每一个细节。

尽管如此,它已在游戏内和内部进行了充分测试,在我的个人环境中运行非常流畅。我也在重构和代码注释上投入了心思,所以有兴趣的开发者非常欢迎查看 GitHub 仓库!

如有功能建议或错误报告,请在 GitHub 上提交 Issue,我会在时间允许时处理。

前置要求

  • Minecraft 1.20.1 (Forge 47.3.0+)
  • SuperbWarfare (0.8.9.2+)
  • Stealth by Karl Karlmann (1.1.100+)
  • Kotlin for Forge (4.12.0)

致谢

非常感谢 SuperbWarfare 和 Stealth by Karl Karlmann 的作者们制作了如此出色的模组!


概要

本 Mod 是面向 SBW 枪械的附加组件,以“The Lost Cities”等废墟建筑群中的室内战斗作为设想环境之一进行开发。

  • 野外:未安装消音器的步枪射击声会吸引远处的敌人,有时能体验到触发怪物潮般的紧张感。
  • 室内:手持装有消音器的冲锋枪谨慎行动,可以在大部分时间里不被敌人发现地压制并清理整栋大楼。

在标准的 SBW 环境中,枪声仅作为音效播放,不会反映到监守者的声音识别系统中,因此本 Mod 构建了一个简易的声学模型来补全这一点。

功能列表

  • 枪声引起注意:步枪声音传得远,手枪则局限于较小范围,敌人会根据每把枪的音量做出反应。
  • 墙壁和地板削弱声音:隔着厚墙、天花板或地板时,声音会被遮挡而难以传播。
  • 门敞开时声音会绕行:即使直线被遮挡,声音也会通过敞开的门、楼梯和通道绕行传播。

不使用光线追踪等,而是利用 Minecraft 的方块判定进行轻量级简易声学模型处理,因此对性能没有重大影响。

  • 消音器:侦测范围大幅缩小,远处敌人难以察觉(默认削减约 75%)。此外,安装消音器时的惩罚,除 SBW 本体已有设置外,还可通过配置文件自由设置权衡。(默认仅略微恶化弹着点集中性)
  • 与多人游戏中其他玩家的听觉联动:不仅是怪物 AI 判定,多人游戏时其他玩家听到的枪声也会根据侦测范围相应变小。
  • 监守者与幽匿也会反应:听到枪声的监守者会愤怒,幽匿感测体也会做出反应。
  • 游戏内可视化声音传播方式:在聊天中输入 /superbstealth debug,声波轨迹将以粒子形式显示(直接到达为绿色,通过门绕行为黄色,被墙壁消音的路線为红色)。

可通过 config/superbstealth-common.toml 细致调整墙壁衰减率、消音器消音倍率、枪械性能惩罚等。

关于 AI 使用

本 Mod 的代码主要借助 AI 辅助编写。我本人理解整体设计和各个类的职责,但并未完全掌握代码的每一个细节。

尽管如此,已在游戏内外进行了充分测试,在我的环境中运行流畅。

在重构和注释方面也投入了一定精力,有兴趣的开发者请务必查看 GitHub。

GitHub: KAMONEGINABE/-SBW-SuperbWarfare-Stealth-by-Karl-Karlmann-Bridge

关于新功能建议或问题报告,请通过 GitHub Issue 等方式告知,我会在时间允许时处理。

前置 Mod

  • Minecraft 1.20.1 (Forge 47.3.0 及以上)
  • SuperbWarfare (0.8.9.2 及以上)
  • Stealth by Karl Karlmann (1.1.100 及以上)
  • Kotlin for Forge (4.12.0)

致谢

感谢制作了出色原 Mod 的 SuperbWarfare 及 Stealth by Karl Karlmann 的作者们!