6780dd0d45
- Created detailed documentation for the Kydrog Boss sprite, outlining its phases, behaviors, and mechanics. - Added analysis for the Manhandla sprite, including its transformation into Big Chuchu and phase management. - Documented the Octoboss sprite, highlighting its unique mechanics and interactions with a "brother" Octoboss. - Provided an overview of the Twinrova boss sprite, detailing its transformation and phase-based attacks. - Included analysis for the Vampire Bat mini-boss, emphasizing its enhanced behavior compared to standard Keese. - Documented the Wolfos mini-boss, focusing on its integration into a mask quest and unique pacification mechanics.
69 lines
5.2 KiB
Markdown
69 lines
5.2 KiB
Markdown
# Kydreeok Head Sprite Analysis
|
|
|
|
## Overview
|
|
The `kydreeok_head` sprite (ID: `Sprite_KydreeokHead`, which is `$CF`) is a child sprite of the main `Kydreeok` boss. It represents one of the multi-headed boss's individual heads, possessing independent movement, attack patterns, and damage handling. Its primary role is to move, rotate, and attack Link, contributing to the overall boss encounter.
|
|
|
|
## Key Properties:
|
|
* **Sprite ID:** `Sprite_KydreeokHead` (`$CF`)
|
|
* **Description:** Child sprite of the Kydreeok boss, responsible for individual head behavior.
|
|
* **Number of Tiles:** 7
|
|
* **Health:** `$C8` (200 decimal) - This high health value indicates it's a significant component of the boss fight.
|
|
* **Damage:** `00` (Damage is likely applied through its spawned attacks.)
|
|
* **Special Properties:**
|
|
* `!Boss = 00` (Not marked as a boss itself, as it's a component of a larger boss.)
|
|
* `!Hitbox = 09`
|
|
|
|
## Subtypes:
|
|
The `SprSubtype, X` register is crucial for differentiating the heads and their behavior:
|
|
* **Subtype `$00`:** Controls the "Left Head" via `Neck1_Control`.
|
|
* **Subtype `$01`:** Controls the "Right Head" via `Neck2_Control`.
|
|
This allows the same sprite ID to manage multiple distinct heads.
|
|
|
|
## Main States/Actions (`Sprite_KydreeokHead_Main` Jump Table):
|
|
The head's behavior is governed by a state machine:
|
|
* **`KydreeokHead_ForwardAnim` (0x00):** Default state, plays forward animation, handles damage, performs rotational movement, and randomly attacks. Transitions to other directional states based on Link's position.
|
|
* **`KydreeokHead_RightAnim` (0x01):** Plays right-facing animation, handles damage, rotation, and attacks.
|
|
* **`KydreeokHead_LeftAnim` (0x02):** Plays left-facing animation, handles damage, rotation, and attacks.
|
|
* **`KydreeokHead_FarRight` (0x03):** Plays far-right animation, moves towards Link, handles damage, rotation, and attacks.
|
|
* **`KydreeokHead_FarLeft` (0x04):** Plays far-left animation, moves towards Link, handles damage, rotation, and attacks.
|
|
* **`KydreeokHead_SummonFire` (0x05):** Moves towards Link, checks damage, and utilizes `JSL Sprite_Twinrova_FireAttack` to deal damage. The head sprite is then killed after a timer.
|
|
|
|
## Initialization (`Sprite_KydreeokHead_Prep`):
|
|
* Sets initial health to `$FF` (255 decimal), though the `!Health` property is `$C8`. This discrepancy might be overridden by the parent `Kydreeok` sprite or is a temporary value.
|
|
* Sets `SprBump = $09` (bump damage type).
|
|
* Initializes `SprMiscE, X` to `0`.
|
|
|
|
## Drawing (`Sprite_KydreeokHead_Draw`):
|
|
* Uses standard OAM allocation routines.
|
|
* The main drawing routine calls `JMP Sprite_KydreeokHead_DrawNeck`, indicating that the neck segments are drawn after the head.
|
|
* Includes logic for flashing when damaged.
|
|
|
|
## Neck Control (`KydreeokHead_NeckControl`, `Neck1_Control`, `Neck2_Control`, `Sprite_KydreeokHead_DrawNeck`, `DrawNeckPart`):
|
|
This is a sophisticated system for managing the multi-segmented neck:
|
|
* `KydreeokHead_NeckControl` dispatches to `Neck1_Control` (for the left head) or `Neck2_Control` (for the right head) based on `SprSubtype, X`.
|
|
* `Neck1_Control` and `Neck2_Control` manage the movement and positioning of three neck segments, ensuring they follow the head while maintaining specific distances.
|
|
* `Sprite_KydreeokHead_DrawNeck` and `DrawNeckPart` handle the rendering of these segments.
|
|
|
|
## Movement and Rotation (`KydreeokHead_RotationMove`, `RotateHeadUsingSpeedValues`, `MoveWithBody`):
|
|
* **`KydreeokHead_RotationMove`:** Generates random speeds, dispatches to neck control, moves with the main body, and applies rotational movement.
|
|
* **`RotateHeadUsingSpeedValues`:** Uses sine/cosine tables (`XSpeedSin`, `YSpeedSin`) to apply smooth rotational movement.
|
|
* **`MoveWithBody`:** Ensures the head's position is correctly offset and relative to the main `Kydreeok` boss, adjusting for left or right heads.
|
|
|
|
## Attacks (`RandomlyAttack`, `KydreeokHead_SummonFire`):
|
|
* **`RandomlyAttack`:** Randomly spawns a fire-based projectile (which is actually the `Sprite_KydreeokHead` itself entering the `SummonFire` state).
|
|
* **`KydreeokHead_SummonFire`:** This state is entered when a fire projectile is spawned. It moves towards Link and uses `JSL Sprite_Twinrova_FireAttack` to deal damage, after which the head sprite is killed.
|
|
|
|
## Key Macros/Functions Used:
|
|
* `%Set_Sprite_Properties`, `%GotoAction`, `%StartOnFrame`, `%PlayAnimation`, `%MoveTowardPlayer`
|
|
* `JSL JumpTableLocal`, `JSL Sprite_CheckDamageFromPlayer`, `JSL Sprite_CheckDamageToPlayer`, `JSL Sprite_DamageFlash_Long`
|
|
* `JSL GetRandomInt`, `JSL Sprite_MoveLong`, `JSL Sprite_IsToRightOfPlayer`
|
|
* `JSL Sprite_SpawnDynamically`, `JSL Sprite_SetSpawnedCoords`
|
|
* `JSL Sprite_Twinrova_FireAttack`, `JSL Fireball_SpawnTrailGarnish`
|
|
* `JSR GetDistance8bit`
|
|
|
|
## Discrepancies/Notes:
|
|
* The `!Health` property is `$C8`, but `Sprite_KydreeokHead_Prep` sets `SprHealth, X` to `$FF`. This needs clarification.
|
|
* The reuse of `JSL Sprite_Twinrova_FireAttack` for Kydreeok's head is an example of code reuse, but it's important to ensure it fits the thematic design of Kydreeok.
|
|
* The neck control system is quite intricate, highlighting advanced sprite design.
|
|
* Several hardcoded addresses for `JSL` calls could be replaced with named labels for better maintainability.
|