The Legend of Zelda: Ocarina of Time (the zeldaret decompilation, zeldaret/oot)

In the N64 NTSC 1.0 code, pressing Z locks Link onto the actor Navi hovers over, unless that actor has lock-on disabled; with nothing to lock onto, Z starts "parallel" mode instead. Under the Hold setting the lock lasts while Z is held; under Switch, a flag keeps it after Z is let go. oot/z-lock-on

About: The Legend of Zelda: Ocarina of Time Lock-on targeting

Pressing Z on the current target moves the lock to the actor Navi's arrow hovers over (L3955-L3957), and in Switch, pressing it again with no new target releases the lock (L3969-L3972). A lock also ends when Attention_ShouldReleaseLockOn says so (L3987-L3990), in code (z_actor.c) the atlas hasn't fetched. Parallel mode keeps Link and the camera facing the angle they had when Z was pressed, as the decompilers' comment above the function says (L3863).

Cited by: Lock-on targeting, The Legend of Zelda: Ocarina of Time

In the N64 NTSC 1.0 code, unless an earlier branch applies (hookshot flight, pushing or pulling, and a few others), while Link has a focus actor his update makes that actor the main camera's view target and picks a mode for it: talk mode if Link's actor has the talk flag set, else, with the friendly-focus flag set, boomerang-follow mode if a boomerang is out or the friendly Z-target mode, and otherwise the unfriendly Z-target mode. In parallel mode it picks Z-aim mode when either of two checks the decomp leaves unnamed (func_8002DD78, func_808334B4) passes, else Z-wall-climb mode with an unnamed state flag (stateFlags1 bit 21) set, else the Z-parallel mode. oot/z-target-camera

About: The Legend of Zelda: Ocarina of Time Lock-on targeting

The earlier branches cover cutscenes, hookshot flight, one still-camera action, and pushing or pulling (L11366-L11378). The friendly-focus flag is set for a non-hostile actor, or for any actor while Link carries something (L4003-L4009). What each camera mode does is in z_camera.c, which this pass didn't trace.

Cited by: Lock-on targeting, The Legend of Zelda: Ocarina of Time

