251
edits
Ledge Grab: Difference between revisions
programmatically expand page a la Talk:Action and Eaten_By_Bubba
(Cite the code and update to include details from code) |
Icecream17 (talk | contribs) (programmatically expand page a la Talk:Action and Eaten_By_Bubba) |
||
| Line 2: | Line 2: | ||
{{needs_image}} | {{needs_image}} | ||
{{Action_infobox | |||
|title= Ledge Grab | |||
|image= | |||
|official name= | |||
|hex= 0x0800034B | |||
|flags= stationary, pause exit | |||
|group= Automatic | |||
|id= 0x14B | |||
|into= (common automatic cancel: [[Water Plunge]]), [[Soft Bonk]], [[Ledge Climb Fast]], [[Ledge Climb Slow 1]] | |||
|out of= [[Water Jump]], (<code>common_air_action_step</code> + <code>AIR_STEP_CHECK_LEDGE_GRAB</code>: [[Jump]], [[Double Jump]], [[Freefall]], [[Hold Jump]], [[Hold Freefall]], [[Side Flip]], [[Wall Kick Air]], [[Long Jump]]) | |||
|animation= 0x33 (idle on ledge) | |||
|related= | |||
}} | |||
* Mario's vertical velocity is non-positive | A '''ledge grab''' can occur when Mario's position is in the air and his next [[Quarter Steps|quarter step]] would move him inside a wall<ref>https://github.com/n64decomp/sm64/blob/master/src/game/mario_step.c#L472</ref>. If this happens, the game will verify several conditions: | ||
* There is a wall 30 units above Mario. | |||
* There is no wall 150 units above him. | *Mario's vertical velocity is non-positive | ||
*There is a wall 30 units above Mario. | |||
*There is no wall 150 units above him. | |||
If all conditions pass, the game searches for a potential ledge to grab. From Mario's position, it considers a point 60 units in the direction perpendicular to the wall and 160 units above. This point ends up being 10 units into the wall due to Mario's 50 unit radius. From that point, it searches top-down for the first floor hitbox. If a floor hitbox is found, Mario will ledge grab onto it. | If all conditions pass, the game searches for a potential ledge to grab. From Mario's position, it considers a point 60 units in the direction perpendicular to the wall and 160 units above. This point ends up being 10 units into the wall due to Mario's 50 unit radius. From that point, it searches top-down for the first floor hitbox. If a floor hitbox is found, Mario will ledge grab onto it. | ||
| Line 16: | Line 30: | ||
Examples include: | Examples include: | ||
# The wall is slightly slanted forward | #The wall is slightly slanted forward | ||
# There are 2 walls meant to be coplanar that aren't | #There are 2 walls meant to be coplanar that aren't | ||
# If there are 2 parallel walls with the lower one jutting out more | #If there are 2 parallel walls with the lower one jutting out more | ||
==Transition In== | |||
The above conditions are checked for during every <code>common_air_action_step</code> (if the action passes the <code>AIR_STEP_CHECK_LEDGE_GRAB</code> flag)<ref>https://github.com/n64decomp/sm64/blob/9921382a68bb0c865e5e45eb594d9c64db59b1af/src/game/mario_actions_airborne.c#L431</ref>, and the airborne action [[Water Jump]]. An air action will transition into a ledge grab upon a corresponding air step. | |||
Then common automatic action steps are done: | |||
#If Mario is more than 100 units below the water level, do stuff, [[Water Plunge]] (similar to [[Walking]]) | |||
#Set quicksand depth to 0 | |||
==Behavior== | |||
Upon a ledge grab:<ref>https://github.com/n64decomp/sm64/blob/9921382a68bb0c865e5e45eb594d9c64db59b1af/src/game/mario_actions_automatic.c#L543</ref> | |||
#Increment Mario's actionTimer unless it reached 10 | |||
#Note: Mario's position is presumably on the floor he's grabbed onto | |||
#If Mario's floor is too steep (y normal < 0.9063078), [[Ledge Grab#Let go of ledge|let go of ledge]] (see below) | |||
#If Z is pressed or Mario is not on the floor, [[Ledge Grab#Let go of ledge|let go of ledge]] | |||
#Let <code>hasSpaceForMario</code> = is Mario's ceiling height at least 160 units above the floor height? | |||
#If A is pressed and <code>hasSpaceForMario</code>, [[Ledge Climb Fast]] | |||
#If Mario is stomped: | |||
##If Mario's interaction status has the knockback damage flag, increment the hurt counter by 12 or 18 depending on whether Mario has his cap | |||
##[[Ledge Grab#Let go of ledge|Let go of ledge]] | |||
#If the actionTimer is 10, the analog stick is pulled enough, and not(EU version while holding A) | |||
##If the analog stick's intended direction is NOT within 4000 angle of Mario's facing angle, [[Ledge Grab#Let go of ledge|let go of ledge]] | |||
##Else if <code>hasSpaceForMario</code>, [[Ledge Climb Slow 1]] | |||
#If the floor at 30 units behind Mario is higher than 100 units below Mario's current floor and <code>hasSpaceForMario</code>, [[Ledge Climb Fast]] | |||
#Set velocities to zero and set Mario's y position to the floor | |||
#Set animation to MARIO_ANIM_IDLE_ON_LEDGE | |||
==Let go of ledge== | |||
#Set y velocity to 0 | |||
#Set forward velocity to -8 | |||
#Subtract 60sin(facing angle) from Mario's x position | |||
#Subtract 60cos(facing angle) from Mario's z position | |||
#If the floor below Mario is within 100 units vertically, snap Mario to the floor, else subtract 100 from Mario's y position | |||
#[[Soft Bonk]] | |||
==References== | |||
<references /> | |||
{{actions}} | {{actions}} | ||