Wall jump

References

1. ^ abcdA wall jump starts only from a spin jump or another wall jump. Once the spin animation reaches its wall-jump frames, with a direction held away from a wall or solid enemy within 8 px, a new jump press jumps off at 4.625 px/frame up, or 5.5 with the Hi-Jump Boots.CodeInsaneFirebat/sm_disassembly
   How we know

   4838WallJump_Check:
   

   4941  .wallJumpEligiblePressingLeft:
   

   4960  .wallJumpEligiblePressingRight:
   

   LDA.W SamusPhysicsConstants_MaximumDistanceFromWallForWallJump STA.B DP_Temp12 STZ.B DP_Temp14 JSR.W WallJump_Check

   5072  .MaximumDistanceFromWallForWallJump:
   5073; Maximum distance from wall for wall-jump
   

   5136  .InitialYSpeeds_WallJumping:
   ⋮
   5142  .InitialYSpeeds_HiJumpWallJumping:
   

   Checked against the evidence by its author, an AI model, 2026-10-21.

   Checked by a second AI model, 2026-10-21.

   In the claim ledger

2. ^ abOnce Samus is airborne, the run and jump handlers start a jump only while she is in lava. Walking off a ledge makes her airborne at once: VertAccelerate sets the falling gravity on the first frame with nothing below her.Codenmikstas/metroid-disassembly
   How we know

   2252SamusRun:
   2253LCCC2:  ldx SamusDir
   2254    lda SamusGravity
   2255    beq +++++++
   

   2286*   lda SamusInLava
   2287    beq +
   2288    lda Joy1Change
   2289    bmi LCD40       ; branch if JUMP pressed
   

   2720        LDA SamusInLava
   2721        BEQ +
   2722        LDA Joy1Change
   2723        BPL +      ; branch if JUMP not pressed
   2724        JSR LCFC3
   

   5590LE37A:  lda SamusGravity        ;Is Samus rising or falling?
   ⋮
   5599LE38F:  jsr CheckMoveDown       ;($E7AD)Is Samus obstructed downwards?
   ⋮
   5606LE3A0:  lda #$1A            ;Samus is falling. Store falling gravity value.
   5607LE3A2:  sta SamusGravity        ;
   

   Checked against the evidence by its author, an AI model, 2026-10-21.

   Checked by a second AI model, 2026-10-21.

   In the claim ledger

