# Sable: Destructive<\/p>\n
**Sable: Destructive** is a NeoForge 1.21.1 add-on for Sable that turns physics blocks into something that can actually be **destroyed**. Crash a ship into the ground, set off a creeper next to a flying base, or drop an end crystal on a tank \u2014 Sable sub-levels now react to violence the way they should: chunks fly off, weak materials pulverize, and reinforced ones hold.<\/p>\n
—<\/p>\n
## What it does<\/p>\n
Out of the box, Sable gives you beautifully simulated physics blocks, but they are effectively indestructible. This add-on plugs directly into Sable’s collision and explosion callbacks and decides, on every meaningful impact, whether the affected blocks should:<\/p>\n
– **DETACH** \u2014 break off into a smaller, independent physics sub-level (default ~90% of impacts). The piece keeps flying, tumbling, and colliding on its own.
\n– **VANISH** \u2014 pulverize into particles + sound, with a fancy multi-layer effect (default ~10% of impacts). Used when the energy is high enough to truly shatter the material.<\/p>\n
The choice between the two is **not** a flat dice roll. It is biased by real physics:<\/p>\n
– Kinetic energy at the contact point (mass \u00d7 v\u00b2) vs. material toughness.
\n– Block brittleness (leaves and grass shatter; obsidian and netherite resist).
\n– A safety speed ceiling so absurdly fast impacts don’t spawn endless sub-levels.<\/p>\n
You see the underlying numbers right in-game with **F3 + H**:<\/p>\n
“`
\nMass: 540 kg
\nImpact strength: 20 m\/s
\n“`<\/p>\n
—<\/p>\n
## Features<\/p>\n
– \u2705 Full impact handling for **all 1.21.1 blocks**, with a sensible mass + toughness table.
\n– \u2705 Modded blocks default to the fragile end (clay-tier) so unknown blocks don’t become indestructible bricks.
\n– \u2705 Vanilla explosions are routed through the same path: **TNT, creepers, end crystals, beds-in-the-Nether** all damage Sable sub-levels.
\n– \u2705 World terrain is *also* affected, but only via VANISH (never DETACH), so the world never turns into a runaway physics sim. There’s a config flag to restrict damage to sub-level blocks only.
\n– \u2705 Fancy VANISH effect: 3-layer particles (block-dust with the actual block texture, POOF, CRIT chips) + block break sound + soft “whump”, with hard per-tick budgets so 500 simultaneous breaks don’t tank your FPS.
\n– \u2705 **Crash-safe**: every native call into Sable is wrapped, deferred to safe inter-tick windows, and guarded against `NaN`\/`Inf`, mid-step mutation, and cross-parent cluster errors. Years of “Minecraft just closed without a log” \u2014 fixed.
\n– \u2705 Cluster detach: blocks can break off in **chunks**, not strictly one at a time, for cinematic damage.
\n– \u2705 Runtime command system \u2014 no restart, no config file editing required.
\n– \u2705 **Persistent config** (since 1.2.0) at `config\/sabledestructive-common.toml`. Every value set via `\/sable-dv set \u2026` survives restarts, and editing the TOML on disk hot-reloads within ~250 ms.
\n– \u2705 **Hand-tuned block table** (since 1.2.0): ~70 of the most relevant 1.21.1 blocks \u2014 every wood species and the full stone family \u2014 carry their own mass and toughness instead of being lumped into one “wood” or “stone” bucket. Cherry is softer than oak. Mossy bricks crack a hair sooner than fresh ones. Slabs\/stairs\/walls\/fences\/doors\/trapdoors\/signs each get their own row. Other vanilla blocks continue to use the existing classification pipeline.
\n– \u2705 **Inertial penetration** (since 1.1.0): impacts no longer stop at the first block. The attacker’s kinetic energy is drained block-by-block along the motion direction by each consumed block’s break cost (`0.5 \u00b7 m \u00b7 v_thr\u00b2`). An obsidian hammer punches a deep crater into dirt and only chips the surface of stone, automatically.
\n– \u2705 **Real damage** (since 1.2.0): default damage roughly doubled, speed scales penetration depth and energy budget, and density actually matters \u2014 soft attackers no longer pretend to break hard surfaces.
\n– \u2705 **Self-damage** (since 1.2.0): when the attacker is much softer than the defender, the defender survives AND the attacker erodes its own contact face. Copper hammer vs obsidian wall: copper sheds, wall stands.
\n– \u2705 **Shockwave** (since 1.3.0): heavy hits radiate. When a big sub-level slams the ground hard, a stylised radial shockwave rolls outward from the contact point \u2014 dust ring sampled from the actual ground colour, layered “\u043f\u0448\u0448\u0448” sweep sound, then graded damage by distance. Plants and flowers trample out to the full radius, leaves shake loose probabilistically inside the inner 70%, and on truly massive impacts (\u2265 5 MJ) weak surface blocks (snow, fire, carpets, candles, redstone wire, vines) shatter in the inner core. Never touches structural masonry. 17 dedicated tunables, all live-reloadable.<\/p>\n
—<\/p>\n
## Commands<\/p>\n
All commands require op level 2.<\/p>\n
“` Tunables include `chanceDetach`, `chanceVanish`, `physicsBiasStrength`, `minBreakSpeed`, `absoluteMaxSpeed`, `detachSafeSpeedCeiling`, `maxDetachesPerSecond`, `maxActiveDetachedSubLevels`, `effects`, `fancyVanishEffect`, `affectOnlySubLevelBlocks`, and many more.<\/p>\n —<\/p>\n ## Performance<\/p>\n Designed to stay quiet when nothing is happening, and not to fall over when *everything* is happening:<\/p>\n – Lock-free offer queue with atomic size counter and epoch-XOR dedup ring (8192 entries). —<\/p>\n ## Requirements<\/p>\n – Minecraft **1.21.1** —<\/p>\n ## Compatibility<\/p>\n – Server + client. Effects are client-side; the destruction logic itself runs server-side. —<\/p>\n ## Known limitations<\/p>\n – Block entities (chests, furnaces, etc.) are skipped by the world-terrain VANISH path on purpose, to avoid item-loss \/ NBT issues. —<\/p>\n ## Addon API (since 1.1.0)<\/p>\n Sable: Destructive ships a small, stable, SemVer-covered public API so other mods can teach it about *their* blocks. Unknown modded blocks otherwise fall back to a deliberately fragile clay-tier default \u2014 register an entry and your block participates in real impact \/ explosion physics with the mass and toughness *you* choose.<\/p>\n The entire API lives in a single class: `com.destroynautics.sabledestructive.api.SableDestructiveAPI`. Anything outside that package is internal and may change between versions.<\/p>\n ### Quick example<\/p>\n “`java \/\/ By ResourceLocation (works even if the target Block class isn’t loaded \u2014 \/\/ Custom raw values (advanced): \/\/ Bedrock-equivalent: ### Tier presets<\/p>\n Use `SableDestructiveAPI.Tier` instead of magic numbers \u2014 your blocks then stay balanced relative to vanilla as the mod’s defaults evolve.<\/p>\n | Tier | Toughness (units) | Vanilla example | ### Method reference<\/p>\n “`java \/\/ By ResourceLocation (optional cross-mod compat) \/\/ Inspect \/ remove \/\/ Read-only queries (e.g. for your own tooltips \/ ballistics) ### Notes<\/p>\n – **Thread-safe.** Call from any thread; safe during mod loading and at runtime. ### Soft dependency setup<\/p>\n Add Sable: Destructive as an *optional* runtime dependency in your `neoforge.mods.toml` so your mod loads either way:<\/p>\n “`toml Then guard your registration call so it doesn’t NoClassDefFoundError when Sable: Destructive isn’t installed:<\/p>\n “`java —<\/p>\n ## Credits<\/p>\n – **Author \/ code**: Xylos_Official —<\/p>\n ## License<\/p>\n MIT.<\/p>\n","protected":false},"excerpt":{"rendered":" Sable: Destructive makes Sable physics blocks actually break. Real kinetic energy, inertial penetration, density-aware self-damage, radial shockwaves on heavy hits \u2014 fast hammers dig deep into dirt, soft hammers shatter against stone, big drops radiate.<\/p>\n","protected":false},"featured_media":135123,"template":"","meta":{"_minecraft_slug":"sable-destructive","_minecraft_project_id":"s8kSCCgD","_minecraft_author":"Xylos_Official","_minecraft_license":"MIT","_minecraft_downloads":1094,"_minecraft_follows":17,"_minecraft_client_side":"required","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"sable-destructive.zip","_minecraft_size_bytes":744119,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-16T13:41:25.690836Z","_minecraft_date_created":"2026-05-04T16:57:44.905834Z","_minecraft_date_modified":"2026-04-25T18:01:49.996422Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/sable-destructive","_minecraft_icon_attachment_id":135123,"_minecraft_imported_at":"2026-06-07T23:28:36+00:00","_minecraft_import_hash":"ea33223fcf89af08933eb2f346b64d9b","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,89,158,123],"mod_loader":[160],"minecraft_version":[37],"class_list":["post-135122","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-game-mechanics","mod_category-neoforge","mod_category-technology","mod_loader-neoforge","minecraft_version-1-21-1"],"yoast_head":"\n
\n\/sable-dv on enable the system
\n\/sable-dv off disable the system
\n\/sable-dv toggle flip enabled
\n\/sable-dv status current enabled state
\n\/sable-dv config list list every tunable + current value
\n\/sable-dv config get
\n\/sable-dv config set
\n\/sable-dv config reset
\n“`<\/p>\n
\n– Per-tick caps: 1024 offers, 600 vanish particles, 32 vanish effects.
\n– Spatial + temporal dedup on effects so big breaks don’t audio-clip.
\n– Auto-scaling under backpressure; falls back to vanilla `levelEvent(2001)` if the fancy pipeline is overloaded.
\n– DETACH is always deferred to a safe tick boundary \u2014 never executed while Sable’s physics system is mid-step.<\/p>\n
\n– NeoForge **21.1.227+**
\n– Sable **1.1.3+** (required dependency \u2014 the add-on does literally nothing without it)
\n– Sable’s bundled libraries (Sable Companion, Veil) \u2014 these ship inside Sable’s jar; you do not need to install them separately.<\/p>\n
\n– Should be compatible with most other mods. Modded blocks are auto-classified into a safe fragile tier.<\/p>\n
\n– Bedrock, barriers, and unbreakable blocks are skipped.
\n– Detach respects Sable’s parent boundaries \u2014 clusters never cross sub-levels.<\/p>\n
\n@Mod(“examplemod”)
\npublic class ExampleMod {
\n public ExampleMod(IEventBus bus) {
\n bus.addListener(this::onCommonSetup);
\n }
\n private void onCommonSetup(FMLCommonSetupEvent e) {
\n \/\/ Direct Block reference (recommended, type-safe):
\n SableDestructiveAPI.register(
\n ExampleBlocks.MITHRIL_BLOCK.get(),
\n 8500.0, \/\/ mass in kg
\n SableDestructiveAPI.Tier.NETHERITE);<\/p>\n
\n \/\/ useful for optional cross-mod compat):
\n SableDestructiveAPI.register(
\n ResourceLocation.fromNamespaceAndPath(“othermod”, “arcane_brick”),
\n 3000.0,
\n SableDestructiveAPI.Tier.STONE);<\/p>\n
\n SableDestructiveAPI.register(
\n ExampleBlocks.FOAM_PANEL.get(),
\n 40.0, \/\/ very light (kg)
\n 0.8); \/\/ very fragile (~8 toughness units)<\/p>\n
\n SableDestructiveAPI.registerUnbreakable(ExampleBlocks.WARDSTONE.get());
\n }
\n}
\n“`<\/p>\n
\n|—|—:|—|
\n| `PAPER` | 10 | flowers, candles |
\n| `LEAF` | 15 | leaves, vines |
\n| `EARTH` | 20 | dirt, sand, gravel |
\n| `CLOTH` | 30 | wool, hay, cobwebs |
\n| `SOFT` | 40 | sponge, slime, snow |
\n| `CLAY` | 60 | clay, ice, terracotta |
\n| `WOOD` | 120 | logs, planks |
\n| `STONE` | 200 | stone, cobble |
\n| `HARD_STONE` | 280 | deepslate |
\n| `METAL_SOFT` | 340 | gold, copper |
\n| `METAL` | 420 | iron, anvil |
\n| `GEM` | 520 | diamond, emerald |
\n| `OBSIDIAN` | 700 | obsidian |
\n| `NETHERITE` | 1000 | netherite, ancient debris |
\n| `REINFORCED` | 2000 | reinforced deepslate |
\n| `UNBREAKABLE` | \u221e | bedrock, barrier |<\/p>\n
\n\/\/ Register \/ override
\nSableDestructiveAPI.register(Block, double massKg, double breakSpeedMs)
\nSableDestructiveAPI.register(Block, double massKg, Tier tier)
\nSableDestructiveAPI.registerUnbreakable(Block)<\/p>\n
\nSableDestructiveAPI.register(ResourceLocation, double massKg, double breakSpeedMs)
\nSableDestructiveAPI.register(ResourceLocation, double massKg, Tier tier)
\nSableDestructiveAPI.registerUnbreakable(ResourceLocation)<\/p>\n
\nboolean SableDestructiveAPI.isRegistered(Block)
\nvoid SableDestructiveAPI.unregister(Block)<\/p>\n
\ndouble SableDestructiveAPI.getMassKg(BlockState)
\ndouble SableDestructiveAPI.getBreakSpeedMs(BlockState)
\ndouble SableDestructiveAPI.getToughnessUnits(BlockState) \/\/ m\/s \u00d7 10
\n“`<\/p>\n
\n– **Last write wins.** Re-registering the same block replaces the previous entry.
\n– **Idempotent.** Multiple calls with the same arguments are harmless.
\n– **Mass** is in kilograms; the block is a 1m\u00b3 cube. Mass affects explosion kick scaling and diagnostics, not the break decision itself \u2014 that one is purely break-speed (m\/s).
\n– **F3+H** tooltip displays `Toughness: N units` where `N = breakSpeedMs \u00d7 10`.<\/p>\n
\n[[dependencies.examplemod]]
\nmodId = “sabledestructive”
\ntype = “optional”
\nversionRange = “1.1.0,)”
\nordering = “AFTER”
\nside = “BOTH”
\n“`<\/p>\n
\nif (ModList.get().isLoaded(“sabledestructive”)) {
\n ExampleSableCompat.register(); \/\/ wraps the SableDestructiveAPI calls
\n}
\n“`<\/p>\n
\n– **Visuals**: Viaquelt
\n– **Built on top of**: [Sable by ryanhcode<\/p>\n