Idle

Idle
Properties
Hex	0x0C400201
Action Flags	Stationary, Idle, Allow First Person, Pause Exit
Action Group	Stationary
ID	0x001
Transitions
Into	stationary cancels: Water Plunge, Squished, Standing Death, Quicksand Death; other idle cancels: In Quicksand, Coughing, Panting; common idle cancels: Freefall, Shockwave Bounce, Hold Quicksand Jump Land, Quicksand Jump Land, Steep Jump, Jump, Begin Sliding, First Person Action, Walking, Punching, Start Crouching; non cancel: Shivering, Start Sleeping
Out of	Waking Up, Shivering, Hold Idle, In Quicksand, Panting, Braking Stop, Butt Slide Stop, Hold Butt Slide Stop, Stop Crouching, Stop Crawling, Shockwave Bounce, Jump Land Stop, Double Jump Land Stop, Slideflip Land Stop, Freefall Land Stop, Backflip Land Stop, Lava Boost Land, Long Jump Land Stop (from cancel when INPUT_FIRST_PERSON), Hold Jump Land Stop, Hold Freefall Land Stop, Air Throw Land, Twirling Land, Ground Pound Land, First Person Action, Punching, Placing Down, Throwing, Heavy Throw, Stomach Slide Stop, Releasing Bowser, ("pole cancels": Holding Pole, Climbing Pole, Grab Pole Slow, Grab Pole Fast, Top of Pole Transition, Top of Pole), Ledge Climb Slow 1, Ledge Climb Slow 2, Ledge Climb Fast, Exit Land Save Dialog, Reading Npc Dialog, Reading Automatic Dialog, Reading Sign, Debug Free Move, Star Dance, Entering Star Door, Pushing Door, Pulling Door, Warp Door Spawn, Spawn Spin Landing, Spawn No Spin Landing, Teleport Fade In, Shocked, Squished, Putting On Cap, Head Stuck In Ground, Feet Stuck In Ground, Intro Cutscene, (some warps), (some level initializations), Decelerating, Hard Backward Ground Kb, Hard Forward Ground Kb, Backward Ground Kb, Forward Ground Kb, Soft Backward Ground Kb, Soft Forward Ground Kb, Ground Bonk, Death Exit Land, (when Mario initializes and is not less than or equal to 100 units below the water level)
Other
Animation	0x75 (standing against wall), 0xC3 (idle head left), 0xC4 (idle head right), 0xC5 (idle head center)
Related Actions
Related	Panting, Standing Against Wall, Coughing, Shivering, Start Sleeping, Sleeping

Idle is the action where Mario stands still, turning his head left to right while not moving.

Behavior

Certain things here are more explained on their individual pages. If something lacks detail, check the link for more information.

Before performing the action, stationary cancels are checked.

When performing the Idle action, the following happens:

1. If Mario has sunk more than 30 units into quicksand, his action is set to in quicksand.
2. If Mario is in poison gas AND he is not standing against the wall, his action is set to coughing.
3. If Mario is not against a wall and has low health, his action is set to the panting action.
4. check_common_idle_cancels
5. If Mario's animation has just ended, his head has turned 10 times, and there is ground behind him (that is not an object)
   1. If Mario is in a cold environment, he starts to shiver, else he goes into the start sleeping action.
6. If Mario is against a wall, Mario has his animation changed to be standing against the wall. Otherwise, Mario's animation is set depending on which way he is turning his head.
7. stationary_ground_step

Stationary cancels

A variety of "cancels" are checked prior to actually performing any stationary action. These checks are as follows:

1. Water - If Mario's height is lower than 100 units below the water height:
   • The camera preset is updated.
   • Mario's forward velocity is divided by 4.
   • Mario's y velocity is divided by 2.
   • Mario's height is set to 100 units below the water height.
   • Mario's action is set to water plunge.
2. Squish - If Mario is supposed to be squished:
   • The camera preset is updated.
   • Mario's action is set to squished.
3. If the action is not the unused 0x0E action (always true) and Mario has less than 0x100 health:
   • The camera preset is updated.
   • Mario's action is changed to standing death.