3. ^ abcdA jump that hits a wall at a forward speed above 16 turns Mario around and holds him in ACT_AIR_HIT_WALL. A press on its first 2 frames kicks off the wall. On the 3rd he bonks away, wallKickTimer is set to 5 and counts down once a frame, and A still kicks while it is nonzero: 7 frames in all. The kick takes off at 62 units/frame up and at least 24 forward.Coden64decomp/sm64revised
   How we know

   388        case AIR_STEP_HIT_WALL:
   ⋮
   391            if (m->forwardVel > 16.0f) {
   ⋮
   396                m->faceAngle[1] += 0x8000;
   ⋮
   399                    set_mario_action(m, ACT_AIR_HIT_WALL, 0);
   

   1314    if (++(m->actionTimer) <= 2) {
   1315        if (m->input & INPUT_A_PRESSED) {
   ⋮
   1318            return set_mario_action(m, ACT_WALL_KICK_AIR, 0);
   ⋮
   1320    } else if (m->forwardVel >= 38.0f) {
   1321        m->wallKickTimer = 5;
   ⋮
   1327        return set_mario_action(m, ACT_BACKWARD_AIR_KB, 0);
   1328    } else {
   1329        m->wallKickTimer = 5;
   ⋮
   1337        return set_mario_action(m, ACT_SOFT_BONK, 0);
   

   1156s32 act_backward_air_kb(struct MarioState *m) {
   1157    if (check_wall_kick(m)) {
   1158        return TRUE;
   

   1247s32 act_soft_bonk(struct MarioState *m) {
   1248    if (check_wall_kick(m)) {
   1249        return TRUE;
   

   1147s32 check_wall_kick(struct MarioState *m) {
   1148    if ((m->input & INPUT_A_PRESSED) && m->wallKickTimer != 0 && m->prevAction == ACT_AIR_HIT_WALL) {
   1149        m->faceAngle[1] += 0x8000;
   1150        return set_mario_action(m, ACT_WALL_KICK_AIR, 0);
   

   1407    if (m->wallKickTimer > 0) {
   1408        m->wallKickTimer--;
   

   1705        update_mario_inputs(gMarioState);
   ⋮
   1714        // The function can loop through many action shifts in one frame,
   ⋮
   1717        while (inLoop) {
   

   828        case ACT_WALL_KICK_AIR:
   829        case ACT_TOP_OF_POLE_JUMP:
   830            set_mario_y_vel_based_on_fspeed(m, 62.0f, 0.0f);
   831            if (m->forwardVel < 24.0f) {
   832                m->forwardVel = 24.0f;
   

   Checked against the evidence by its author, an AI model, 2026-10-21.

   Revised after a check by a second AI model, 2026-10-21.

   In the claim ledger

4. ^ abWhen a spin jump or Screw Attack touches a wall, SamusCheckCollisions sets walljumpTimer to 8 and stores the direction away from the wall. Each time SamusSpinning runs, unless the Space Jump is active and Samus isn't slowed (slowedByLiquid), it takes 1 from a nonzero timer, and if Samus faces away from the wall, a new A press, with a solid block 10 px (40 subpixels) to the wall's side, starts a wall jump. The jump takes off at the normal or High Jump speed (mzm/jump-speed). Metroid takes a jump press in the air only in lava (metroid-samus/no-air-jump), so it has no wall jump.Codemetroidret/mzmrevised
   How we know

   1109            case SPOSE_SPINNING:
   1110            case SPOSE_SCREW_ATTACKING:
   1111                pData->walljumpTimer = 8;
   1112                pData->lastWallTouchedMidAir = pData->direction ^ (KEY_RIGHT | KEY_LEFT);
   

   4716    if (gEquipment.suitMiscActivation & SMF_SPACE_JUMP && !gSamusPhysics.slowedByLiquid)
   ⋮
   4723            else
   ⋮
   4729    else
   ⋮
   4731        // Check can wall jump
   4732        if (pData->walljumpTimer != 0)
   ⋮
   4734            pData->walljumpTimer--;
   ⋮
   4736            // Holding correct direction and pressed A
   4737            if (pData->direction & pData->lastWallTouchedMidAir)
   ⋮
   4739                if (gChangedInput & KEY_A)
   ⋮
   4741                    // Get check offset
   4742                    if (pData->lastWallTouchedMidAir & KEY_RIGHT)
   4743                        xOffset = -(HALF_BLOCK_SIZE + EIGHTH_BLOCK_SIZE);
   ⋮
   

   4760    // Check turn
   4761    if (gButtonInput & (OPPOSITE_DIRECTION(pData->direction)))
   ⋮
   4763        pData->direction ^= KEY_RIGHT | KEY_LEFT;
   

   1739            // Perform wall jump, set spinning
   1740            pData->pose = SPOSE_SPINNING;
   ⋮
   1742            if (pCopy->forcedMovement == FORCED_MOVEMENT_MID_AIR_JUMP)
   ⋮
   1744                if (pEquipment->suitMiscActivation & SMF_HIGH_JUMP)
   1745                    pData->yVelocity = SAMUS_HIGH_JUMP_VELOCITY;
   1746                else
   1747                    pData->yVelocity = SAMUS_LOW_JUMP_VELOCITY;
   

   Checked against the evidence by its author, an AI model, 2026-10-22.

   Revised after a check by a second AI model, 2026-10-22.

   In the claim ledger

5. ^ abIn Super Mario Sunshine, by the decompilers' Player code, which doesn't yet match, when jumpProcess reports a wall to jumpingBasic during a jump, Mario is knocked back if his forward speed is above the parameter mClashSpeed (default 50) outside the wire roll jump, stops on Yoshi, stops on a wall marked isNoWallJump, and catches a fence (isFence). Otherwise, at a forward speed above 16, he turns about (after playerRefrection) and, against a wall, holds on in MARIO_STATUS_WALL_SLIDE. There stayWall adds 1 to the status timer each update, capped at 60, and 1 more while it is below 20, so he hangs still for 10 updates and then slides down at half the timer: −10.5 on the 11th update, then 0.5 faster each update to −30 (computed). An A press on any update on the wall kicks: startJumpWall turns him about and enters MARIO_STATUS_WALL_JUMP, whose take-off in setStatusToJumping is 62 up and 24 forward, constants in the code; the 52 that startJumpWall writes first is overwritten. Landing or losing the wall ends the hold. Super Mario 64 kicks at the same 62 up and at least 24 forward, and its act_air_hit_wall also writes a 52 that the kick's take-off overwrites, but it holds Mario only 2 frames and then bonks him away, with A still working for 5 more: 7 frames in all (sm64/wall-kick). With no wall to hold, Sunshine bonks him the way Super Mario 64 does: back down at 38 or faster, and at −8 if faster than 8.Code notesdoldecomp/sms · n64decomp/sm64revised
   How we know

   947            Object(NonMatching, "Player/MarioJump.cpp"),
   ⋮
   949            PCHObject(NonMatching, "Player/MarioMove.cpp"),
   950            Object(NonMatching, "Player/MarioPhysics.cpp"),
   ⋮
   964            PCHObject(NonMatching, "Player/MarioInit.cpp"),
   

   201	case 2:
   202		if (mStatus != MARIO_STATUS_WIRE_ROLL_JUMP
   203		    && mForwardVel > mDeParams.mClashSpeed.get()) {
   ⋮
   205			changePlayerDropping(MARIO_STATUS_JUMP_SHORT_BACK_DOWN, 0U);
   ⋮
   209		if (onYoshi()) {
   210			setPlayerVelocity(0.0f);
   ⋮
   213		if (mWallPlane != nullptr) {
   214			if (mWallPlane->isNoWallJump()) {
   ⋮
   216				setPlayerVelocity(0.0f);
   ⋮
   220		if (mWallPlane != nullptr) {
   221			if (mWallPlane->isFence()) {
   ⋮
   228				return changePlayerStatus(MARIO_STATUS_FENCE_JUMP_CATCH, 0, 0);
   ⋮
   

   252			if (mForwardVel > 8.0f)
   253				setPlayerVelocity(-8.0f);
   254			return changePlayerStatus(MARIO_STATUS_LAND_SAFE_DOWN, 0, 0);
   

   510    , PARAM_INIT(mClashSpeed, 50.0f)
   

   586BOOL TMario::stayWall()
   ⋮
   588	mStatusTimer += 1;
   589	if (mStatusTimer > 60)
   590		mStatusTimer = 60;
   ⋮
   592	if (mInput & 2)
   593		return startJumpWall();
   ⋮
   598	if (mStatusTimer < 20) {
   599		mStatusTimer += 1;
   600		mVel.set(0.0f, 0.0f, 0.0f);
   601	} else {
   602		mVel.y = -mStatusTimer * 0.5f;
   ⋮
   610	switch (jumpProcess(0)) {
   ⋮
   

   16BOOL TMario::startJumpWall()
   ⋮
   25	mVel.y = 52.0f;
   26	mFaceAngle.y += 0x8000;
   27	if (mVel.y + (160.0f + mPosition.y) >= mFloorPosition.x)
   28		mVel.y = 1.0f;
   ⋮
   30	return changePlayerStatus(MARIO_STATUS_WALL_JUMP, 0, 0);
   

   517	case MARIO_STATUS_WALL_JUMP:
   518		setPlayerJumpSpeed(0.0f, 62.0f);
   519		mForwardVel = 24.0f;
   

   733	switch (status & MARIO_STATUS_TYPE_MASK) {
   ⋮
   737	case MARIO_STATUS_TYPE_JUMPING:
   738		status = setStatusToJumping(status, arg);
   

   1479	if (mGamePad->checkFrameMeaning(TMarioGamePad::MEANING_A))
   1480		mInput |= 0x2;
   

   1314    if (++(m->actionTimer) <= 2) {
   1315        if (m->input & INPUT_A_PRESSED) {
   1316            m->vel[1] = 52.0f;
   1317            m->faceAngle[1] += 0x8000;
   1318            return set_mario_action(m, ACT_WALL_KICK_AIR, 0);
   ⋮
   1320    } else if (m->forwardVel >= 38.0f) {
   1321        m->wallKickTimer = 5;
   ⋮
   1327        return set_mario_action(m, ACT_BACKWARD_AIR_KB, 0);
   ⋮
   1329        m->wallKickTimer = 5;
   ⋮
   1334        if (m->forwardVel > 8.0f) {
   1335            mario_set_forward_vel(m, -8.0f);
   ⋮
   1337        return set_mario_action(m, ACT_SOFT_BONK, 0);
   

   1147s32 check_wall_kick(struct MarioState *m) {
   1148    if ((m->input & INPUT_A_PRESSED) && m->wallKickTimer != 0 && m->prevAction == ACT_AIR_HIT_WALL) {
   1149        m->faceAngle[1] += 0x8000;
   1150        return set_mario_action(m, ACT_WALL_KICK_AIR, 0);
   

   1407    if (m->wallKickTimer > 0) {
   1408        m->wallKickTimer--;
   

   828        case ACT_WALL_KICK_AIR:
   829        case ACT_TOP_OF_POLE_JUMP:
   830            set_mario_y_vel_based_on_fspeed(m, 62.0f, 0.0f);
   831            if (m->forwardVel < 24.0f) {
   832                m->forwardVel = 24.0f;
   

   Checked against the evidence by its author, an AI model, 2026-10-22.

   Revised after a check by a second AI model, 2026-10-22.

   In the claim ledger

6. ^ abMario can jump off a wall because the foot check counts a block in the wall's side as ground. If his move into a wall puts a foot point in a wall block while he is falling and less than 5 px below a block boundary, PlayerBGCollision lands him there; he starts the next frame on the ground, so a fresh press of A then jumps.CodeXkeeper0/smb1
   How we know

   11215	LDY $04                                      ; check lower nybble of vertical coordinate returned
   11216	CPY #$05                                     ; from collision detection routine
   11217	BCC LandPlyr                                 ; if lower nybble < 5, branch
   ⋮
   11221LandPlyr:
   ⋮
   11223	LDA #$f0
   11224	AND Player_Y_Position                        ; mask out lower nybble of player's vertical position
   11225	STA Player_Y_Position                        ; and store as new vertical position to land player properly
   ⋮
   11227	LDA #$00
   ⋮
   11231InitSteP:
   11232	LDA #$00
   11233	STA Player_State                             ; set player's state to normal
   

   4922	LDA Player_State                             ; check player state
   4923	BEQ InitJS                                   ; if on the ground, branch
   

   Checked against the evidence by its author, an AI model, 2026-10-22.

   Checked by a second AI model, 2026-10-22.

   In the claim ledger

7. ^ abA wall jump's press has to come on a frame that starts with Mario caught on the wall's side, which is the frame after the catch and, when his foot went 1 px deeper, the frame after that too. Measured in the cartridge with big Mario, the window was one frame for a walking jump into a wall laid into World 1-1's start, two for a running hop into the level's first pipe, unedited, and one for a running hop from the bricks into World 2-1's last wall (smb1/world-2-1-wall-jump); a press on the catch frame itself, or one frame after the window, did nothing.VerifiedXkeeper0/smb1revised
   How we know

   LDY $04 CPY #$05 BCC LandPlyr

   11566	LDY #$00
   ⋮
   11573	CLC
   

   11221LandPlyr:
   ⋮
   11227	LDA #$00
   ⋮
   11231InitSteP:
   11232	LDA #$00
   

   4921ProcJumping:
   

   Measured by a script in MesenCE 2.2.1 (build 4b8a196), on . It fails if the result disagrees with the claim.

   The numbers come from the run; its author, an AI model, checked the script measures what the claim says, 2026-10-25.

   Revised after a check by a second AI model, 2026-10-22.

   Revised after a check by a second AI model, 2026-10-25.

   In the claim ledger

8. ^ abSuper Mario Wiki counts Super Mario Bros.' wall jump among the glitches that resemble the later, designed Wall Jump, with "frame-perfect timing"; TASVideos' resource page explains it by the floor check running during the push out of a wall, and asks for speed above 16 (1 px/frame) toward the wall and feet meeting it at a block boundary.WikiSuper Mario Wiki, “Wall Jump” · TASVideos, “Game Resources: NES Super Mario Bros.”
   How we know

   maneuvers similar to the Wall Jump exist as glitches. For example, in Super Mario Bros., if Mario lands on a wall on a 16×16 boundary (so that his foot is on the top corner of a block), the player is able to jump from that point with frame-perfect timing.

   Walljump happens because the game does a floor check (a simple "is there a solid block below him?" test) even during a wall-ejection. … Some horizontal speed towards the wall (facing right: X speed > 16, facing left: X speed < 240)

   Checked against the evidence by its author, an AI model, 2026-10-22.

   Checked by a second AI model, 2026-10-22.

   In the claim ledger

9. ^ abWhen a foot point finds an ordinary solid block and Mario isn't moving up, PlayerBGCollision lands him if his Y is less than 5 px into the block's 16 px row; 5 px or more, it calls ImpedePlayerMove in his moving direction instead, which pushes him 1 px back unless he is already moving away, and leaves without checking his sides.CodeXkeeper0/smb1revised
   How we know

   11202ChkFootMTile:
   ⋮
   11205	LDY Player_Y_Speed                           ; check player's vertical speed
   11206	BMI DoPlayerSideCheck                        ; if player moving upwards, branch
   ⋮
   11215	LDY $04                                      ; check lower nybble of vertical coordinate returned
   11216	CPY #$05                                     ; from collision detection routine
   11217	BCC LandPlyr                                 ; if lower nybble < 5, branch
   11218	LDA Player_MovingDir
   11219	STA $00                                      ; use player's moving direction as temp variable
   11220	JMP ImpedePlayerMove                         ; jump to impede player's movement in that direction
   

   Checked against the evidence by its author, an AI model, 2026-10-22.

   Revised after a check by a second AI model, 2026-10-22.

   In the claim ledger