The Legend of Zelda: Oracle of Seasons and Oracle of Ages (Stewmath/oracles-disasm, US releases)

In both US releases Link's health counts in quarter hearts, the annotators' reading in a comment that calls the starting $0c "3 hearts". The fourth Piece of Heart resets the count to 0 and gives Link a Heart Container with a parameter of 4, one heart. Link's Awakening DX also takes four pieces, but there the fourth adds a heart to a maximum kept in whole hearts and queues $40 of health in eighths, eight hearts' worth. oracles/heart-pieces

About: The Legend of Zelda: Oracle of Seasons and Oracle of Ages Health upgrade

{
 "pieces": 4,
 "maxAdded": 4,
 "unit": "1/4 heart"
}

textbox.s is shared, with an .ifdef ROM_AGES only for the message's text ID. What the Heart Container then does is heart-container. Seasons' collection table is commented less but has the same entries.

Cited by: Health upgrade, The Legend of Zelda: Oracle of Seasons and Oracle of Ages

In both US releases a Heart Container adds its parameter to Link's maximum health, 4 quarters (one heart) for every Heart Container treasure object the data defines and for the one the fourth Piece of Heart gives. It always brings a heart refill of $40, which is sixteen hearts (computed, in the quarter hearts a comment gives), capped at the maximum. Link's Awakening DX's boss container adds a heart and queues $FF of health instead. oracles/heart-container

About: The Legend of Zelda: Oracle of Seasons and Oracle of Ages Health upgrade

{
 "maxAdded": 4,
 "refill": 64,
 "unit": "1/4 heart"
}

The cap is wLinkMaxHealth, the byte after wLinkHealth (include/wram.s L686-L689). Mode c plays a sound and adds nothing if health is already full, which can't happen right after the maximum rose. Which subid a boss leaves wasn't read. The refill goes straight into wLinkHealth; LA's goes through a buffer that drains over several frames.

Cited by: Health upgrade, The Legend of Zelda: Oracle of Seasons and Oracle of Ages

In both US releases what a touch does to Link comes from a collision table indexed by the enemy's collision mode. A standard enemy (Octorok's collision mode) uses the plain damage effect, which sets Link's invincibility counter to $22, so he can't be hit for 34 frames, counted one per object update. The low- and high-knockback effects set 25 and 42. Link's Awakening DX sets $50, 80 frames, on every hit. oracles/hurt-iframes

About: The Legend of Zelda: Oracle of Seasons and Oracle of Ages Invincibility frames

{
 "standard": 34,
 "lowKnockback": 25,
 "highKnockback": 42,
 "ladx": 80
}

The table's b1 bytes are $19, $22, and $2a (L1474-L1476). A value of $80 or more counts up instead, so Link stays invincible without flashing; the rows that push Link without damaging him (LINKDMG_10 to 18) use those, $f8 giving 8 frames. Link also isn't vulnerable while his knockback counter runs (knockback). updateSpecialObjects is called from updateAllObjects (bank0.s L11898-L11901); "one per frame" assumes one object update a frame, which the atlas hasn't read.

Cited by: The Legend of Zelda: Oracle of Seasons and Oracle of Ages

In both US releases the plain damage effect sets Link's knockback counter to 15 (7 and 21 for the low- and high-knockback effects), and the Steadfast Ring halves it. The counter drops by one per object update on the ground, which is a frame if the objects update once a frame (not read). While it runs Link moves at SPEED_140, 1.25 pixels a frame along one axis (computed from the speed table's comment that SPEED_100 is one pixel a frame on one axis, not diagonally), and his top-down normal state skips the d-pad. The angle is taken from the enemy toward a position for Link; that it points away from the enemy is the atlas's reading of objectGetRelativeAngleWithTempVars's header comment, and the position passed for Link wasn't traced. Link's Awakening DX's knockback countdown runs 16 frames. oracles/knockback

About: The Legend of Zelda: Oracle of Seasons and Oracle of Ages Knockback

{
 "frames": 15,
 "lowKnockback": 7,
 "highKnockback": 21,
 "speedPixelsPerFrameOneAxis": 1.25,
 "ladxFrames": 16
}

In the air the counter drops by 2 an update, and when wLinkInAir's bit 7 is set knockback is cancelled. func_5631 copies the knockback angle into Link's angle on a slippery tile and does nothing else. The sidescrolling state calls linkUpdateKnockback too (link.s L3777) but wasn't read past that call. Link's position argument is hFF8C/hFF8D.

Cited by: The Legend of Zelda: Oracle of Seasons and Oracle of Ages

In both US releases a killed enemy's byte in itemDropTables picks a chance and a drop set, and two random values decide the drop. The first picks one bit of a 64-bit chance mask (computed, 1 in 16 to always); the second picks one of the set's 32 entries, which Seasons first maps through a Subrosia set when Link is in Subrosia. A drop Link can't use yet, such as bombs or seeds he hasn't found, becomes no drop. An Octorok drops something 24 times in 64; its set holds 16 hearts, 12 single rupees, and 4 five-rupee pieces. oracles/drops

About: The Legend of Zelda: Oracle of Seasons and Oracle of Ages Item drop table

{
 "chanceIn64": [
  4,
  4,
  8,
  16,
  24,
  32,
  48,
  64
 ],
 "setSize": 32,
 "octorok": {
  "chanceIn64": 24,
  "heart": 16,
  "rupee1": 12,
  "rupee5": 4
 }
}

A table value of $ff drops nothing. Hearts, rupees, and fairies check wc608, which is always 1, so they always pass. Ore chunks drop only in Seasons and only in Subrosia (minimap group 1), through the 16-entry Subrosia set; ITEM_DROP_0a and 0b never pass. A nonzero parameter (breakable tiles, for one) indexes the table's second half. Link's Awakening has no drop claim yet.

Cited by: The Legend of Zelda: Oracle of Seasons and Oracle of Ages

In both US releases a hit copies the enemy's damage value to Link as a negative number, and Link's one active ring changes it: Power Rings L1–L3 add 2, 4, and 8 units, Armor Rings L1–L3 take 1, 2, and 3 off, the Blue Ring halves it with an arithmetic shift that rounds toward more damage (3 units become 2), the Green Ring takes three quarters (rounded toward less damage), and the Cursed Ring doubles it. A hit always costs at least one unit, and the Protection Ring makes every hit 8. Health then drops a quarter heart per 2 units, so a unit is an eighth of a heart (computed, from the quarter hearts a comment gives). Link's Awakening DX's health is in eighths by its annotators' comment ($08 = 1 heart), and its Blue Tunic also halves damage. oracles/ring-damage

About: The Legend of Zelda: Oracle of Seasons and Oracle of Ages Damage formula

{
 "powerRing": [
  2,
  4,
  8
 ],
 "armorRing": [
  -1,
  -2,
  -3
 ],
 "blueRing": 0.5,
 "greenRing": 0.75,
 "cursedRing": 2,
 "protectionRing": 8,
 "minimum": 1,
 "unit": "1/8 heart"
}

An odd amount rounds up to a whole quarter and leaves +1 in w1Link.health, which the next hit's damage is added to. The Protection Ring's 8 replaces the ring-modified amount, since linkApplyDamage runs after the modifier. Where each enemy's Object.damage comes from wasn't read.

Cited by: The Legend of Zelda: Oracle of Seasons and Oracle of Ages