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 [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: