Cannon Range HUD

By
soleid_

Range prediction, mouse aiming and panoramic optics for Create Big Cannons on Sable vehicles.

Features

See the predicted distance and impact position for assembled CBC cannons, including stationary mounts.
Aim with the mouse from a connected gunner seat. Physical turret and elevation motors continue turning toward the target after the mouse stops.
Use a third-person camera sized for the connected construction, including wings and mechanically attached parts.
Switch between gunner and commander optics with 360 degree horizontal viewing. Scope switching preserves your viewing direction.
Watch a projectile camera from firing to its first impact. The window is hidden inside optics by default.
Store ammunition in a 27-slot rack and transfer complete rounds using Create Mechanical Arms. Live ammunition can detonate and produce a fire column, smoke and secondary explosions.
Add a separate Swashplate Controller to experimental Synaxis helicopters. It changes individual blade pitch as the rotor turns; Synaxis flap aerodynamics supplies the forces.
Choose which HUD features appear using the settings screen or TOML configuration.

Requirements

Minecraft 1.21.1, NeoForge, Create, Create Big Cannons 5.11.7, and Sable 2.0.5. Veil 4.5.0 is used by the bundled optics and projectile camera. Install this mod on both the client and server.

Synaxis 1.4.3 enables chair wiring, physical motor aiming and rotor controls. Qmodeling seats require their Synaxis integration. CBC add-ons are optional; supported ammunition uses CBC's munition contracts. An assembled cannon must belong to the connected construction and be linked to the occupied seat by its controls.

Vestalihy 2.5.5 is included inside this JAR. Remove a separate Vestalihy JAR to avoid duplicate loading. Existing Vestalihy block IDs are preserved.

Controls

Key: F8 | Action: Open HUD settings

Key: F5 | Action: Cycle available seat views and optics

Key: ] | Action: Select cannon

Key: Backslash | Action: Toggle convergence

Key: R | Action: Toggle rangefinder

Key: O | Action: Toggle projectile camera

The pause menu also contains a HUD settings button. Client settings apply immediately and are saved. Server mechanics are configured in config/cannonrangehud-common.toml; display and camera options are in config/cannonrangehud-client.toml.

Swashplate example

apv1_swashplate_example.nbt is an additional Sable schematic based on the supplied APV example. It preserves the rotor assembly and adds the new controller. Missing legacy Simulated sail blocks are replaced with this mod's original Rotor Blade model in the additional variant. The original schematic is unchanged. Right-click the controller to change collective pitch; sneak and right-click to adjust phase in 90 degree steps. Connect the occupied chair's yaw and pitch channels to it. The example restores those connections after loading.

Use a powered dynamic motor and at least three Compact Flaps on its rotor body. Tail yaw additionally requires a physically effective tail propeller and a yaw connection. Phase, blade geometry, lift and power need tuning for each aircraft. This feature is experimental and does not promise stable flight for every imported helicopter.

Ammunition safety

A loaded rack detonates when destroyed, including ordinary mining. Remove all live ammunition before breaking it. Empty magazines and spent supported cartridges do not detonate. Sable assembly preserves inventory. Disable the extended fire and secondary blasts with ammoCookoff=false; the rack's primary detonation still applies.

Compatibility and current limits

Driver seats do not gain gunner controls simply because a cannon is nearby.
Physical joint limits and the available drive power still constrain aiming.
The projectile camera can only draw terrain loaded on the client; remote shell position updates do not load that terrain.
The locally patched Valkyrien Skies/Sable integration is separate from this download. Stock Valkyrien Skies compatibility is not verified by this release.
This build targets Minecraft 1.21.1 only and is an experimental release.

Credits

Cannon Range HUD and its original controller/optic models: Soleid.

Bundled Vestalihy: ZukoDER and BABUZOVA, version 2.5.5, GPL v3 as declared by the original mod. Original metadata, authors and registry IDs are preserved. The Cannon Range HUD additions use MIT; the bundled dependency retains its own license. See META-INF/licenses/BUNDLED-MODS.txt in the JAR.