概览
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 实现以下三个功能:
- 阵营解析:
resolveCamp(player) 从 Conquest 的队伍系统中返回玩家的派系(CN/US/RU)。分配的语音包将跟随玩家的实际派系,而不是回退到默认值。
- 敌意检查:
isSameCamp(left, right) 判断两名玩家是否属于同一个 Conquest 队伍。这取代了原版用于判定敌意的 isAlliedTo 检查,意味着只有处于不同 Conquest 队伍的玩家才会被视为具有敌意,从而影响压制、狙击手警报和 RPG 警报的效果。
- 死亡提示音延迟:
shouldDeferDeathCue(player) 允许 Conquest 控制死亡语音提示音是立即播放还是延迟播放(例如用于倒地/复活系统)。
未安装 GD656Conquest:所有玩家默认使用 CN 语音包;基于阵营的敌意判定将回退至原版联盟检查。
在客户端,ignoreConquestCamp 配置选项允许玩家覆盖服务器提供的阵营信息,转而使用自己的 friendlyVoicePack / enemyVoicePack 设置。
注意事项
- 本模组需要在客户端和服务端均安装才能完全发挥作用;
- 本模组处于活跃开发阶段(0.x);功能可能会持续演变;
- 部分代码由 AI 技术辅助生成;
- 采用 MIT 许可证授权。
Overview
GD656FrontVoice is a Minecraft mod that adds a dynamic combat voice-line system to multiplayer servers. It plays faction-specific voice cues — Chinese (CN), American (US), and Russian (RU) — triggered by combat events: taking damage, throwing grenades, reloading, killing enemies, being suppressed by gunfire, and more.
Last updated: July 25, 2026. Some features may not be fully documented or are subject to change.
Compatibility
- TACZ (Timeless and Classics Zero) 1.1.7-hotfix or later is strongly recommended — most combat event triggers depend on TACZ's event system and gun type API;
- Soft compatibility with LR Tactical — detects throwable entities for grenade alert and throw cues, plus fire debuff for burning detection;
- Soft compatibility with GD656Conquest — resolves faction/camp information for voice pack routing;
- Currently supports Minecraft 1.20.1 Forge only.
Server Installation
This mod is split into client-side and server-side functionality. Both sides require installation for full functionality.
Server-only features:
| Feature |
Notes |
| Combat event detection |
Listens to TACZ gun fire, reload, kill events and vanilla damage/death events |
| Suppression fire corridor system |
Accumulates suppression stacks when bullets pass near a player, triggers voice cues at thresholds |
| Projectile near-miss detection |
Tracks sniper bullets and RPG rockets, alerts players when projectiles pass nearby |
| Grenade alert scanning |
Scans nearby hostile throwables each tick and warns threatened players |
| Ammo-empty polling |
Checks player's held TACZ gun ammo state each tick |
| Burn detection |
Detects when a player is on fire (vanilla or LR Tactical flammable effect) |
| Grenade-throw detection |
Detects when a player starts priming a grenade/molotov/smoke |
| Camp-aware voice routing |
Resolves which voice pack (CN/US/RU) to use per player |
| Audio packet broadcasting |
Sends ClientboundPlayAudioPacket to target clients |
Client-only features:
| Feature |
Notes |
| Voice cue playback |
Receives packets, resolves voice cues via CueRouter, and plays sounds |
| First-person / third-person routing |
Plays local (non-positional) sounds for self, positional sounds for others |
| Audio throttling |
Limits simultaneous sounds per player and per type to prevent spam |
| Config & command system |
/gdfv client commands for debugging and config management |
| Camp perspective override |
Client-side ally/enemy detection can override server-assigned voice pack |
In short: the server detects and triggers all voice events; the client handles playback, routing, and throttling. Network traffic is minimal (a single self-describing packet type, ClientboundPlayAudioPacket).
Configuration & Commands
All parameters can be adjusted via the Forge mod config screen, or through in-game commands:
/gdfv debug summary Show audio manifest statistics
/gdfv debug list [filter] List registered sound events
/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 Hot-reload configuration files
Commands require permission level 2 (server operator). Config changes take effect immediately; runtime hot-reload is supported via reflection-based config reloading.
Key Config Options
Server (common) config:
| Config |
Default |
Description |
audio.serverEnabled |
true |
Master server switch for broadcasting audio |
audio.serverMasterVolume |
1.0 |
Global volume multiplier (0.0–4.0) |
Client config:
| Config |
Default |
Description |
audio.enabled |
true |
Master client playback switch |
audio.friendlyVoicePack |
CN |
Voice pack for allied players (when Conquest not installed or ignored) |
audio.enemyVoicePack |
US |
Voice pack for enemy players (when Conquest not installed or ignored) |
audio.detectEnemyByVanillaTeam |
true |
Detect enemy players using vanilla team (isAlliedTo), works without Conquest |
audio.ignoreConquestCamp |
false |
Ignore Conquest camp assignment, use friendly/enemy config instead |
audio.fallbackThirdPersonForLocal |
true |
Fall back to 3P sound if 1P variant is missing |
audio.masterVolume |
1.0 |
Master client volume (0.0–4.0) |
audio.firstPersonVolume |
1.0 |
Additional volume multiplier for first-person sounds (0.0–4.0) |
audio.thirdPersonVolume |
1.0 |
Additional volume multiplier for third-person sounds (0.0–4.0) |
audio.maxSimultaneousSingleTpSound |
2 |
Max same-type 3P sounds playing at once |
audio.maxSimultaneousTpPlayersFriendly |
3 |
Max friendly players emitting 3P sounds at once |
audio.maxSimultaneousTpPlayersEnemy |
3 |
Max enemy players emitting 3P sounds at once |
audio.maxThirdPersonDistance |
48.0 |
Max distance to hear 3P sounds (blocks) |
Features
Event-Driven Voice Cues
The following voice cues are triggered by specific in-game events on the server:
| Voice Cue |
Trigger Condition |
Playback |
| DEATH |
Player dies (LivingDeathEvent), not a spectator |
Layered: 1P death + SFX to self; 3P ally death reaction to nearby teammates |
| EXPLOSION_CLOSE |
Player takes explosion damage but survives (health > 0) |
1P to self, 1-second cooldown |
| LOW_HEALTH_PANIC |
Player health drops below 5.0 (half a heart × 5) |
1P to self, fires once per low-health episode |
| HEAVY_HURT |
Player takes damage from a TACZ bullet (non-sniper, non-RPG, non-explosion), survives |
1P to self, 10-second cooldown, suppressed if higher-priority cue fires same tick |
| BURNING |
Player is on fire (vanilla) or has LR Tactical lrtactical:flammable effect |
Layered 1P: scream + flame + spark, fires once per burning episode |
| REQUEST_AMMO |
Player's held TACZ gun has zero magazine ammo, zero barrel ammo, and no matching ammo in inventory |
1P to self, fires once per empty episode; rechecks every 1s when empty, 3s when loaded |
| GRENADE_ALERT |
An enemy LR Tactical explosive grenade is within a 5-block radius |
1P to self, scans every 5 ticks; excludes own grenades |
| THROW_GRENADE |
Player starts priming an LR Tactical explosive grenade or molotov (right-click hold) |
3P broadcast to tracking players |
| THROW_SMOKE |
Player starts priming an LR Tactical smoke grenade (right-click hold) |
3P broadcast to tracking players |
| RELOADING |
Player reloads TACZ gun (GunReloadEvent) |
3P broadcast to tracking players, 1-second cooldown |
| SUPPRESSED |
6+ suppression stacks from non-MG fire accumulate in 1 second (see Suppression Fire Corridor) |
1P to target, 4-second cooldown |
| MACHINE_GUN_ALERT |
6+ suppression stacks from MG fire accumulate in 1 second |
1P to target, 4-second cooldown |
| SUPPRESSING_HOSTILE |
Shooter accumulates 9+ suppression stacks on enemies in 1 second |
1P to shooter, 4-second cooldown, gated by 1-second aggressive-cue separation |
| SNIPER_ALERT |
Sniper bullet passes within 5 blocks of player, OR player is first hit by a sniper |
1P to target, 3-second cooldown |
| RPG_ALERT |
RPG rocket passes within 10 blocks of player, OR player is first hit by an RPG |
1P to target, 3-second cooldown |
| KILL_ENEMY |
Player kills an enemy with a TACZ gun (non-headshot, or no nearby allies for nice-shot) |
1P to killer |
| NICE_SHOT |
Player gets a headshot kill and an allied observer is within 5 blocks |
3P to nearby allied observer |
| FRIENDLY_FIRE |
Player kills a teammate and an allied observer is within 2 blocks |
3P to nearby allied observer, 4-second cooldown |
| TEAMMATE_DOWNED |
A teammate is killed nearby |
3P broadcast to nearby allies (triggered via GDCQ death deferral) |
Suppression Fire Corridor
When a player fires a TACZ gun, the server computes a fire corridor — a cylindrical volume extending 24 blocks forward from the shooter's eye position with a 1.6-block radius along their look direction. Every hostile, alive, non-spectator player inside this corridor receives one suppression stack.
- Suppression stacks per target expire after 20 ticks (1 second) from the first stack
- 6 stacks: triggers
SUPPRESSED on the target (or MACHINE_GUN_ALERT if all stacks came from an MG)
- 9 stacks: additionally triggers
SUPPRESSING_HOSTILE on the shooter
- Cooldowns prevent repeated spam: 4 seconds per target for suppressed, 4 seconds per shooter for suppressing hostile, with a 1-second aggressive-cue separation gate
Projectile Near-Miss Detection
When TACZ bullet entities spawn (EntityJoinLevelEvent), the server begins tracking them. Each tick, tracked projectiles are classified by gun type:
- Sniper bullets (gun type
sniper): near-pass radius 5 blocks
- RPG rockets (gun type
rpg): near-pass radius 10 blocks
For each projectile, the movement segment between its last and current position is tested against the bounding boxes of nearby hostile players using a segment-vs-inflated-box intersection. Detection also fires on the first direct hit from a sniper or RPG. Both cues have a 3-second cooldown per target.
Unrecognized projectiles are removed after 5 probe ticks; dead or removed projectiles are cleaned up automatically.
Grenade Alert & Throw Detection
- Alert scanning: Every 5 ticks, the server scans a 5-block radius around each player for LR Tactical
ThrowableItemEntity entities of type EXPLOSIVE_GRENADE. Own grenades are excluded.
- Throw detection: Each tick, checks if a player is actively using (right-click holding) an LR Tactical throwable item. When the player starts priming or switches to a different grenade type, the appropriate cue fires —
THROW_SMOKE for smoke grenades, THROW_GRENADE for explosive grenades and molotovs.
Audio Playback Modes
The client supports three playback modes:
| Mode |
Behavior |
Use Case |
| LOCAL |
Non-positional, flat volume (SoundSource.PLAYERS, relative=true) |
First-person self feedback (e.g., hurt, death, low health) |
| POSITION |
Static world position, distance-based attenuation |
World-positioned sounds |
| ENTITY |
Attached to a living entity, follows its movement each tick, stops when entity is removed |
Third-person player-attached sounds (e.g., reloading, throwing grenades) |
For first-person playback, the volume is scaled by firstPersonVolume; for third-person, by thirdPersonVolume. If a cue lacks a first-person audio variant, the client can fall back to the third-person variant (controlled by fallbackThirdPersonForLocal).
Audio Throttling
To prevent sound overload in intense firefights, the client enforces throttling:
- Per-player first-person limit: Only one first-person sound active at a time, except
BURNING (own per-cue list) and unlimited-priority cues (DEATH, FINAL_DEATH, and all revive sounds)
- Per-player third-person limit: A single player cannot have two active third-person sounds
- Per-type third-person limit: At most
maxSimultaneousSingleTpSound (default 2) instances of the same cue type globally
- Per-camp player limit: At most
maxSimultaneousTpPlayersFriendly (default 3) friendly and maxSimultaneousTpPlayersEnemy (default 3) enemy players emitting third-person sounds. When the limit is reached, the furthest player is evicted if the new player is closer
Audio Layering
Certain cues play multiple sound layers simultaneously:
- DEATH: First-person layer
fp.death.death + SFX layer fp.death.sfx; third-person ally reaction via tp.{camp}.death
- BURNING: Three first-person layers —
fp.burning.scream + fp.burning.flame + fp.burning.spark
GD656Conquest Integration
When GD656Conquest is installed on the server, GD656FrontVoice automatically detects it via reflection and uses its API for three purposes:
- Camp resolution:
resolveCamp(player) returns the player's faction (CN/US/RU) from Conquest's team system. The assigned voice pack follows the player's actual faction rather than falling back to defaults.
- Hostility check:
isSameCamp(left, right) determines whether two players belong to the same Conquest team. This replaces the vanilla isAlliedTo check for hostility, meaning only players on different Conquest teams are considered hostile for suppression, sniper alert, and RPG alert purposes.
- Death cue deferral:
shouldDeferDeathCue(player) allows Conquest to control whether a death voice cue plays immediately or is deferred (e.g., for downed/revive systems).
Without GD656Conquest: All players default to the CN voice pack; camp-based hostility falls back to vanilla alliance checks.
On the client, the ignoreConquestCamp config option allows players to override the server-provided camp and use their own friendlyVoicePack / enemyVoicePack settings instead.
Notes
- This mod requires both client and server installation for full functionality;
- This mod is in active development (0.x); features may continue to evolve;
- Portions of the code were assisted by AI technology;
- Licensed under the MIT License.
评论 0
登录后参与评分
还没有评论,来抢沙发吧