# Kirby & The Amazing Mirror

Where is the options page?

• As this is a custom AP world you will need to first install Kirby & The Amazing Mirror's apworld, then run the Archipelago launcher and open Options Creator. Select Kirby & The Amazing Mirror and your options and then choose your save destination.
• If you prefer to setup your options via a standard yaml file, you will need to first install Kirby & The Amazing Mirror's apworld, run the Archipelago launcher, and select the Generate Template Options. A file explorer will open which you can then locate the Kirby & The Amazing Mirror yaml file to edit.

What does randomization do to this game?

• Progression & useful items which the player would normally acquire throughout the game have been moved around. (Mirror Shards, Maps, Vitality, Sound Player)
• Normal copy ability enemies can be randomized to give a different copy ability. When using shuffled mode, a spoiler log includes the enemy to ability assignments.
• Enemies which typically do not give abilities can be randomized to give abilities.
• Minny can be kept vanilla with the ability_randomization_minny toggle while still randomizing other enemy ability sources.
• Enemies that cannot be swallowed are excluded from the enemy copy-ability randomization pool.
• The chance for an enemy to not have a copy ability can be controlled via the ability_randomization_no_ability_weight
• Ability statues (sometimes called ability trophies or ability stands) have a dedicated boolean toggle (ability_randomization_statues). With the toggle off, statues retain their vanilla abilities. In shuffled mode, each statue keeps one seed-deterministic assignment, which appears in the spoiler log. In completely_random mode, a regular statue makes a fresh draw every time its grant is triggered; independent draws may still repeat by chance. Statue draws use the configured ability whitelist, respect ability_randomization_minny, and remove gated abilities until their AP unlock items are received. Statues always draw an ability when at least one eligible ability remains and intentionally ignore ability_randomization_no_ability_weight, ability_randomization_passive_enemies, ability_randomization_minibosses, and ability_randomization_boss_spawns. The Master Sword stand is not treated as a regular randomized statue.
• AP ability unlock items are generated dynamically from data/abilities.json only when the Ability Gating option is enabled. That option defaults on and appears under Make the game harder. When enabled, unlock items are generated only for abilities marked safe_to_gate (and not explicitly disabled by enemy_copy_allowed: false); gated abilities are blocked until their matching AP unlock item has been received.

What items and locations get randomized?

Locations in which items can be found:

• All Big Chests
• All Mirror Shards
• All Rooms (Optional, not enabled by default)
• All Levers
• All Big Switches Items that can be shuffled:
• All Mirror Shards
• All Maps
• All Vitality
• Sound Player
• All consumable items (Small Food, Energy Drink, Hunk of Meat, Cell Phone Battery, Max Tomato, Invincibility Candy)

Common Item/Location Options

KirbyAM supports the standard Archipelago common options for item and location control:

• local_items: force selected item names/groups to stay in your world.
• non_local_items: force selected item names/groups out of your world.
• start_inventory: begin with selected items precollected.
• start_hints: begin with hints for selected item names/groups.
• start_location_hints: begin with hints for selected location names.
• exclude_locations: remove selected locations from placement.
• priority_locations: bias selected locations toward important item placement.
• item_links: configure linked/shared item pools across players.
• plando_items: explicitly plan item placement.

Use exact item/location names from this world (or the item groups listed above) when configuring these fields.

What other changes are made to the game?

• There is an optional setting to enable one-life mode (no_extra_lives). If you die you are instantly sent back to the Hub, and any 1Ups you receive will be immediately removed.
• There is an optional setting to enable one-hit mode. Kirby's HP cap is clamped to 1 plus collected Vitality Counters. In exclude_vitality_counters mode, Vitality Counter items are removed from the item pool and health-restoring filler (Small Food, Energy Drink, Hunk of Meat, and Max Tomato) is also removed from filler selection so randomized filler cannot counteract the 1 HP challenge.
• Filler items use weighted generation rather than equal odds. Current whole-number weights are: Cell Phone Battery 25, Energy Drink 17, 1 Up 15, Max Tomato 15, Small Food 14, Hunk of Meat 9, Invincibility Candy 5.
• Goal modes:
  • dark_mind: Defeat Dark Mind to complete the seed.
  • defeat_any_area_boss: Defeat any one * - Boss Defeat location (Mustard Mountain, Moonlight Mansion, Candy Constellation, Olive Ocean, Peppermint Palace, Cabbage Cavern, Carrot Castle, or Radish Ruins). In this mode, collecting all Mirror Shards is not required by the goal mode itself.
    • Candy Constellation's Master Hand + Crazy Hand fight is treated as one pooled boss target (BOSS_DEFEAT_3).
  • defeat_configured_area_boss: Defeat a specific area boss selected by the configured_area_boss option. The default target is the Master Hand + Crazy Hand pair (BOSS_DEFEAT_3), and the selected target is only used by this goal mode.
  • defeat_random_hidden_area_boss: Defeat one seed-selected hidden area boss. The selected target is carried in slot data as an internal boss-defeat key; normal player-facing output does not reveal the boss name, but spoiler output may.

What does another world's item look like in Kirby & The Amazing Mirror?

When you find an item that is not your own, you will be able to see what it was and who it was sent to in both Bizhawk and the Archipelago Bizhawk client. The sprite for the item will still appear, but you will need to receive it via Archipelago before it's usable. When collecting a mirror shard check, the cutscene will still play as if you've received the mirror shard, however it will not be given until you receive it properly via Archipelago.

If an item sends to your own slot, BizHawk shows one local confirmation line (You found your <item>.) instead of separate send and receive popups.

When the player receives an item, what happens?

You will not see an indicator in the game, instead you'll see you received an item from the client window.

Trackers

Currently a tracker is not available. Goal logic depends on the selected mode: either defeat Dark Mind, defeat any one area boss in defeat_any_area_boss mode, defeat the configured area boss in defeat_configured_area_boss mode, or defeat the seed-selected hidden area boss in defeat_random_hidden_area_boss mode.

# Can I play offline?

Yes, the client and connector are only necessary for sending and receiving items. If you're playing a solo game, you don't need to play online unless you want the rest of Archipelago's functionality (like hints). If you're playing a multiworld game, the client will sync your game with the server the next time you connect.

Acknowledgements

[jiangzhengwenjz](https://github.com/jiangzhengwenjz) and other contributors — creators of the [Kirby & The Amazing Mirror disassembly](https://github.com/jiangzhengwenjz/katam), which was instrumental in understanding ROM internals for this integration.