GD656FrontVoice

GD656FrontVoice

GD656FrontVoice 添加基于阵营的战斗语音提示——换弹、手雷、击杀、压制警报——包含中/英/俄语音包。配合 TACZ 使用,通过原版队伍识别敌人。

工具

概述

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(服务器管理员)。配置更改立即生效;支持通过基于反射的配置重载进行运行时热重载。

关键配置选项

服务端(通用)配置:

配置 默认值 描述
audio.serverEnabled true 服务器广播音频的总开关
audio.serverMasterVolume 1.0 全局音量倍率(0.0–4.0)

客户端配置:

配置 默认值 描述
audio.enabled true 客户端播放总开关
audio.friendlyVoicePack CN 友方玩家的语音包(未安装 Conquest 或忽略时使用)
audio.enemyVoicePack US 敌方玩家的语音包(未安装 Conquest 或忽略时使用)
audio.detectEnemyByVanillaTeam true 使用原版队伍(isAlliedTo)检测敌方玩家,无需 Conquest 即可工作
audio.ignoreConquestCamp false 忽略 Conquest 营地分配,改用友方/敌方配置
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 秒冷却,若同 tick 触发更高优先级提示则被抑制
BURNING 玩家着火(原版)或拥有 LR Tactical lrtactical:flammable 效果 分层第一人称:尖叫 + 火焰 + 火花,每次着火状态只触发一次
REQUEST_AMMO 玩家手持 TACZ 枪械的弹匣弹药为零、枪管弹药为零,且背包中无匹配弹药 对自己播放第一人称,每次空弹状态只触发一次;空弹时每 1 秒重新检查,有弹时每 3 秒检查
GRENADE_ALERT 敌方 LR Tactical 爆炸手雷位于 5 格半径内 对自己播放第一人称,每 5 tick 扫描一次;排除自己的手雷
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 死亡延迟触发)

压制火力走廊

当玩家用 TACZ 枪械开火时,服务端会计算一个火力走廊——从射手眼睛位置沿其视线方向向前延伸 24 格、半径 1.6 格的圆柱体区域。该走廊内每个敌对、存活、非旁观者的玩家都会获得一层压制层数。

  • 每个目标的压制层数在首层出现后 20 tick(1 秒)过期
  • 6 层:对目标触发 SUPPRESSED(若所有层数均来自机枪则触发 MACHINE_GUN_ALERT)
  • 9 层:额外对射手触发 SUPPRESSING_HOSTILE
  • 冷却机制防止重复刷屏:每个目标被压制 4 秒冷却,每个射手压制敌人 4 秒冷却,并设有 1 秒攻击性提示间隔门控

投射物擦身检测

当 TACZ 子弹实体生成时(EntityJoinLevelEvent),服务端开始追踪它们。每个 tick,被追踪的投射物按枪械类型分类:

  • 狙击子弹(枪械类型 sniper):擦身半径 5 格
  • RPG 火箭弹(枪械类型 rpg):擦身半径 10 格

对于每个投射物,将其上一位置到当前位置之间的移动线段与附近敌对玩家的包围盒进行检测,使用线段与膨胀盒相交算法。狙击或 RPG 的首次直接命中也会触发检测。两种提示对每个目标均有 3 秒冷却。

未识别的投射物在 5 个探测 tick 后被移除;死亡或已移除的投射物会自动清理。

手雷警报与投掷检测

  • 警报扫描:每 5 tick,服务端在每位玩家周围 5 格半径内扫描 LR Tactical ThrowableItemEntity 类型为 EXPLOSIVE_GRENADE 的实体。自己的手雷被排除。
  • 投掷检测:每个 tick 检查玩家是否正在使用(右键长按)LR Tactical 投掷物物品。当玩家开始拉栓或切换到不同手雷类型时,触发相应提示——烟雾弹触发 THROW_SMOKE,爆炸手雷和燃烧瓶触发 THROW_GRENADE。

音频播放模式

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

模式 行为 使用场景
LOCAL 非定位,平面音量(SoundSource.PLAYERS,relative=true) 第一人称自身反馈(如受伤、死亡、低血量)
POSITION 静态世界位置,基于距离衰减 世界定位声音
ENTITY 附加到生物实体,每 tick 跟随其移动,实体移除时停止 第三人称玩家附加声音(如换弹、投掷手雷)

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

音频节流

为防止激烈交火中声音过载,客户端强制执行节流:

  • 每位玩家第一人称限制:同一时间仅一个第一人称声音活跃,BURNING(自有按提示列表)和无限制优先级提示(DEATH、FINAL_DEATH 及所有复活声音)除外
  • 每位玩家第三人称限制:单个玩家不能同时有两个活跃的第三人称声音
  • 每类型第三人称限制:全局同种提示类型最多 maxSimultaneousSingleTpSound(默认 2)个实例
  • 每阵营玩家限制:最多 maxSimultaneousTpPlayersFriendly(默认 3)个友方和 maxSimultaneousTpPlayersEnemy(默认 3)个敌方玩家发出第三人称声音。达到上限时,若新玩家更近则淘汰最远的玩家

音频分层

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

  • DEATH:第一人称层 fp.death.death + 音效层 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 许可证授权。