Sable Cannon Optimizer
Long-range cannon flight and explosion optimizations for Sable + Create Big Cannons on Minecraft 1.21.1 NeoForge.
Built for artillery-heavy modpacks, this standalone mod reduces repeated work during supported projectile flight and standard explosions. It does not add health cores, shields, or ship health mechanics.
This release is one component of a broader survival and combat systems rework. It shares the project's optimization work as a standalone mod; it is not the complete survival overhaul. Ship health, shields, armor, combat readiness, and progression from that larger project are not included in this download.
Features
- Mathematical long-range flight for supported cannon shells, with cached terrain and physics-body queries.
- Native CBC handling restored before contact or relevant fuze events, preserving penetration, ricochets, payloads, and special effects.
- Explosion-local block/fluid read caching, air-candidate filtering, honey-glue collision guards, and duplicate-detonation protection.
- Explosion drop suppression, including container contents, on terrain and ships.
- Lightweight entity damage with approximate cover checks for living entities and players.
- A persistent command to disable or restore terrain explosion damage while leaving physics-body damage enabled.
Default settings do not shorten explosion rays or replace craters with a volume-based shape. Actual gains vary with ammunition, scene complexity, and the rest of the modpack.
Installation
Requires Minecraft 1.21.1, Java 21, NeoForge 21.1.228+ within the 21.1 series, Sable, and Create Big Cannons, plus their dependencies. Install on both server and clients. Singleplayer is supported. CBC Military Supplement is optional.
Isolated startup validation uses Sable 2.0.6, CBC 5.11.7, CBC Military Supplement 2.1.0, and Create 6.0.10. Other dependency combinations are not automatically certified.
Install only the runtime JAR. Do not install alongside SableHealthbar. The standalone mod retains its sablehealthbar mod ID, command prefix, and flight API namespace. Use a fresh world or backup when switching from the full healthbar mod because its cores are not present here.
Voxy and Voxy Server Side
The default long-range mathematical-flight feature requires a compatible terrain backend, not just Sable and CBC:
- Singleplayer / LAN host: a compatible Voxy client build on the host supplies the local terrain database.
- Dedicated server: install Voxy Server Side (VSS, mod ID
lss) on the server and make its terrain store/backfill service available. A remote player's Voxy installation does not replace this server-side data source.
Voxy and VSS are separate mods. Follow the specific Voxy build's loader and renderer requirements; do not assume any Fabric Voxy JAR works directly on NeoForge. The current development instance uses voxy-offline-0.2.15-beta-m3t4f1v3-1.21.1.jar and VSS reporting version 0.14.0. Compatibility with arbitrary Voxy/VSS releases has not been established, and these backends were not part of the minimal isolated startup validation.
Automatic detection in 0.1.2+: without the appropriate Voxy/VSS mod or a ready, compatible terrain backend, mathematical flight stays off and shells remain native CBC. Explosion optimizations continue to work. optimize cannot bypass this check. Clear diagnostics appear in the server log, operator login messages, command feedback, and /sablehealthbar flight stats.
When the backend becomes ready, an existing flight-on request can become active automatically. Singleplayer takeover also checks that the local Voxy engine matches the projectile's dimension. If a backend stops being available during flight, managed shells pause and attempt native handoff instead of continuing mathematical terrain traversal.
The availability guard does not guarantee complete LOD coverage: areas with no recorded terrain data can still be unknown. Verify terrain coverage for long-range combat. To deliberately keep flight off even with a ready backend, use /sablehealthbar flight off; for persistence, set startupOptimize=false and mathFlight=false in the world server config. Applying optimize again requests mathematical flight subject to the guard.
Quick commands
The recommended optimization preset is applied automatically on server startup. You can reapply it with:
/sablehealthbar optimize
Control terrain explosion damage:
/sablehealthbar terrainbreak off
/sablehealthbar terrainbreak on
/sablehealthbar terrainbreak status
Requires operator permission. The setting persists with the world across dimensions and restarts; optimize does not reset it. It affects future standard explosion destruction, not repair. Physics bodies remain destructible, and entity damage and explosion visuals remain active. Terrain still provides blast resistance and cover.
Important scope
This is a beta intended for destructive artillery combat. Explosion drops and the standard entity-effect model are intentionally changed. It is not a drop-in promise of vanilla TNT mining or redstone behavior.
The terrain switch also covers player-built structures outside physics bodies. It does not block direct kinetic projectile damage or custom effects that bypass standard explosion finalization.
Native terminal handling can still load chunks. Unknown projectile/fuze combinations stay native, and some payloads hand back immediately. Torpedoes, rockets, and bomb racks are not currently covered by mathematical takeover. Special payload effects belong to their original mods.
Please include the exact shell, fuze settings, mod versions, target type, and logs when reporting issues. No fixed performance multiplier is claimed.