In the N64 NTSC 1.0 code, while Link has a lock-on target and the reticle counter (reticleSpinCounter, which the decompilers' comment says counts up while a reticle is active) isn't 0, Link's model turns each update toward the locked-on actor's focus point, and in parallel mode toward the parallel angle; the direction he moves in is a separate yaw, which the stick sets relative to the camera. Two state flags the decomp leaves unnamed skip the turn, and the Z-target run and the roll set one of them. oot/z-target-facing

About: The Legend of Zelda: Ocarina of Time Lock-on targeting

With PLAYER_STATE2_5 set and PLAYER_STATE2_6 clear, the model turns toward the movement yaw instead (L3788-L3789). With the stick neutral and a reticle up, the movement code also aims the target yaw at the locked-on actor (L4135-L4138). The turn's step, 4000 binary-angle units, is scaled by the update rate inside Math_ScaledStepToS (z_lib.c, not fetched), so no per-update figure is given here. Read at the pin but not fetched, z_actor.c makes the counter nonzero only once the reticle has finished zooming in (L617-L623) and resets it to 0 when the lock ends (L2533-L2536), so the turn would begin after the zoom rather than with the lock.

Cited by: Lock-on targeting, The Legend of Zelda: Ocarina of Time

In the N64 NTSC 1.0 code, each update sorts the control stick into one of four quarters relative to the way Link's model faces: forward, left, backward, or right, each 90° wide and centered on its direction, after turning the stick angle by the camera's. Below a magnitude of 55 the stick counts as no direction. oot/stick-quarters

About: The Legend of Zelda: Ocarina of Time Evasive hop

Value: 55 stick magnitude

The stick's magnitude comes from Lib_GetControlStickData, outside the fetched files, so the scale of 55 isn't read here. The quarter is relative to the model's yaw, which a lock-on keeps aimed at the target (z-target-facing), so while locked on "backward" means away from the target.

Cited by: Evasive hop, The Legend of Zelda: Ocarina of Time

In the N64 NTSC 1.0 code, the action handler the decomp calls Player_ActionHandler_10 acts on a press of A, except in a room of the indoors type, on floor type 7, or on a floor with floor effect 1 (both unnamed): with the stick backward, left, or right it starts a hop that way; with the stick forward or neutral, only while Z-targeting, it starts a jump slash if Link holds a melee weapon and can use items, and a roll otherwise. oot/hop-trigger

About: The Legend of Zelda: Ocarina of Time Evasive hop

Player_IsZTargeting covers both a lock-on and parallel mode, per the decompilers' comment (L2585). The hop branch doesn't test Z-targeting itself; which actions offer this handler is in the claim hop-handler-lists.

Cited by: Evasive hop, The Legend of Zelda: Ocarina of Time

In the N64 NTSC 1.0 code, the action that holds Link standing while he Z-targets (Player_Action_808407CC in the decomp) offers the hop handler to A, and hands control to the idle action once Z-targeting ends; the idle action's own handler list leaves the hop handler out. oot/hop-handler-lists

About: The Legend of Zelda: Ocarina of Time Evasive hop

The handler also sits in lists 1, 3, 4, 5, 9, and 10, used by other actions (L8091, L8399, L8522, L8566, L8584, L8611, L8835, L8866, L8896); several of those leave when Z-targeting ends, but this pass traced only the standing one. The list runs before the Z-targeting test in the same update.

Cited by: The Legend of Zelda: Ocarina of Time

In the N64 NTSC 1.0 code, the backward hop (a backflip, by its animation) launches Link at a vertical velocity of 5.8 and a horizontal speed of 6.0 aimed straight behind his facing, and a sideways hop at 3.5 up and 8.5 aimed 90° to the left or right. The vertical value is multiplied by a water factor, sWaterSpeedFactor, which this pass didn't read. oot/hop-speeds

About: The Legend of Zelda: Ocarina of Time Evasive hop

Value: 5.8

The values are the code's own; how the actor code turns speed into distance per frame is in z_actor.c, which this pass didn't fetch, so no unit is given. The backward hop plays the roll sound and the side hops a skip sound (L6382). The animation table names the backward one "backturn_jump"; "backflip" and "sidehop" are players' names.

Cited by: Evasive hop, The Legend of Zelda: Ocarina of Time

In the N64 NTSC 1.0 code, the jump slash started from the Z-targeting A press (stick forward or neutral, holding a melee weapon) sends Link forward along his facing at a speed of 5.0 with a vertical velocity of 5.0. oot/jump-slash

About: The Legend of Zelda: Ocarina of Time Lock-on targeting

Value: 5

Another call starts the same jump slash at 3.0 forward and 4.5 up when B is pressed on a usable floor (func_8083BBA0, L6341-L6343); which actions offer it wasn't traced.

Cited by: The Legend of Zelda: Ocarina of Time

In the N64 NTSC 1.0 code, Link rolls when A is pressed with the stick forward, provided there is no hostile lock-on, his upper body isn't busy, an unnamed state flag (stateFlags1 bit 23) is clear, and the floor isn't floor type 7; with the stick elsewhere the same press puts away a held item or toggles Navi. The roll animation plays at 1.25 times speed (1.5 in the PAL N64 builds). oot/roll

About: The Legend of Zelda: Ocarina of Time Dodge roll

Value: 1.25 × animation speed

The animation speed is also multiplied by sWaterSpeedFactor. The put-away test is heldItemAction >= PLAYER_IA_SWORD_MASTER: the enum puts the fishing rod and a cutscene sword before it, and the swords, Deku Stick, hammer, bows, and further items after it (include/player.h L115-L128). The roll handler sits in the idle list among others (L4201-L4205).

Cited by: Dodge roll, The Legend of Zelda: Ocarina of Time

In the N64 NTSC 1.0 code, a roll makes Link invulnerable for 10 updates from frame 8 of its animation (8 updates in the PAL N64 builds): damage is ignored but, per the decompilers' comment, not the responses to it such as knockback. oot/roll-invulnerability

About: The Legend of Zelda: Ocarina of Time Dodge roll

Value: 10 updates

Player_SetInvulnerability keeps the longer of an existing window and the new one. An update is one run of Link's code, not a video field; the game's update rate isn't read here.

Cited by: Dodge roll, The Legend of Zelda: Ocarina of Time