Sable: Destructive

Version 2.1.0 rebuilds collision damage, heavy landings and destruction effects around a safer material-and-energy model. Small accidents remain small, while genuinely massive impacts can tear structures apart, fracture ordinary hard materials and leave a convincing crater.

Highlights

• Reworked damage into block-by-block structural failure instead of long layer-shaped trenches.
• Added cinematic giant-impact sequences with a contact flash, expanding shock fronts, ballistic rubble, an upward dust plume and delayed settling dust.
• Added three new custom shaders for pressure waves, volumetric dust plumes and faceted rubble. The mod now uses nine dedicated particle shaders.
• Added distance-attenuated camera and FOV shake with a fast impact kick followed by a slower ground rumble.
• Added circular, severity-scaled craters and stronger heavy-impact pressure damage to world terrain.
• Added client-side LOD and compact event networking to keep large effects practical in multiplayer.

Damage and material balance

• Replaced the previous mass heuristic with a deterministic kinetic-energy, reduced-mass and material-toughness model.
• Added a low-speed safety floor: dropping a normal stone block from roughly two blocks no longer makes it drill toward the bottom of the world.
• Disabled layer penetration by default. Optional extreme-impact penetration requires at least 20 m/s and is capped at two additional blocks.
• Disabled multi-block cluster detach by default so normal damage progresses one contact block at a time.
• Added a capped mass advantage. Adding more grass or another soft material no longer turns it into an armour-piercing projectile.
• Added attacker self-damage when a soft contact face hits a much harder defender.
• Rebalanced every finite ordinary toughness tier. Stone, metal, obsidian, netherite and reinforced blocks can fail under a proportionate impact instead of behaving as immortal blocks.
• Bedrock, barriers, command/structure blocks and portal infrastructure remain intentionally protected.
• Fixed Sable body-mass conversion and removed an accidental second application of massScale.
• Fixed explosion DETACH so it creates an actual physics fragment instead of silently deleting the block.

Giant-impact effects

• Heavy landings now require confirmed contact with solid world terrain.
• Impact origin is calculated from the transformed bottom centre of the falling Sable body.
• Added a fast dusty shock ring and a separate translucent pressure front.
• Added physical rubble with gravity, world collision and damped ground bounces.
• Added a long-lived rising plume with turbulent drift, expansion and gradual opacity loss.
• Added delayed skirt dust and secondary fragments after the initial collision.
• Added severity-scaled boom, low rumble and crater-crack sound layers.
• Fixed shader atlas handling that could make dust and shockwave sprites appear square, clipped or incorrectly centred.
• Dust and grit now collide and settle in the correct coordinate space, including particles attached to moving Sable sub-levels.

Performance and multiplayer

• A heavy impact now sends one compact deterministic event to each nearby player instead of hundreds of individual server particle packets.
• Particle density scales with distance and the player's Minecraft particle setting.
• Added a shared per-tick client spawn budget and a limit on simultaneous impact sequences.

- Existing server FX budgets, spatial deduplication and destruction queue limits remain active.

- Dedicated servers do not load client-only shader or screen classes.

## Configuration

The /sable-dv config panel screen now includes controls for:

- Epic heavy-impact effects

- Camera shake enable/disable

- Camera shake strength

- Impact FX density

- Maximum shockwave radius up to 48 blocks

- Crater depth and knockback

- Material gates, self-damage and optional penetration

Settings remain persistent in config/sabledestructive-common.toml.

## Compatibility and installation

- Minecraft 1.21.1

- NeoForge 21.1.235 or newer

- Sable 2.0.3 or newer

- Java 21

- Client and dedicated-server compatible

Remove the previous Sable: Destructive JAR, install sabledestructive-2.1.0.jar, and fully restart the game or server. Do not hot-swap this update.

## Verification

• Clean Gradle build completed successfully.
• 7 deterministic physics regression tests passed.
• 0 test failures and 0 test errors.