# Simple Voice Mechanics<\/p>\n
Realistic mob reactions to voice in Minecraft. Uses Simple Voice Chat for dynamic audio detection with volume and distance-based behavior.<\/p>\n
## Features<\/p>\n
– **Real-time Audio Analysis**: Opus decoding with dB calculation
\n– **Dynamic Range**: Louder voices heard from further away (40%-220% of base range)
\n– **Environmental Modifiers**: Biome & time-based acoustics (caves echo, forests dampen, night = more sensitive)
\n– **Mob Group Alerts**: Hostile mobs call reinforcements (zombies summon hordes, wolves hunt in packs)
\n– **Natural Behavior**: Probabilistic reactions, cooldowns, eye contact system
\n– **4 Mob Categories**: Hostile (attack), Neutral (look), Peaceful (look\/flee\/follow), Warden (anger system)
\n– **Sculk Sensors**: GameEvent-based activation on loud voices<\/p>\n
### Mob Behavior<\/p>\n
| Category | Reaction | Threshold | Special Features |
\n|———-|———-|———–|——————|
\n| **Hostile** | Attack | -40 dB | Target player, **alert nearby allies (NEW)** |
\n| **Neutral** | Look (8s) | -35 dB | 60% reaction chance |
\n| **Peaceful** | Look (10s) | -30 dB | Flee at >-20 dB, Follow when sneaking + eye contact |
\n| **Warden** | Anger +15-60 | -20 dB | Volume & distance dependent |
\n| **Sculk** | Activate | -20 dB | Only on loud voices |<\/p>\n
**Peaceful Mobs Details:**
\n– Normal speaking: Look at player
\n– Loud speaking (>-20 dB): Flee 3 blocks away
\n– Sneaking + Speaking + Eye contact: Follow for 60s<\/p>\n
### Environmental Effects<\/p>\n
| Environment | Range Modifier | Sensitivity | Example |
\n|————-|—————|————-|———|
\n| **Cave + Night** | ~2.0x | -13 dB | **VERY DANGEROUS** – Mobs hear whispers from far away |
\n| **Forest + Day** | 0.75x | +3 dB | Safer – Vegetation dampens sound |
\n| **Nether** | 1.3x | Normal | Sound carries in open spaces |
\n| **Mountain + Night** | 1.56x | -8 dB | Sound echoes across peaks |<\/p>\n
**Mob Group Alerts:**
\n– Zombies: Call 5 allies within 16 blocks \u2192 Horde attack
\n– Wolves: Alert pack within 20 blocks \u2192 Coordinated hunt
\n– Piglins: Summon group within 18 blocks \u2192 Group combat<\/p>\n
## Requirements<\/p>\n
– Minecraft 1.18+ (Paper or compatible)
\n– Java 17+
\n– Simple Voice Chat Plugin<\/p>\n
**Note:** Sculk Sensors require Minecraft 1.19+<\/p>\n
## Installation<\/p>\n
1. Install Simple Voice Chat
\n2. Place SimpleVoiceMechanics JAR in `plugins\/` folder
\n3. Restart server
\n4. Adjust `plugins\/SimpleVoiceMechanics\/config.yml` as needed<\/p>\n
## Configuration<\/p>\n
### Global Settings
\n“`yaml
\ndetection:
\n max-range: 16.0
\n min-range: 2.0
\n falloff-curve: 1.0 # 0.5-2.0 (0.5=linear, 2.0=steep)
\n“`<\/p>\n
### Environmental Modifiers
\n“`yaml
\nenvironmental-modifiers:
\n biome-modifiers:
\n enabled: true # Caves echo, forests dampen
\n time-modifiers:
\n enabled: true # Night = 30% more range, 8 dB more sensitive
\n“`<\/p>\n
### Mob Group Alerts
\n“`yaml
\nmob-hearing:
\n hostile-mobs:
\n group-alert:
\n enabled: true
\n max-alerts: 5 # Max mobs to summon per detection
\n ranges:
\n zombie: 16.0 # Horde radius
\n wolf: 20.0 # Pack radius
\n piglin: 18.0 # Group radius
\n“`<\/p>\n
### Per-Category Settings
\n“`yaml
\npeaceful-mobs:
\n enabled: true
\n volume-threshold-db: -30.0
\n max-range: 8.0
\n natural-behavior:
\n reaction-chance: 0.7 # 70% reaction probability
\n look-duration: 10 # Look duration in seconds
\n reaction-cooldown: 3 # Cooldown between reactions
\n flee-behavior:
\n enabled: true
\n flee-volume-db: -20.0
\n flee-distance: 3.0
\n flee-duration: 3
\n follow-when-sneaking:
\n enabled: true
\n require-eye-contact: true
\n eye-contact-range: 4.0
\n eye-contact-memory: 5
\n duration: 60
\n max-distance: 12.0
\n blacklist: [] # Exclude EntityTypes
\n“`<\/p>\n
### Volume Scale (dB)<\/p>\n
– **-60 dB**: Whispering
\n– **-40 dB**: Normal speaking (Default Hostile)
\n– **-30 dB**: Quiet to normal (Default Peaceful)
\n– **-20 dB**: Loud speaking (Default Warden\/Sculk)
\n– **-10 dB**: Shouting<\/p>\n
## Commands<\/p>\n
– `\/voicelistener reload` – Reload config **Aliases:** `\/vl`, `\/voicemechanics`<\/p>\n ## Permissions<\/p>\n – `voicelistener.admin` (default: op)<\/p>\n ## Preset Examples<\/p>\n ### Stealth Server ### Action Server ### Warden Extreme Challenge ### Hardcore Survival ## Gameplay Examples<\/p>\n **Cave Exploration at Night:** **Forest Stealth (Day):** **Nether Fortress:** ## Debug Options<\/p>\n “`yaml ## Technical Details<\/p>\n **Detection Flow:** **Formulas:** Detection Probability = (1 – normalized_distance)^falloff_curve Mob Alerts = Dynamic (1-5 based on distance, closer = more alerts) ## API Usage<\/p>\n “`java \/\/ Access config \/\/ New utility classes ## Building<\/p>\n “`bash ## License<\/p>\n MIT License<\/p>\n ## Credits<\/p>\n – Audio calculation adapted from Simple Voice Chat (henkelmax) Make the Game hear you using Simple Voice Chat and Simple Voice Mechanics!<\/p>\n","protected":false},"featured_media":140760,"template":"","meta":{"_minecraft_slug":"simple-voice-mechanics","_minecraft_project_id":"5cINTt1w","_minecraft_author":"F02K","_minecraft_license":"MIT","_minecraft_downloads":715,"_minecraft_follows":10,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"simple-voice-mechanics.zip","_minecraft_size_bytes":259102,"_minecraft_version_count":6,"_minecraft_updated_at":"2026-05-16T09:31:06.081274Z","_minecraft_date_created":"2025-12-17T22:39:24.866618Z","_minecraft_date_modified":"2026-04-09T09:52:33.364112Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/simple-voice-mechanics","_minecraft_icon_attachment_id":140760,"_minecraft_imported_at":"2026-06-08T08:35:06+00:00","_minecraft_import_hash":"7f8faf22bd1352d60ccc2710f00100f8","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,89,137,127,128,867,92],"mod_loader":[132,133],"minecraft_version":[51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-140759","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-game-mechanics","mod_category-mobs","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-utility","mod_loader-paper","mod_loader-purpur","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– `\/voicelistener toggle
\n– `\/voicelistener status` – Show current config<\/p>\n
\n“`yaml
\nhostile-mobs:
\n volume-threshold-db: -50.0 # Whispers detected
\n max-range: 24.0
\n falloff-curve: 0.8
\nenvironmental-modifiers:
\n biome-modifiers:
\n enabled: true # Caves are extra dangerous
\n time-modifiers:
\n enabled: true # Nights are terrifying
\n“`<\/p>\n
\n“`yaml
\nhostile-mobs:
\n volume-threshold-db: -25.0 # Only loud speaking
\n max-range: 12.0
\n falloff-curve: 1.5
\n group-alert:
\n enabled: true
\n max-alerts: 8 # Larger mob groups!
\n“`<\/p>\n
\n“`yaml
\nwarden:
\n volume-threshold-db: -60.0 # Hears everything!
\n max-range: 32.0
\n falloff-curve: 0.5
\n“`<\/p>\n
\n“`yaml
\nenvironmental-modifiers:
\n biome-modifiers:
\n enabled: true
\n time-modifiers:
\n enabled: true
\nmob-hearing:
\n hostile-mobs:
\n volume-threshold-db: -50.0
\n group-alert:
\n enabled: true
\n max-alerts: 10 # Massive hordes!
\n“`<\/p>\n
\n– Biome: Cave (1.5x range, -5 dB)
\n– Time: Night (1.3x range, -8 dB)
\n– **Combined: ~2x range, -13 dB more sensitive**
\n– Result: Whispering attracts zombies from far away. 1 zombie calls 5 more \u2192 6 zombies attack!<\/p>\n
\n– Biome: Forest (0.75x range, +3 dB)
\n– Time: Day (normal)
\n– **Combined: 0.75x range**
\n– Result: Vegetation dampens sound. Normal speaking is safe.<\/p>\n
\n– Biome: Nether (1.3x range)
\n– Mobs: Piglins (18 block alert)
\n– Result: 1 Piglin hears you \u2192 alerts 5 nearby Piglins \u2192 coordinated group attack<\/p>\n
\ndebug:
\n audio-logging: false
\n range-logging: false
\n detection-logging: false
\n warden-logging: false
\n sculk-logging: false
\n peaceful-logging: false
\n environmental-logging: false
\n group-alert-logging: false
\n“`<\/p>\n
\n1. Audio packet received \u2192 Decode Opus \u2192 Calculate dB
\n2. **NEW: Apply environmental modifiers (biome + time)**
\n3. Check category threshold \u2192 Calculate effective range
\n4. Probability-based detection \u2192 Natural behavior check
\n5. Execute action (Attack\/Look\/Flee\/Follow)
\n6. **NEW: If hostile detected, alert nearby allies**<\/p>\n
\n“`
\nEffective Range = Config Range \u00d7 Biome Mult \u00d7 Time Mult \u00d7 (1.0 + (dB – Threshold) \/ 25.0)
\nCapped: 0.5\u00d7 to 2.5\u00d7<\/p>\n
\n100% at \u2264 min-range, 0% at \u2265 max-range<\/p>\n
\n“`<\/p>\n
\n@EventHandler
\npublic void onVoiceDetected(VoiceDetectedEvent event) {
\n Player player = event.getPlayer();
\n double decibels = event.getDecibels();
\n \/\/ Custom logic
\n}<\/p>\n
\nConfigManager config = plugin.getConfigManager();
\ndouble threshold = config.getHostileVolumeThresholdDb();
\nboolean biomeMods = config.isBiomeModifiersEnabled();<\/p>\n
\nBiome biome = location.getBlock().getBiome();
\ndouble rangeMultiplier = BiomeModifier.getRangeMultiplier(biome);
\nboolean isNight = TimeModifier.isNight(world);
\nboolean isSocial = MobGroupAlert.isSocialMob(EntityType.ZOMBIE);
\n“`<\/p>\n
\ngit clone https:\/\/github.com\/yourusername\/SimpleVoiceMechanics.git
\ncd SimpleVoiceMechanics
\nmvn clean package
\n“`<\/p>\n
\n– Built for Paper
\n– SimpleVoiceChat API
\n– Environmental acoustics inspired by real-world sound propagation<\/p>\n","protected":false},"excerpt":{"rendered":"