fix wind charge volume/attenuation
Find a file
Troy Redfearn dae2f2963f
All checks were successful
Build and Release / release (push) Successful in 27s
Update to Minecraft 26.2, release 1.1.3
Flip 26.2-rc-2 -> stable 26.2 and bump mod version to 1.1.3.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-18 23:44:05 -07:00
.forgejo/workflows updated release pipeline 2026-04-27 12:10:19 -07:00
gradle/wrapper Initial release: server-side wind charge sound reduction mod 2026-02-16 11:09:41 -08:00
src/main Update to Minecraft 26.2, release 1.1.3 2026-06-18 23:44:05 -07:00
.gitignore Add .gitignore for build artifacts 2026-02-16 11:10:29 -08:00
build.gradle Port to Minecraft 26.1: migrate from Yarn to Mojang mappings 2026-04-08 15:09:43 -07:00
CLAUDE.md Update to Minecraft 26.1.2 2026-04-25 00:45:37 -07:00
gradle.properties Update to Minecraft 26.2, release 1.1.3 2026-06-18 23:44:05 -07:00
gradlew Initial release: server-side wind charge sound reduction mod 2026-02-16 11:09:41 -08:00
gradlew.bat Initial release: server-side wind charge sound reduction mod 2026-02-16 11:09:41 -08:00
README.md Add project README 2026-04-08 15:12:28 -07:00
settings.gradle Port to Minecraft 26.1: migrate from Yarn to Mojang mappings 2026-04-08 15:09:43 -07:00

Quiet Charges

A server-side Fabric mod for Minecraft 26.1 that reduces the audible distance of wind charge sounds. No client-side installation required.

The Problem

Wind charge burst sounds are loud and carry far, which can be disruptive on busy servers. The explosion packet that Minecraft sends to clients plays the burst sound at a hardcoded volume of 4.0, making it impossible to tune server-side without intervention.

How It Works

Quiet Charges uses two server-side mixins:

  • SoundMixin intercepts ServerLevel.playSeededSound() and multiplies the volume of wind charge burst sounds by a configurable multiplier (default 1.0).
  • ExplosionMixin intercepts Level.explode() to silence the hardcoded wind charge sound in ClientboundExplodePacket and replays it through playSeededSound so the volume multiplier applies.

An optional normalize setting halves the breeze burst volume (x0.5) before applying the multiplier, equalizing its attenuation distance with the player wind charge burst.

Target Sounds

Sound Event Source
entity.wind_charge.wind_burst Player wind charge impact
entity.breeze.wind_burst Breeze wind charge impact

Installation

  1. Install Fabric Loader (>=0.16.0) on your Minecraft 26.1 server.
  2. Place the Quiet Charges JAR in the server's mods/ folder.
  3. Start the server. A config file will be created at config/quietcharges.json.

No client-side mod is needed.

Configuration

Settings are stored in config/quietcharges.json:

{
  "volumeMultiplier": 1.0,
  "normalize": false
}
Setting Range Default Description
volumeMultiplier 0.0 1.0 1.0 Multiplier applied to wind charge burst volume. Lower = quieter.
normalize true/false false Halve breeze burst volume before applying the multiplier to match player wind charge distance.

Commands

All commands require operator permissions (level 2+).

Command Description
/quietcharges volume Show the current volume multiplier
/quietcharges volume <0.0-1.0> Set the volume multiplier
/quietcharges normalize Show whether breeze normalization is enabled
/quietcharges normalize <true|false> Enable or disable breeze burst normalization

Changes take effect immediately and persist across restarts.

Building

Requires Java 25.

./gradlew build

The output JAR is written to build/libs/.

Dependencies

  • Minecraft 26.1
  • Fabric Loader >=0.16.0
  • Fabric API 0.144.0+26.1
  • Java 25

License

MIT