GD656FrontVoice

# 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 List registered sound events /gdfv debug play local <sound_event> /gdfv debug play position <sound_event> <pos> /gdfv debug play entity <sound_event> <entity> /gdfv debug play cue <voice_cue> <camp> <entity> /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.maxSimultane