Iustitia / Docs / Movement / WallSprint

WallSprint

[X] Definitive
WallSprint detector — Grim SprintE / OmniSprint wall-sprint (plan §4 #3). Vanilla cancels sprint the instant a player collides horizontally with a wall; the cheat forces the sprint metadata to stay set while pressed against a wall. backwardSprint covers the yaw case; this covers the wall case.
id: wallSprint  ·  class: WallSprintCheck  ·  group: Movement

What it detects

WallSprint detector — Grim SprintE / OmniSprint wall-sprint (plan §4 #3). Vanilla cancels sprint the instant a player collides horizontally with a wall; the cheat forces the sprint metadata to stay set while pressed against a wall. backwardSprint covers the yaw case; this covers the wall case.

Observer signature

sprinting metadata set AND a solid block ahead along the facing yaw within 0.9 (isWallAhead, foot/torso/head bands) AND forward speed along facing <= 0.05 (pressed, not approaching) — a player running AT a wall to jump it still advances and is exempt. Flags at streak >= threshold (5).

False-positive guards

  • Vehicle/gliding/swimming exempt
  • Hurt exempt (tick - hurtTick <= 5, resets) — knockback pins a sprinter against a wall
  • Teleport exempt (tick - lastTeleportTick < 10, resets)
  • Forward-speed gate (<= 0.05) exempts the run-at-wall approach
  • Server-lag pause (8 / 3 windows)
  • Chunk-unloaded → isWallAhead fail-opens to false

Configuration

Defaults (editable in-game via the YACL config screen or /ius config):

FieldDefault
enabledtrue
setbackVL5.0
decay0.5
threshold5.0
WALL_REACH0.9
FORWARD_MAX0.05 b/t
sustain>= threshold (5) ticks
HURT_EXEMPT_TICKS5

Source

src/main/kotlin/dev/iustitia/checks/movement/WallSprintCheck.kt  ↗