GD656FrontVoice

Minecraft 版本： 1.20.1

平台： forge

标签： utility

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:

Client-only features:

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:

Client config:

Features

Event-Driven Voice Cues

The following voice cues are triggered by specific in-game events on the server:

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:

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:

1. 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.
2. 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.
3. 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.