Description

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.