GD656FrontVoice

模组

· 作者 Minecraft_GD656

GD656FrontVoice 添加了基于阵营的战斗语音提示——包括换弹、手雷、击杀和压制警报,并支持中文/美式/俄式语音包。兼容 TACZ,通过原版队伍系统检测敌人。

0 本站下载 0 关注 更新于 3 个月前
一键开服(送7天)

概览

GD656FrontVoice 是一款 Minecraft 模组,为多人服务器添加了动态战斗语音系统。它会根据战斗事件(如受到伤害、投掷手雷、换弹、击杀敌人、被火力压制等)播放阵营特定的语音提示——包括中文 (CN)、美式英语 (US) 和俄语 (RU)。

最后更新:2026年7月25日。部分功能可能尚未完全记录或存在变动。

兼容性

  • 强烈建议搭配 TACZ (Timeless and Classics Zero) 1.1.7-hotfix 或更高版本 —— 大多数战斗事件触发器依赖于 TACZ 的事件系统和枪械类型 API;
  • 与 LR Tactical 软兼容 —— 检测投掷实体以用于手雷警报和投掷提示,以及燃烧减益效果以检测玩家是否着火;
  • 与 GD656Conquest 软兼容 —— 解析阵营/营地信息以进行语音包路由;
  • 目前仅支持 Minecraft 1.20.1 Forge。

服务器安装

该模组分为客户端和服务端功能。两端均需安装才能实现完整功能。

仅服务端功能:

功能 说明
战斗事件检测 监听 TACZ 的枪械开火、换弹、击杀事件以及原版伤害/死亡事件
火力压制走廊系统 当子弹从玩家附近掠过时累积压制层数,达到阈值时触发语音提示
投射物近失检测 追踪狙击子弹和 RPG 火箭弹,在投射物经过附近时提醒玩家
手雷警报扫描 每 tick 扫描附近的敌对投掷物,并向受威胁的玩家发出警告
弹药空仓检测轮询 每 tick 检查玩家手持 TACZ 枪械的弹药状态
燃烧检测 检测玩家是否处于着火状态(原版火焰或 LR Tactical 易燃效果)
手雷投掷检测 检测玩家是否开始引燃手雷/莫洛托夫鸡尾酒/烟雾弹
基于营地的语音路由 根据每位玩家所属阵营决定使用哪个语音包 (CN/US/RU)
音频数据包广播 向目标客户端发送 ClientboundPlayAudioPacket

仅客户端功能:

功能 说明
语音提示播放 接收数据包,通过 CueRouter 解析语音提示并播放声音
第一人称 / 第三人称路由 为自己播放本地(非位置性)声音,为其他玩家播放位置性声音
音频节流控制 限制每位玩家同时播放的声音数量及每种类型的上限,防止刷屏
配置与命令系统 /gdfv 客户端命令,用于调试和配置管理
营地视角覆盖 客户端侧的友军/敌军检测可覆盖服务端分配的语音包

简而言之:服务端负责检测和触发所有语音事件;客户端负责播放、路由和节流控制。网络流量极小(仅一种自描述数据包类型 ClientboundPlayAudioPacket)。

配置与命令

所有参数均可通过 Forge 模组配置界面进行调整,或使用游戏内命令:

/gdfv debug summary              显示音频清单统计信息
/gdfv debug list [filter]        列出已注册的音效事件
/gdfv debug play local <sound_event> [volume] [pitch]
/gdfv debug play position <sound_event> <pos> [volume] [pitch] [distance]
/gdfv debug play entity <sound_event> <entity> [volume] [pitch] [distance]
/gdfv debug play cue <voice_cue> <camp> <entity> [volume]
/gdfv config reload              热重载配置文件

命令需要权限等级 2(服务器操作员)。配置更改立即生效;支持通过基于反射的配置重载实现运行时热重载。

关键配置选项

服务端 (common) 配置:

配置项 默认值 描述
audio.serverEnabled true 音频广播的主服务端开关
audio.serverMasterVolume 1.0 全局音量乘数 (0.0–4.0)

客户端配置:

配置项 默认值 描述
audio.enabled true 主客户端播放开关
audio.friendlyVoicePack CN 友军玩家的语音包(未安装 GD656Conquest 或被忽略时使用)
audio.enemyVoicePack US 敌军玩家的语音包(未安装 GD656Conquest 或被忽略时使用)
audio.detectEnemyByVanillaTeam true 使用原版队伍 (isAlliedTo) 检测敌军玩家,无需安装 GD656Conquest 即可工作
audio.ignoreConquestCamp false 忽略 GD656Conquest 的营地分配,改用友军/敌军配置
audio.fallbackThirdPersonForLocal true 若缺少第一人称变体,则回退到第三人称声音
audio.masterVolume 1.0 主客户端音量 (0.0–4.0)
audio.firstPersonVolume 1.0 第一人称声音的额外音量乘数 (0.0–4.0)
audio.thirdPersonVolume 1.0 第三人称声音的额外音量乘数 (0.0–4.0)
audio.maxSimultaneousSingleTpSound 2 同时播放的同类型第三人称声音最大数量
audio.maxSimultaneousTpPlayersFriendly 3 同时发出第三人称声音的友军玩家最大数量
audio.maxSimultaneousTpPlayersEnemy 3 同时发出第三人称声音的敌军玩家最大数量
audio.maxThirdPersonDistance 48.0 听到第三人称声音的最大距离(方块单位)

功能

事件驱动语音提示

以下语音提示由服务器上的特定游戏内事件触发:

语音提示 触发条件 播放方式
DEATH 玩家死亡(LivingDeathEvent),且非旁观模式 分层:第一人称死亡音效 + 对自己播放的特效音;第三人称队友对附近队友死亡的反应
EXPLOSION_CLOSE 玩家受到爆炸伤害但存活(生命值 > 0) 第一人称对自己播放,1秒冷却时间
LOW_HEALTH_PANIC 玩家生命值降至 5.0 以下(半颗心 × 5) 第一人称对自己播放,每次低血量阶段仅触发一次
HEAVY_HURT 玩家受到 TACZ 子弹伤害(非狙击枪、非 RPG、非爆炸伤害)并存活 第一人称对自己播放,10秒冷却时间,若同一刻有更高优先级的提示触发则静音
BURNING 玩家处于着火状态(原版)或拥有 LR Tactical lrtactical:flammable 效果 分层第一人称:尖叫 + 火焰 + 火花,每次燃烧阶段仅触发一次
REQUEST_AMMO 玩家手持的 TACZ 枪械弹匣弹药为零、枪管剩余弹药为零,且背包中无匹配弹药 第一人称对自己播放,每次空仓阶段触发一次;空仓时每秒重新检查一次,上膛时每 3 秒重新检查一次
GRENADE_ALERT 敌方 LR Tactical 高爆手雷在 5 格半径内 第一人称对自己播放,每 5 个游戏刻扫描一次;排除自身的手雷
THROW_GRENADE 玩家开始引燃 LR Tactical 高爆手雷或莫洛托夫鸡尾酒(按住右键) 第三人称向追踪玩家广播
THROW_SMOKE 玩家开始引燃 LR Tactical 烟雾弹(按住右键) 第三人称向追踪玩家广播
RELOADING 玩家装填 TACZ 枪械(GunReloadEvent) 第三人称向追踪玩家广播,1秒冷却时间
SUPPRESSED 1 秒内积累 6+ 层来自非机枪火力的压制效果(见 压制火力走廊) 第一人称对目标播放,4秒冷却时间
MACHINE_GUN_ALERT 1 秒内积累 6+ 层来自机枪火力的压制效果 第一人称对目标播放,4秒冷却时间
SUPPRESSING_HOSTILE 射手在 1 秒内对敌人积累 9+ 层压制效果 第一人称对射手播放,4秒冷却时间,受 1 秒激进提示间隔门控限制
SNIPER_ALERT 狙击子弹从玩家身边 5 格内飞过,或玩家首次被狙击枪击中 第一人称对目标播放,3秒冷却时间
RPG_ALERT RPG 火箭弹从玩家身边 10 格内飞过,或玩家首次被 RPG 击中 第一人称对目标播放,3秒冷却时间
KILL_ENEMY 玩家使用 TACZ 枪械击杀敌人(非爆头,或附近没有适合“精彩一击”的盟友) 第一人称对击杀者播放
NICE_SHOT 玩家获得爆头击杀,且附近有盟军观察者在 5 格内 第三人称对附近的盟军观察者播放
FRIENDLY_FIRE 玩家击杀队友,且附近有盟军观察者在 2 格内 第三人称对附近的盟军观察者播放,4秒冷却时间
TEAMMATE_DOWNED 附近有一名队友阵亡 第三人称向附近盟友广播(通过 GDCQ 死亡延迟机制触发)

压制火力走廊 (Suppression Fire Corridor)

当玩家开火 TACZ 枪械时,服务器会计算一个火力走廊——这是一个从射手眼睛位置向前延伸24 格、沿其视线方向半径为1.6 格的圆柱体体积。位于此走廊内的所有敌对、存活且非旁观模式的玩家各获得一层压制效果。

  • 每个目标的压制层数在获得第一层后的20 个游戏刻(1 秒)后过期
  • 6 层:在目标身上触发 SUPPRESSED(如果所有层数均来自机枪,则触发 MACHINE_GUN_ALERT)
  • 9 层:额外在射手身上触发 SUPPRESSING_HOSTILE
  • 冷却时间防止重复刷屏:针对受压制目标为 4 秒,针对压制他人的射手为 4 秒,并设有 1 秒的激进提示间隔门控

