Movement steps - Revision history

Icecream17: /* Common Air Step Results */ Lava Boost on Wall

2025-08-19T16:29:37Z

Common Air Step Results: Lava Boost on Wall

← Older revision		Revision as of 16:29, 19 August 2025
Line 103:		Line 103:
	** Mario's action is set to the [[Start Hanging\|start hanging]] action.		** Mario's action is set to the [[Start Hanging\|start hanging]] action.
	* '''Lava Wall Boosts'''		* '''Lava Wall Boosts'''
	** ~~Mario's yaw is set perpendicular to the wall.~~		** [[Lava Boost on Wall]]
	** Mario's forward speed is capped to 24.
	** If Mario is not wearing a metal cap, he is hurt 12 (or 18 without his hat).
	** Mario plays the noise for being burned.
	** The camera preset is set to the area's default preset.
	** Mario enters the [[Lava Boost~~\|lava boost~~]] ~~action while dropping any held objects and no longer riding a shell.~~

	=== Common Air Knockback Step ===		=== Common Air Knockback Step ===

ChouxZi3 at 13:24, 25 May 2024

2024-05-25T13:24:47Z

← Older revision		Revision as of 13:24, 25 May 2024
Line 1:		Line 1:
	Typically, Mario's position is updated incrementally using his velocity. These increments are called '''steps''', and they behave differently when Mario is on the ground, in the air, in water, hanging, and climbing a pole. When on the ground or in the air, these steps typically occur four times per frame, and are commonly referred to as '''quarter steps''' or ~~sometimes~~ '''quarter frames'''.		Typically, Mario's position is updated incrementally using his velocity. These increments are called '''steps''', and they behave differently when Mario is on the ground, in the air, in water, hanging, and climbing a pole. When on the ground or in the air, these steps typically occur four times per frame, and are commonly referred to as '''quarter steps''' or colloquially '''quarter frames'''.

	Steps are also responsible for detecting collision with [[surfaces]], updating Mario's [[referenced surfaces]], and updating Mario's [[Water\|water level]]. However, quarter steps don't detect object collisions or warps.		Steps are also responsible for detecting collision with [[surfaces]], updating Mario's [[referenced surfaces]], and updating Mario's [[Water\|water level]]. However, quarter steps don't detect object collisions or warps.

Icecream17: add common air knockback step

2024-05-19T13:54:59Z

add common air knockback step

@@ Line 109: / Line 109: @@
 ** The camera preset is set to the area's default preset.
 ** Mario enters the [[Lava Boost|lava boost]] action while dropping any held objects and no longer riding a shell.
 [[Category:Action Mechanics]]

Icecream17: /* Quarter-Frame Checks */ forgot "color:"

2024-01-21T01:16:43Z

Quarter-Frame Checks: forgot "color:"

Icecream17: /* Quarter-Frame Checks */ make the effect of flags easier to look for

2024-01-21T01:16:07Z

Quarter-Frame Checks: make the effect of flags easier to look for

Icecream17: /* Air Step */ clarify the actual events

2023-08-01T20:54:37Z

Air Step: clarify the actual events

← Older revision		Revision as of 20:54, 1 August 2023
Line 10:		Line 10:
	# Else, set Mario's y position to the floor, (possibly causing a [[downwarp]]), and update graphics. Return GROUND_STEP_NONE.		# Else, set Mario's y position to the floor, (possibly causing a [[downwarp]]), and update graphics. Return GROUND_STEP_NONE.
	Also see [[Idle#stationary ground step]]		Also see [[Idle#stationary ground step]]

	== Air Step ==		== Air Step ==
	''Certain things here are more explained on their individual pages. If something lacks detail, check the link for more information.''		''Certain things here are more explained on their individual pages. If something lacks detail, check the link for more information.''
Line 48:		Line 47:
	# This repeats until Mario encounters something besides '''nothing happens''', up to four times including the initial time.		# This repeats until Mario encounters something besides '''nothing happens''', up to four times including the initial time.
	# Mario tracks his "exit", with '''nothing happens''' being tracked if the whole process completed four times.		# Mario tracks his "exit", with '''nothing happens''' being tracked if the whole process completed four times.
	~~With~~ the ~~outcome selected and~~ the ~~movement mostly done, a series~~ of ~~things happen.~~
	* If Mario's velocity is ~~not negative~~, ~~his "~~peak height" is ~~updated.~~		=== Perform Air Step ===
	* Mario's step noise is updated based on his floor.
	* If Mario is not flying, [[Gravity#Mario\|gravity]] is applied.		# Set Mario's wall to null
	* [[Vertical Wind\|Vertical wind]] is now applied/accounted for.		# (this is a loop) Do 4 times:
	* Mario's visual position is updated to Mario's position.		## Let the next intended position be Mario's position plus velocity/4
	* Mario's yaw is updated to match the in-game angle.		## Perform an air quarter step, where "new position" means "next intended position" btw, as shown above
			## If nothing happens, continue loop, else exit loop
			# Let stepResult be the result of the last air quarter step performed
			# If Mario's y velocity is positive, set peak height to Mario's y position (the peak height field is used for things like fall damage)
			# Mario's step noise is updated based on his floor.
			# If Mario is not flying, [[Gravity#Mario\|gravity]] is applied.
			#[[Vertical Wind\|Vertical wind]] is now applied/accounted for.
			# Mario's visual position is updated to Mario's position.
			# Mario's yaw is updated to match the in-game angle.
			# Return stepResult

	=== Common Air Step Results ===		=== Common Air Step Results ===
	If doing a common air step, Mario now decides what to do based off the "exit" from ~~the quarter-frame checks before~~. Here is what he does for each exit:		If doing a common air step, Mario now decides what to do based off the "exit" from Perform Air Step. Here is what he does for each exit:
	* '''Nothing Happens''':		* '''Nothing Happens''':
	** Mario's animation is now applied.		** Mario's animation is now applied.

Icecream17: stationary ground step exists twice

2023-07-27T23:21:35Z

stationary ground step exists twice

← Older revision		Revision as of 23:21, 27 July 2023
Line 2:		Line 2:

	Steps are also responsible for detecting collision with [[surfaces]], updating Mario's [[referenced surfaces]], and updating Mario's [[Water\|water level]]. However, quarter steps don't detect object collisions or warps.		Steps are also responsible for detecting collision with [[surfaces]], updating Mario's [[referenced surfaces]], and updating Mario's [[Water\|water level]]. However, quarter steps don't detect object collisions or warps.

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

	# Mario's x and z forward velocity and sliding velocity is set to 0		# Mario's x and z forward velocity and sliding velocity is set to 0
	# mario_update_moving_sand		# mario_update_moving_sand
Line 11:		Line 9:
	# If updated by moving sand or windy ground, return perform_ground_step		# If updated by moving sand or windy ground, return perform_ground_step
	# Else, set Mario's y position to the floor, (possibly causing a [[downwarp]]), and update graphics. Return GROUND_STEP_NONE.		# Else, set Mario's y position to the floor, (possibly causing a [[downwarp]]), and update graphics. Return GROUND_STEP_NONE.
			Also see [[Idle#stationary ground step]]

	== Air Step ==		== Air Step ==

Icecream17: add stationary step

2023-03-05T21:47:07Z

add stationary step

← Older revision		Revision as of 21:47, 5 March 2023
Line 2:		Line 2:

	Steps are also responsible for detecting collision with [[surfaces]], updating Mario's [[referenced surfaces]], and updating Mario's [[Water\|water level]]. However, quarter steps don't detect object collisions or warps.		Steps are also responsible for detecting collision with [[surfaces]], updating Mario's [[referenced surfaces]], and updating Mario's [[Water\|water level]]. However, quarter steps don't detect object collisions or warps.

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

			# Mario's x and z forward velocity and sliding velocity is set to 0
			# mario_update_moving_sand
			# mario_update_windy_ground
			# If updated by moving sand or windy ground, return perform_ground_step
			# Else, set Mario's y position to the floor, (possibly causing a [[downwarp]]), and update graphics. Return GROUND_STEP_NONE.

	== Air Step ==		== Air Step ==
Line 7:		Line 16:

	When an action performs a ''common'' air step, the first thing Mario does is update his horizontal velocity/sideways position via [[straining]]. This is only for the common air step and is not part of the quarter-frame checks.		When an action performs a ''common'' air step, the first thing Mario does is update his horizontal velocity/sideways position via [[straining]]. This is only for the common air step and is not part of the quarter-frame checks.

	=== Quarter-Frame Checks ===		=== Quarter-Frame Checks ===

	After that is updated, the movement is split into "quarter-steps" that breakdown Mario's movement and determine what his outcome of each step is. The checks for the quarter-steps are as follows:		After that is updated, the movement is split into "quarter-steps" that breakdown Mario's movement and determine what his outcome of each step is. The checks for the quarter-steps are as follows:
	# The position a quarter of Mario's velocity ahead of Mario is checked for cancels/outcomes. Anything in bold is an exit out of the rest of the checks.		# The position a quarter of Mario's velocity ahead of Mario is checked for cancels/outcomes. Anything in bold is an exit out of the rest of the checks.
Line 42:		Line 49:
	# This repeats until Mario encounters something besides '''nothing happens''', up to four times including the initial time.		# This repeats until Mario encounters something besides '''nothing happens''', up to four times including the initial time.
	# Mario tracks his "exit", with '''nothing happens''' being tracked if the whole process completed four times.		# Mario tracks his "exit", with '''nothing happens''' being tracked if the whole process completed four times.

	With the outcome selected and the movement mostly done, a series of things happen.		With the outcome selected and the movement mostly done, a series of things happen.
	* If Mario's velocity is not negative, his "peak height" is updated.		* If Mario's velocity is not negative, his "peak height" is updated.
Line 50:		Line 56:
	* Mario's visual position is updated to Mario's position.		* Mario's visual position is updated to Mario's position.
	* Mario's yaw is updated to match the in-game angle.		* Mario's yaw is updated to match the in-game angle.

	=== Common Air Step Results ===		=== Common Air Step Results ===
	If doing a common air step, Mario now decides what to do based off the "exit" from the quarter-frame checks before. Here is what he does for each exit:		If doing a common air step, Mario now decides what to do based off the "exit" from the quarter-frame checks before. Here is what he does for each exit:
	* '''Nothing Happens''':		* '''Nothing Happens''':
	** Mario's animation is now applied.		** Mario's animation is now applied.
	* '''Lands''':		* '''Lands''':
Line 77:		Line 82:
	*** Mario plays a noise depending on whether or not he is wearing a metal cap.		*** Mario plays a noise depending on whether or not he is wearing a metal cap.
	** If Mario's forward velocity is more than 16 and he is not in contact with a physical wall/surface (i.e. OOB):		** If Mario's forward velocity is more than 16 and he is not in contact with a physical wall/surface (i.e. OOB):
	*** A different sound is played, but Mario's yaw is not reflected. ~~<!-- Some of these reflection calculations may be wrong -->~~		*** A different sound is played, but Mario's yaw is not reflected.
	** If Mario is in contact with a wall, his action is set to the [[Air Hit Wall\|air hit wall]] action.		** If Mario is in contact with a wall, his action is set to the [[Air Hit Wall\|air hit wall]] action.
	** If Mario is not in contact with a wall (i.e. hitting OOB):		** If Mario is not in contact with a wall (i.e. hitting OOB):
Line 94:		Line 99:
	** If Mario is not wearing a metal cap, he is hurt 12 (or 18 without his hat).		** If Mario is not wearing a metal cap, he is hurt 12 (or 18 without his hat).
	** Mario plays the noise for being burned.		** Mario plays the noise for being burned.
	** The camera preset is set to the area's default preset. ~~<!-- This is overly simplified, perhaps best put on the camera page -->~~		** The camera preset is set to the area's default preset.
	** Mario enters the [[Lava Boost\|lava boost]] action while dropping any held objects and no longer riding a shell.		** Mario enters the [[Lava Boost\|lava boost]] action while dropping any held objects and no longer riding a shell.

	[[Category:Action Mechanics]]		[[Category:Action Mechanics]]

MMMMMMMMMMMMM: MMMMMMMMMMMMM moved page Movement Steps to Movement steps: Sentence casify the wiki

2021-05-11T01:46:52Z

MMMMMMMMMMMMM moved page Movement Steps to Movement steps: Sentence casify the wiki

← Older revision	Revision as of 01:46, 11 May 2021
(No difference)

Macrepeh: Reverted edits by Macrepeh (talk) to last revision by SuperM789

2021-02-10T15:32:52Z

Reverted edits by Macrepeh (talk) to last revision by SuperM789

← Older revision		Revision as of 15:32, 10 February 2021
Line 96:		Line 96:
	** The camera preset is set to the area's default preset. <!-- This is overly simplified, perhaps best put on the camera page -->		** The camera preset is set to the area's default preset. <!-- This is overly simplified, perhaps best put on the camera page -->
	** Mario enters the [[Lava Boost\|lava boost]] action while dropping any held objects and no longer riding a shell.		** Mario enters the [[Lava Boost\|lava boost]] action while dropping any held objects and no longer riding a shell.
	~~==De Facto Speed==~~
	~~[[File:Imagen1.png\|thumb\|276px\|Blue arrows: Speed Green arrows: De Facto Speed]]~~
	'''De Facto Speed''' is the product of Mario's horizontal speed and the normal.y value of the slope he is standing on. It gets smaller as Mario's slope gets steeper. The game calculates this value and often uses it in place of horizontal speed.


	[[Category:Action Mechanics]]		[[Category:Action Mechanics]]

← Older revision		Revision as of 01:16, 21 January 2024
Line 19:		Line 19:
	## If the position is above OOB but below Mario's current floor height, Mario's height is changed to the floor height and he '''lands'''.		## If the position is above OOB but below Mario's current floor height, Mario's height is changed to the floor height and he '''lands'''.
	## If the position is above OOB but not below Mario's current floor height, Mario's height is set to the new height and he '''hits a wall'''.		## If the position is above OOB but not below Mario's current floor height, Mario's height is set to the new height and he '''hits a wall'''.
	## If the action has the <span style="green">"riding shell" flag</span> and the water level at the position is above the position's floor (up to 78 units above the position):		## If the action has the <span style="color:green;">"riding shell" flag</span> and the water level at the position is above the position's floor (up to 78 units above the position):
	##* The floor height from here on is the water height.		##* The floor height from here on is the water height.
	##* The floor from this point on is a "fake" floor on the surface of the water.		##* The floor from this point on is a "fake" floor on the surface of the water.
Line 33:		Line 33:
	## If the position's height is 160 units under, at, or above a ceiling and his vertical velocity is positive or zero:		## If the position's height is 160 units under, at, or above a ceiling and his vertical velocity is positive or zero:
	##* Mario's vertical velocity is set to zero.		##* Mario's vertical velocity is set to zero.
	##* If the ceiling above Mario is hangable and the air step has the <span style="green">"check hang" flag</span>, Mario '''hangs'''. (Since this did not use the new position's ceiling/location, this is potentially a [[Hangable Ceiling Upwarp\|hangable-ceiling upwarp.]])		##* If the ceiling above Mario is hangable and the air step has the <span style="color:green;">"check hang" flag</span>, Mario '''hangs'''. (Since this did not use the new position's ceiling/location, this is potentially a [[Hangable Ceiling Upwarp\|hangable-ceiling upwarp.]])
	##* Otherwise, '''nothing happens'''.		##* Otherwise, '''nothing happens'''.
	## If the position's height is 160 units under, at, or above a ceiling and his vertical velocity is negative:		## If the position's height is 160 units under, at, or above a ceiling and his vertical velocity is negative:
	##* If the position's height is at or below Mario's floor height, Mario's height is set to the floor height, and he '''lands'''.		##* If the position's height is at or below Mario's floor height, Mario's height is set to the floor height, and he '''lands'''.
	##* Otherwise, Mario's height is set to the new height and he '''hits a wall'''.		##* Otherwise, Mario's height is set to the new height and he '''hits a wall'''.
	## If there is a wall 30 units above the position but not 150 units above the position and the air step has the <span style="green">"check ledge grab" flag</span>:		## If there is a wall 30 units above the position but not 150 units above the position and the air step has the <span style="color:green;">"check ledge grab" flag</span>:
	##* If Mario's velocity is positive, Mario is pushed by the wall opposite the velocity direction, and there is a floor 60 units behind the wall within 238 units upward, Mario '''ledge grabs'''. (Potentially a [[GLG]])		##* If Mario's velocity is positive, Mario is pushed by the wall opposite the velocity direction, and there is a floor 60 units behind the wall within 238 units upward, Mario '''ledge grabs'''. (Potentially a [[GLG]])
	##* Otherwise Mario's position is set to the new position, his floor and floor height are updated, and '''nothing happens'''.		##* Otherwise Mario's position is set to the new position, his floor and floor height are updated, and '''nothing happens'''.