Sable G-limit

Server-side G-force limiter for Sable bodies: aircraft, ships and any other vehicle moved by forces.
Two limits, set separately:
- Linear G: how fast the vehicle may speed up or slow down (thrust, drag, braking).
- Normal G: how hard it may turn (lift, load factor, how fast the nose can swing).
A hard turn no longer steals thrust, and a powerful engine no longer makes a jet unflyable.
Requirements
- Minecraft 1.21.1
- NeoForge 21.1.248 or newer
- Sable 2.0.5+
The mod is server-side only. It adds no blocks, items or networking, and clients do not need it.
Install
- Put the jar into
mods/on the server. - Start the server once. The config appears at
config/aeronautics_gforce-server.toml. - Tune it live with
/gforce(operator level 2). Changes are saved immediately.
Settings
| Setting | Default | Description |
|---|---|---|
max_linear_g |
3 |
Max acceleration along the flight path, in G. Braking is limited to this value / 1.5. 0 = off. |
max_normal_g |
6 |
Max acceleration across the flight path, in G. 0 = unlimited. |
couple_turn_rate_to_normal_g |
true |
Caps pitch/yaw rate to max_normal_g * 9.81 / speed, so the nose cannot outrun the velocity vector. |
couple_off_speed |
50 m/s |
Below this speed the nose cap is off. |
couple_full_speed |
120 m/s |
From this speed the nose cap applies fully; it blends in smoothly in between. |
min_decomposition_speed |
1 m/s |
Below this speed there is no flight direction, so the whole force is limited by max_linear_g. |
debug_log |
false |
Log requested vs allowed G when the limiter clamps. |
Commands
/agforce is an alias. All commands require permission level 2.
| Command | Effect |
|---|---|
/gforce get |
Show current values. |
/gforce set linear <G> |
Set max_linear_g. |
/gforce set normal <G> |
Set max_normal_g. |
/gforce set couple <true/false> |
Nose cap on or off. |
/gforce set couple_speeds <off> <full> |
Set couple_off_speed and couple_full_speed. |
/gforce set debug <true/false> |
Debug logging on or off. |
/gforce reset |
Restore defaults (keeps debug_log). |
How it works
For every body and physics substep, all impulses applied through Sable's rigid body handle are summed. The net request is split along and across the velocity direction, each part is clamped, and the difference is applied as one correction impulse. Because the split is geometric, thrust vectoring, side thrusters and addon forces are handled the same way.
Not limited: collisions, ship assembly, player punches, Sable commands.