4. Lastly, Mario can interact with quicksand on a quicksand floor. This only cancels if Mario's action is set to quicksand death.
   • Nothing happens if Mario is riding on a shell (though of course, riding a shell isn't a stationary action).
   • If Mario's floor isn't quicksand, the quicksand depth is set to 0, and nothing happens.
   • Else:
     • If Mario's quicksand depth is less than 1.1, it is set to 1.1
     • Mario's quicksand depth is increased by 0.5
     • If Mario's floor type is SURFACE_SHALLOW_QUICKSAND, SURFACE_SHALLOW_MOVING_QUICKSAND, or (SURFACE_QUICKSAND or SURFACE_MOVING_QUICKSAND), then his quicksand depth is capped to at most 10, 25, and 60 units respectively.
     • If (Mario's floor type is SURFACE_DEEP_QUICKSAND or SURFACE_DEEP_MOVING_QUICKSAND, and his quicksand depth is at least 160) or (Mario's floor type is SURFACE_INSTANT_QUICKSAND or SURFACE_INSTANT_MOVING_QUICKSAND):
       • The camera preset is updated.
       • Mario's action is set to Quicksand Death.

The processing goes:

1. Somehow, m->action is set to a stationary action.
2. Right before executing the action, stationary cancels are checked.
3. The action is executed.

Technically, m->action was set to the stationary action. So although the action doesn't really do anything, there is still a "transition" between such stationary action and Water Plunge, Squished, Standing Death, or Quicksand Death. So invariably, for all stationary actions, the infobox contains those 4 actions under "Transitions > Into" first (see top right of page if you don't know what I'm talking about).

check_common_idle_cancels

Note: This is used only in Idle, Start Sleeping, Coughing, In Quicksand, and Panting.

1. If Mario is on a steep cliff, he is pushed off (into freefall).
2. If Mario is hit by a shockwave, his action is set to the shockwave bounce action.
3. If A is pressed, his action is set to a jumping action:
   1. If Mario's quicksand depth is at least 11, then if Mario's holding an object, his action is set to Hold Quicksand Jump Land, else Quicksand Jump Land.
   2. If Mario's floor is steep, his action is set to Steep Jump, else Jump.
4. If Mario is off the floor, Mario's action is set to freefall.
5. If Mario is above a slide, he begins sliding.
6. If Mario goes into first-person mode, his action is set to first person.
7. If the joystick is held in a direction, Mario's action is set to walking.
8. If B is pressed, Mario's action is set to punching.
9. If Z is pressed, Mario's action is set to start crouching.

stationary_ground_step

https://github.com/n64decomp/sm64/blob/66018e9f3caaa67399218971d61366cb3f7ba7d7/src/game/mario_step.c#L236

1. Set Mario's forward velocity, velocity[0], velocity[2], slideVelocityX, and slideVelocityZ to 0.
2. Let step_result = GROUND_STEP_NONE
3. Call mario_update_moving_sand:
   1. If Mario's floor type is {DEEP_MOVING, SHALLOW_MOVING, MOVING, or INSTANT_MOVING}_QUICKSAND:
      1. Change Mario's velocity[0] and velocity[2] based on the floor's "force" data.
      2. return TRUE
   2. else return FALSE
4. Call mario_update_windy_ground:
   1. If Mario's floor type is SURFACE_HORIZONTAL_WIND (like on the ship in Rainbow Ride):
      1. Change Mario's velocity[0] and velocity[2] as if the wind was pushing Mario, based on the floor's "force" data, the global timer, and Mario's facing angle.
      2. return TRUE
   2. else return FALSE
5. If either step 3 or step 4 returned true, step_result = perform_ground_step():
   1. Loop 4 times: Do a quarterstep. The next intended position is Mario's position plus the de facto speed vector. Each time, set step_result to a (value).
      1. Let floor be the (first) floor at the next intended position (very complicated). It must be at least -78 units below Mario's y position.
      2. If the next intended position is OOB, exit loop (WALL)
      3. If Mario is riding a shell and the floor height is less than the water level (which is -11000 by default)
         1. Set floor height to water level
         2. Set floor to the global water surface pseudo floor (very slippery, flags: 0, room: 0, vertices: (0, 0, 0), (0, 0, 0), (0, 0, 0), normal vector: (0, 1, 0) i.e. up)
         3. Set the floor's originOffset to floor height (a comment says this has no effect)
      4. If the floor is more than 100 units below Mario
         1. If Mario's height + 160 units is at least the ceiling height, exit loop (WALL)
         2. Set Mario's position to the next intended position, Mario's floor to the floor, and Mario's floor height to the floor height; exit loop (LEFT GROUND)
      5. If floor height + 160 units is at least the ceiling height, exit loop (WALL)
      6. Set Mario's position to the next intended position, Mario's floor to the floor, and Mario's floor height to the floor height
      7. Let upperWall be a wall within 60 units of (50 units above the next intended position). (This looks even more complicated than finding the floor).
      8. If the upperWall exists AND not(abs(atan2s(upperWall normal z, upperWall normal x) - Mario facing angle[1]) is between 0x2AAA and 0x5555), exit loop (WALL), else (WALL_CONTINUE)
      9. (NONE)
   2. Update Mario's "terrain sound addend", graphics position, and graphics angle.
   3. If step_result is (WALL_CONTINUE), set step_result to (WALL)
   4. Return step_result
6. Else:
   1. Set Mario's y position to the floor height. This is the cause of many downwarps.
   2. Update Mario's graphics position and graphics angle.
7. Return step_result