- Java 100%
|
All checks were successful
Build and Release / release (push) Successful in 27s
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> |
||
|---|---|---|
| .forgejo/workflows | ||
| gradle/wrapper | ||
| src/main | ||
| .gitignore | ||
| build.gradle | ||
| CLAUDE.md | ||
| gradle.properties | ||
| gradlew | ||
| gradlew.bat | ||
| README.md | ||
| settings.gradle | ||
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 inClientboundExplodePacketand replays it throughplaySeededSoundso 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
- Install Fabric Loader (>=0.16.0) on your Minecraft 26.1 server.
- Place the Quiet Charges JAR in the server's
mods/folder. - 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