SM64 Moves Tracker — PopTracker pack (Archipelago)

A PopTracker pack that tracks Mario's eleven moves in Super Mario 64 Archipelago randomizers. Moves light up automatically as you receive them from the Archipelago server — no game-memory reading required. Also works as a manual click-tracker when offline.

Top row: discovered. Bottom row: not yet received (crossed out in red).

Moves tracked: Double Jump · Triple Jump · Long Jump · Backflip · Side Flip · Wall Kick · Dive · Ground Pound · Kick · Climb · Ledge Grab

Features

• Archipelago auto-tracking — connect to your AP server and moves update live.
• Manual mode — left-click any move to toggle it on/off when not connected.
• Broadcast view — a clean green-screen layout made for OBS chroma-keying.
• Single-row layout that tucks neatly along the top or bottom of a stream.

Requirements

• PopTracker (free; Windows / macOS / Linux).
• A Super Mario 64 Archipelago slot with move randomization enabled — that's what sends the moves to you as items. When generating your YAML on the SM64 player options page, set Enable Move Randomizer to Yes. (Without it you start with every move, so there's nothing to track.)
  • The Randomized Moves option controls which moves get shuffled into the item pool; the tracker shows all 11 and lights up whichever ones you receive.

Installation

1. Find PopTracker's packs folder — either packs/ next to the PopTracker executable, or Documents/PopTracker/packs/ (~/PopTracker/packs/ on macOS/Linux).
2. Put the pack there — either drop in the whole SM64MovesTracker folder, or the SM64MovesTracker.zip (PopTracker loads zips directly; no need to unzip).
3. Launch PopTracker → Load Pack → SM64 Moves Tracker (Archipelago) → variant Moves (Archipelago).

Connecting to Archipelago

1. Click PopTracker's AP / Connect button (top toolbar).
2. Enter your server address (host:port), slot name, and password (leave blank if none).
3. On connect the tracker resets, lights up every move you've already received, and updates live as new ones arrive.

Discovered moves show the clean icon; moves you don't have yet show the icon crossed out with a red "no" symbol. You can always left-click to toggle manually.

Using it on stream (OBS)

The pack includes a dedicated broadcast layout with a green background for chroma keying, so only the icons appear over your gameplay:

1. In PopTracker, open the Broadcast View (separate, minimal window).
2. In OBS: Sources → + → Window Capture → select the PopTracker broadcast window (Capture Method Windows 10 (1903+) gives a clean borderless grab).
3. Right-click the source → Filters → + → Chroma Key → Key Color: Green. Adjust Similarity / Smoothness if you see any green fringe.

Green is safe because the icons only use black, white, and red — nothing green to accidentally key out. Prefer a different key color? Change the tracker_broadcast background in layouts/layout.json (e.g. #ff00ff for magenta) and match it in OBS.

Customizing

• Reorder / regrid: edit the rows arrays in layouts/layout.json (tracker_default is the app view, tracker_broadcast is the stream view). Item codes are bare strings; split them across multiple inner arrays to make more rows.
• Swap an icon: replace images/items/<move>.png (on) and <move>_off.png (off / crossed out).
• Add a move: add an entry in items/moves.json with a unique codes value, reference that code in the layout, and add it to the alias map in scripts/autotracking.lua.

Note: items set "disabled_img_mods": "none" so PopTracker shows the custom crossed-out off-image in full color instead of auto-greying it.

Troubleshooting — a move won't light up

Almost always an item-name mismatch between your AP world and the tracker. The handler matches case/space-insensitively and includes common aliases, but to fix a straggler:

1. Open PopTracker's Lua console / log. Unmapped items are printed on connect like: SM64 Moves Tracker: unmapped item 'Some Name' (id 123).
2. Add that exact name to the matching alias(...) line in scripts/autotracking.lua, e.g. alias("wall_kick", "Wall Kick", "Wall Jump", "Some Name").
3. Reload the pack.

Pack contents

manifest.json              pack metadata; declares the "ap" (Archipelago) flag
items/moves.json           the 11 toggle items (on/off images, full-color off)
layouts/layout.json        tracker_default + tracker_broadcast (green) layouts
images/items/*.png         <move>.png (on) + <move>_off.png (crossed out)
scripts/init.lua           entry point: loads items, layouts, and auto-tracking
scripts/autotracking.lua   AP item handler mapping received moves -> icons
preview.png                the image shown above

Credits & disclaimer

Pack by soapergem. Built for use with Archipelago.

The move icons are original black-silhouette renderings derived from official Super Mario 64 artwork. Super Mario 64, Mario, and related characters and artwork are trademarks of Nintendo. This is an unofficial, non-commercial fan project and is not affiliated with or endorsed by Nintendo or Archipelago.

You're free to use, modify, and re-share this pack for non-commercial fan purposes. Please keep this notice with it.