A tiny NeoForge 1.21.1 mod for Sable that keeps you moving with a contraption while you jump, so you land where you took off — including on rotating platforms.
| What | Side | How |
|---|---|---|
| You (jumping, walking) | Client | Carry through jump arcs + frame-rotate velocity |
| Non-player entities (item drops, XP orbs, mobs, boats…) | Server | Same carry state machine, plus tracking is seeded when an entity spawns over a contraption (dropped items pop upward and would otherwise never catch a fast deck). Projectiles are excluded — Sable already gives them launch velocity, and frame-locking would bend their flight. |
| Particles (smoke, flames, block breaking…) | Client | Sable frame-locks particles but releases them after 0.5 blocks of drift with a one-shot linear velocity — rising smoke gets flung tangentially. We re-anchor tracked particles every tick while they stay near the contraption. |
On a server without the mod, the player and particle fixes still work for clients that have it; the entity fix needs the mod on the server.
Config (config/surefooting-client.toml)
| Option | Default | Meaning |
|---|---|---|
enabled | true | Toggle the fix |
rotate_jump_velocity | true | Rotate your airborne velocity with the sub-level's frame, so a jump aimed across a spinning platform lands where you aimed |
rotate_ground_velocity | true | Rotate your walking momentum with the frame too, cancelling most of the sideways (Coriolis-like) pull when moving on a fast spinner |
jump_rotation_strength | 1.16 | Multiplier on the airborne rotation; 1.0 aligns to the frame but trails it slightly while your velocity is applied, values above add lead so cross-jumps stay accurate at any constant spin rate (default tuned in-game) |
ground_rotation_strength | 2.25 | Multiplier on the grounded rotation; higher values also compensate per-step lag on fast spinners (tuned in-game — 2.2–2.3 walks straight), lower toward 1.0 if you curl into the spin |
carry_timeout_ticks | 60 | Max airborne ticks to stay in the contraption's frame |
exit_distance_blocks | 4.0 | Stop carrying once this far outside the sub-level's bounds |
anchor_particles | true | Keep particles anchored to the contraption they spawned on while they stay near it |
debug_logging | false | Log carry transitions and per-jump landing offsets |