投射物近距掠过检测

当 TACZ 子弹实体生成时(EntityJoinLevelEvent),服务器开始对其进行追踪。每个游戏刻,追踪中的投射物按枪械类型分类:

  • 狙击子弹(枪械类型为 sniper):近距掠过半径为5 格
  • RPG 火箭弹(枪械类型为 rpg):近距掠过半径为10 格

对于每个投射物,使用线段与膨胀盒相交测试,检测其上一帧和当前帧之间的移动段是否与附近敌对玩家的包围盒相交。当狙击枪或 RPG 首次直接命中时也触发检测。这两种提示每个目标都有3秒冷却时间。

无法识别的投射物在经过 5 次探测刻后被移除;死亡或被移除的投射物会自动清理。

手雷警报与投掷检测

  • 警报扫描:每 5 个游戏刻,服务器在每个玩家周围 5 格半径内扫描类型为 EXPLOSIVE_GRENADE 的 LR Tactical ThrowableItemEntity 实体。排除自身的手雷。
  • 投掷检测:每个游戏刻,检查玩家是否正在主动使用(按住右键)LR Tactical 投掷物品。当玩家开始引燃或切换到不同的手雷类型时,触发相应的提示——烟雾弹触发 THROW_SMOKE,高爆手雷和莫洛托夫鸡尾酒触发 THROW_GRENADE。

音频播放模式

客户端支持三种播放模式:

模式 行为 用例
LOCAL 非定位,音量平坦(SoundSource.PLAYERS, relative=true) 第一人称自我反馈(如受伤、死亡、低血量)
POSITION 静态世界坐标,基于距离衰减 世界定位音效
ENTITY 附着于活体实体,每刻跟随其移动,实体移除时停止 第三人称玩家附着音效(如装填、投掷手雷)

对于第一人称播放,音量由 firstPersonVolume 缩放;对于第三人称,由 thirdPersonVolume 缩放。如果某个提示缺少第一人称音频变体,客户端可以回退到第三人称变体(由 fallbackThirdPersonForLocal 控制)。

音频节流

为了防止激烈交火中的声音过载,客户端执行节流策略:

  • 每位玩家的第一人称声音上限:同一时间仅允许一个第一人称声音生效,BURNING(拥有独立的每个提示音列表)和无限优先级的提示音(DEATH、FINAL_DEATH 以及所有复活声音)除外。
  • 每位玩家的第三人称声音上限:单个玩家不能同时拥有两个活跃的第三人称声音。
  • 每种类型的第三人称声音上限:全局范围内,相同类型的提示音最多只能有 maxSimultaneousSingleTpSound(默认值为 2)个实例。
  • 每阵营的玩家上限:发出第三人称声音的友方玩家最多为 maxSimultaneousTpPlayersFriendly(默认值为 3),敌方玩家最多为 maxSimultaneousTpPlayersEnemy(默认值为 3)。当达到上限时,如果新玩家距离更近,则驱逐最远的玩家。

音频分层

某些提示音会同时播放多个声音层:

  • DEATH:第一人称层 fp.death.death + SFX 层 fp.death.sfx;通过 tp.{camp}.death 实现第三人称盟友反应。
  • BURNING:三个第一人称层 — fp.burning.scream + fp.burning.flame + fp.burning.spark

GD656Conquest 集成

当服务器上安装了 GD656Conquest 时,GD656FrontVoice 会通过反射自动检测并使用其 API 实现以下三个功能:

  1. 阵营解析:resolveCamp(player) 从 Conquest 的队伍系统中返回玩家的派系(CN/US/RU)。分配的语音包将跟随玩家的实际派系,而不是回退到默认值。
  2. 敌意检查:isSameCamp(left, right) 判断两名玩家是否属于同一个 Conquest 队伍。这取代了原版用于判定敌意的 isAlliedTo 检查,意味着只有处于不同 Conquest 队伍的玩家才会被视为具有敌意,从而影响压制、狙击手警报和 RPG 警报的效果。
  3. 死亡提示音延迟:shouldDeferDeathCue(player) 允许 Conquest 控制死亡语音提示音是立即播放还是延迟播放(例如用于倒地/复活系统)。

未安装 GD656Conquest:所有玩家默认使用 CN 语音包;基于阵营的敌意判定将回退至原版联盟检查。

在客户端,ignoreConquestCamp 配置选项允许玩家覆盖服务器提供的阵营信息,转而使用自己的 friendlyVoicePack / enemyVoicePack 设置。


注意事项

  • 本模组需要在客户端和服务端均安装才能完全发挥作用;
  • 本模组处于活跃开发阶段(0.x);功能可能会持续演变;
  • 部分代码由 AI 技术辅助生成;
  • 采用 MIT 许可证授权。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源