Detonance Core: Dynamic Shockwave Physics

Detonance Core: Dynamic Shockwave Physics

Detonance Core turns Minecraft explosions into staged, server-authoritative shockwaves. Pressure travels through space, loses energy through materials and occlusion, then drives dust, debris, fire fragments, sound delay, camera response and concussion on the client.

Features

• Material-aware pressure for wood, stone, dirt, sand, gravel, glass, metal, obsidian, diamond, netherite and modded blocks.
• TNT cluster merging: nearby TNT is bounded into one stronger blast instead of scattering into unrelated small explosions.
• Dark, long-lived smoke; separate beige sand dust that spreads along the ground; material collapse dust and fire fragments.
• Delayed glass, door, trapdoor and gate reactions, pressure knockback and bounded physical block debris.
• Long-range sound with a speed-of-sound delay, power-scaled boom/rumble/echo and client-side concussion, heartbeat and persistent ringing.
• Optional progressive structural collapse for unsupported buildings, bridges and overhangs. It is disabled by default and enabled by an operator with /detonance collapse on or the server config.
• Fabric and NeoForge support for Minecraft 1.21.1, with generic compatibility for explosions that use Minecraft's normal pipeline.

Installation

1. Install Minecraft Java Edition 1.21.1 and the matching Fabric or NeoForge loader.
2. Install the required loader dependency (Fabric API for Fabric; NeoForge for NeoForge).
3. Put the matching Detonance-Core-...jar in the mods folder on the server and on every client.
4. Start the server once, then review config/detonance-core.properties.
5. Leave structural collapse off for a normal world; an operator can enable it with /detonance collapse on after making a backup.

The server owns real block/entity damage. Clients render synchronized smoke, sand dust, debris, delayed audio, camera shake and concussion. All players should use the same mod version and loader build.

Important defaults and safety

Structural collapse is opt-in. It has bounded chain depth, radius, block count and performance presets. Test it in a copy of a world before enabling it on a long-running server. Large explosions can still be expensive on weak hardware; use the Potato or Balanced preset when needed.

Commands

/detonance info
/detonance reload
/detonance mode visual_only|hybrid|full_propagation
/detonance profile [set] arcade|cinematic|realistic|brutal_realistic
/detonance compatibility safe|enhanced|full_override
/detonance collapse on|off
/detonance collapse debug on|off
/detonance collapse scan|stress|preview

Compatibility and support

The mod targets Minecraft 1.21.1 on Fabric and NeoForge. Weapon mods that call the vanilla explosion pipeline receive the generic compatibility path; a weapon's private custom physics may need a profile adapter. Report reproducible bugs with the loader, game version, performance preset, relevant config, /detonance info, log excerpt and a minimal world.

Author: Tarubi_

License and redistribution permissions are listed in the project metadata and repository. Do not redistribute modified or bundled copies unless the selected license explicitly allows it.