.beans/nuzlocke-tracker-yfi8--fetch-boss-battle-sprites-from-bulbapedia.md

@@ -0,0 +1,26 @@
+---
+# nuzlocke-tracker-yfi8
+title: Fetch boss battle sprites from Bulbapedia
+status: in-progress
+type: task
+priority: normal
+created_at: 2026-02-14T09:14:32Z
+updated_at: 2026-02-14T09:24:28Z
+---
+
+## Overview
+
+Write and run a one-time script to download boss battle trainer sprites from Bulbapedia's archives. For totem pokemon, link to existing pokemon sprites instead.
+
+## Current State
+- 10 game directories have sprites (122 files total): red, yellow, gold, crystal, ruby, emerald, firered, diamond, heartgold, omega-ruby
+- 11 game directories are completely missing: black, black-2, platinum, x, sun, ultra-sun, lets-go-pikachu, sword, brilliant-diamond, legends-arceus, scarlet
+- 11 boss entries have null sprite_url (firered Elite Four + heartgold Elite Four/Red)
+
+## Checklist
+- [x] Write download script with Bulbapedia image URL patterns
+- [x] Download sprites for all missing games
+- [x] Fill in null sprite_url entries for firered/heartgold
+- [x] Handle totem pokemon by linking to existing pokemon sprites
+- [x] Handle special cases (multi-boss entries, Legends Arceus nobles)
+- [x] Update seed JSON files with correct local paths

backend/src/app/seeds/data/crystal-bosses.json

@@ -10,7 +10,7 @@
     "after_route_name": "Violet City",
     "location": "Violet Gym",
     "section": "Main Story",
-    "sprite_url": "/boss-sprites/gold/falkner.png",
+    "sprite_url": "/boss-sprites/crystal/falkner.png",
     "pokemon": []
   },
   {
@@ -24,7 +24,7 @@
     "after_route_name": "Slowpoke Well",
     "location": "Azalea Gym",
     "section": "Main Story",
-    "sprite_url": "/boss-sprites/gold/bugsy.png",
+    "sprite_url": "/boss-sprites/crystal/bugsy.png",
     "pokemon": []
   },
   {
@@ -38,7 +38,7 @@
     "after_route_name": "Goldenrod City",
     "location": "Goldenrod Gym",
     "section": "Main Story",
-    "sprite_url": "/boss-sprites/gold/whitney.png",
+    "sprite_url": "/boss-sprites/crystal/whitney.png",
     "pokemon": []
   },
   {
@@ -52,7 +52,7 @@
     "after_route_name": "Ecruteak City",
     "location": "Ecruteak Gym",
     "section": "Main Story",
-    "sprite_url": "/boss-sprites/gold/morty.png",
+    "sprite_url": "/boss-sprites/crystal/morty.png",
     "pokemon": []
   },
   {
@@ -66,7 +66,7 @@
     "after_route_name": "Cianwood City",
     "location": "Cianwood Gym",
     "section": "Main Story",
-    "sprite_url": "/boss-sprites/gold/chuck.png",
+    "sprite_url": "/boss-sprites/crystal/chuck.png",
     "pokemon": []
   },
   {
@@ -80,7 +80,7 @@
     "after_route_name": "Cianwood City",
     "location": "Olivine Gym",
     "section": "Main Story",
-    "sprite_url": "/boss-sprites/gold/jasmine.png",
+    "sprite_url": "/boss-sprites/crystal/jasmine.png",
     "pokemon": []
   },
   {
@@ -94,7 +94,7 @@
     "after_route_name": "Lake of Rage",
     "location": "Mahogany Gym",
     "section": "Main Story",
-    "sprite_url": "/boss-sprites/gold/pryce.png",
+    "sprite_url": "/boss-sprites/crystal/pryce.png",
     "pokemon": []
   },
   {
@@ -108,7 +108,7 @@
     "after_route_name": "Blackthorn City",
     "location": "Blackthorn Gym",
     "section": "Main Story",
-    "sprite_url": "/boss-sprites/gold/clair.png",
+    "sprite_url": "/boss-sprites/crystal/clair.png",
     "pokemon": []
   },
   {
@@ -122,7 +122,7 @@
     "after_route_name": "Victory Road (Kanto)",
     "location": "Indigo Plateau",
     "section": "Main Story",
-    "sprite_url": "/boss-sprites/gold/will.png",
+    "sprite_url": "/boss-sprites/crystal/will.png",
     "pokemon": []
   },
   {
@@ -136,7 +136,7 @@
     "after_route_name": "Victory Road (Kanto)",
     "location": "Indigo Plateau",
     "section": "Main Story",
-    "sprite_url": "/boss-sprites/gold/koga.png",
+    "sprite_url": "/boss-sprites/crystal/koga.png",
     "pokemon": []
   },
   {
@@ -150,7 +150,7 @@
     "after_route_name": "Victory Road (Kanto)",
     "location": "Indigo Plateau",
     "section": "Main Story",
-    "sprite_url": "/boss-sprites/gold/bruno.png",
+    "sprite_url": "/boss-sprites/crystal/bruno.png",
     "pokemon": []
   },
   {
@@ -164,7 +164,7 @@
     "after_route_name": "Victory Road (Kanto)",
     "location": "Indigo Plateau",
     "section": "Main Story",
-    "sprite_url": "/boss-sprites/gold/karen.png",
+    "sprite_url": "/boss-sprites/crystal/karen.png",
     "pokemon": []
   },
   {
@@ -178,7 +178,7 @@
     "after_route_name": "Victory Road (Kanto)",
     "location": "Indigo Plateau",
     "section": "Main Story",
-    "sprite_url": "/boss-sprites/gold/lance.png",
+    "sprite_url": "/boss-sprites/crystal/lance.png",
     "pokemon": []
   },
   {
@@ -192,7 +192,7 @@
     "after_route_name": "Vermilion City",
     "location": "Vermilion Gym",
     "section": "Endgame",
-    "sprite_url": "/boss-sprites/gold/lt-surge.png",
+    "sprite_url": "/boss-sprites/crystal/lt-surge.png",
     "pokemon": []
   },
   {
@@ -206,7 +206,7 @@
     "after_route_name": "Route 05 (Kanto)",
     "location": "Saffron Gym",
     "section": "Endgame",
-    "sprite_url": "/boss-sprites/gold/sabrina.png",
+    "sprite_url": "/boss-sprites/crystal/sabrina.png",
     "pokemon": []
   },
   {
@@ -220,7 +220,7 @@
     "after_route_name": "Cerulean Cave (B1F)",
     "location": "Cerulean Gym",
     "section": "Endgame",
-    "sprite_url": "/boss-sprites/gold/misty.png",
+    "sprite_url": "/boss-sprites/crystal/misty.png",
     "pokemon": []
   },
   {
@@ -234,7 +234,7 @@
     "after_route_name": "Celadon City",
     "location": "Celadon Gym",
     "section": "Endgame",
-    "sprite_url": "/boss-sprites/gold/erika.png",
+    "sprite_url": "/boss-sprites/crystal/erika.png",
     "pokemon": []
   },
   {
@@ -248,7 +248,7 @@
     "after_route_name": "Fuchsia City",
     "location": "Fuchsia Gym",
     "section": "Endgame",
-    "sprite_url": "/boss-sprites/gold/janine.png",
+    "sprite_url": "/boss-sprites/crystal/janine.png",
     "pokemon": []
   },
   {
@@ -262,7 +262,7 @@
     "after_route_name": "Pewter City",
     "location": "Pewter Gym",
     "section": "Endgame",
-    "sprite_url": "/boss-sprites/gold/brock.png",
+    "sprite_url": "/boss-sprites/crystal/brock.png",
     "pokemon": []
   },
   {
@@ -276,7 +276,7 @@
     "after_route_name": "Cinnabar Island",
     "location": "Cinnabar Gym",
     "section": "Endgame",
-    "sprite_url": "/boss-sprites/gold/blaine.png",
+    "sprite_url": "/boss-sprites/crystal/blaine.png",
     "pokemon": []
   },
   {
@@ -290,7 +290,7 @@
     "after_route_name": "Viridian City",
     "location": "Viridian Gym",
     "section": "Endgame",
-    "sprite_url": "/boss-sprites/gold/blue.png",
+    "sprite_url": "/boss-sprites/crystal/blue.png",
     "pokemon": []
   },
   {
@@ -304,7 +304,7 @@
     "after_route_name": "Mt. Silver (Cave Full Restore Chamber)",
     "location": "Silver Cave",
     "section": "Endgame",
-    "sprite_url": "/boss-sprites/gold/red.png",
+    "sprite_url": "/boss-sprites/crystal/red.png",
     "pokemon": []
   }
 ]

backend/src/app/seeds/data/emerald-bosses.json

@@ -10,7 +10,7 @@
     "after_route_name": "Rustboro City",
     "location": "Rustboro Gym",
     "section": "Main Story",
-    "sprite_url": "/boss-sprites/ruby/roxanne.png",
+    "sprite_url": "/boss-sprites/emerald/roxanne.png",
     "pokemon": []
   },
   {
@@ -24,7 +24,7 @@
     "after_route_name": "Dewford Town",
     "location": "Dewford Gym",
     "section": "Main Story",
-    "sprite_url": "/boss-sprites/ruby/brawly.png",
+    "sprite_url": "/boss-sprites/emerald/brawly.png",
     "pokemon": []
   },
   {
@@ -38,7 +38,7 @@
     "after_route_name": "Hoenn Route 110",
     "location": "Mauville Gym",
     "section": "Main Story",
-    "sprite_url": "/boss-sprites/ruby/wattson.png",
+    "sprite_url": "/boss-sprites/emerald/wattson.png",
     "pokemon": []
   },
   {
@@ -52,7 +52,7 @@
     "after_route_name": "Lavaridge Town",
     "location": "Lavaridge Gym",
     "section": "Main Story",
-    "sprite_url": "/boss-sprites/ruby/flannery.png",
+    "sprite_url": "/boss-sprites/emerald/flannery.png",
     "pokemon": []
   },
   {
@@ -66,7 +66,7 @@
     "after_route_name": "Desert Ruins",
     "location": "Petalburg Gym",
     "section": "Main Story",
-    "sprite_url": "/boss-sprites/ruby/norman.png",
+    "sprite_url": "/boss-sprites/emerald/norman.png",
     "pokemon": []
   },
   {
@@ -80,7 +80,7 @@
     "after_route_name": "Fortree City",
     "location": "Foretree Gym",
     "section": "Main Story",
-    "sprite_url": "/boss-sprites/ruby/winona.png",
+    "sprite_url": "/boss-sprites/emerald/winona.png",
     "pokemon": []
   },
   {
@@ -94,7 +94,7 @@
     "after_route_name": "Mossdeep City",
     "location": "Mossdeep Gym",
     "section": "Main Story",
-    "sprite_url": "/boss-sprites/ruby/tate--lisa.png",
+    "sprite_url": "/boss-sprites/emerald/tate--lisa.png",
     "pokemon": []
   },
   {
@@ -108,7 +108,7 @@
     "after_route_name": "Sootopolis City",
     "location": "Sootopolis Gym",
     "section": "Main Story",
-    "sprite_url": "/boss-sprites/ruby/juan.png",
+    "sprite_url": "/boss-sprites/emerald/juan.png",
     "pokemon": []
   },
   {
@@ -122,7 +122,7 @@
     "after_route_name": "Victory Road (Hoenn)",
     "location": "Ever Grande City",
     "section": "Main Story",
-    "sprite_url": "/boss-sprites/ruby/sydney.png",
+    "sprite_url": "/boss-sprites/emerald/sydney.png",
     "pokemon": []
   },
   {
@@ -136,7 +136,7 @@
     "after_route_name": "Victory Road (Hoenn)",
     "location": "Ever Grande City",
     "section": "Main Story",
-    "sprite_url": "/boss-sprites/ruby/phoebe.png",
+    "sprite_url": "/boss-sprites/emerald/phoebe.png",
     "pokemon": []
   },
   {
@@ -150,7 +150,7 @@
     "after_route_name": "Victory Road (Hoenn)",
     "location": "Ever Grande City",
     "section": "Main Story",
-    "sprite_url": "/boss-sprites/ruby/glacia.png",
+    "sprite_url": "/boss-sprites/emerald/glacia.png",
     "pokemon": []
   },
   {
@@ -164,7 +164,7 @@
     "after_route_name": "Victory Road (Hoenn)",
     "location": "Ever Grande City",
     "section": "Main Story",
-    "sprite_url": "/boss-sprites/ruby/drake.png",
+    "sprite_url": "/boss-sprites/emerald/drake.png",
     "pokemon": []
   },
   {

backend/src/app/seeds/data/firered-bosses.json

@@ -145,9 +145,9 @@
   {
     "name": "Giovanni",
     "boss_type": "gym_leader",
-    "specialty_type": null,
-    "badge_name": "50",
-    "badge_image_url": "/badges/50.png",
+    "specialty_type": "ground",
+    "badge_name": "Earth Badge",
+    "badge_image_url": "/badges/earth-badge.png",
     "level_cap": 50,
     "order": 8,
     "after_route_name": null,
@@ -167,7 +167,7 @@
     "after_route_name": null,
     "location": "Indigo Plateau",
     "section": null,
-    "sprite_url": null,
+    "sprite_url": "/boss-sprites/firered/lorelei.png",
     "pokemon": []
   },
   {
@@ -181,7 +181,7 @@
     "after_route_name": null,
     "location": "Indigo Plateau",
     "section": null,
-    "sprite_url": null,
+    "sprite_url": "/boss-sprites/firered/bruno.png",
     "pokemon": []
   },
   {
@@ -195,7 +195,7 @@
     "after_route_name": null,
     "location": "Indigo Plateau",
     "section": null,
-    "sprite_url": null,
+    "sprite_url": "/boss-sprites/firered/agatha.png",
     "pokemon": []
   },
   {
@@ -209,7 +209,7 @@
     "after_route_name": null,
     "location": "Indigo Plateau",
     "section": null,
-    "sprite_url": null,
+    "sprite_url": "/boss-sprites/firered/lance.png",
     "pokemon": []
   },
   {
@@ -223,7 +223,7 @@
     "after_route_name": null,
     "location": "Indigo Plateau",
     "section": null,
-    "sprite_url": null,
+    "sprite_url": "/boss-sprites/firered/blue.png",
     "pokemon": [
       {
         "pokeapi_id": 18,

backend/src/app/seeds/data/heartgold-bosses.json

@@ -122,7 +122,7 @@
     "after_route_name": null,
     "location": "Indigo Plateau",
     "section": "Main Story",
-    "sprite_url": null,
+    "sprite_url": "/boss-sprites/heartgold/will.png",
     "pokemon": []
   },
   {
@@ -136,7 +136,7 @@
     "after_route_name": null,
     "location": "Indigo Plateau",
     "section": "Main Story",
-    "sprite_url": null,
+    "sprite_url": "/boss-sprites/heartgold/koga.png",
     "pokemon": []
   },
   {
@@ -150,7 +150,7 @@
     "after_route_name": null,
     "location": "Indigo Plateau",
     "section": "Main Story",
-    "sprite_url": null,
+    "sprite_url": "/boss-sprites/heartgold/bruno.png",
     "pokemon": []
   },
   {
@@ -164,7 +164,7 @@
     "after_route_name": null,
     "location": "Indigo Plateau",
     "section": "Main Story",
-    "sprite_url": null,
+    "sprite_url": "/boss-sprites/heartgold/karen.png",
     "pokemon": []
   },
   {
@@ -178,7 +178,7 @@
     "after_route_name": null,
     "location": "Indigo Plateau",
     "section": "Main Story",
-    "sprite_url": null,
+    "sprite_url": "/boss-sprites/heartgold/lance.png",
     "pokemon": []
   },
   {
@@ -304,7 +304,7 @@
     "after_route_name": null,
     "location": "Silver Cave",
     "section": "Endgame",
-    "sprite_url": null,
+    "sprite_url": "/boss-sprites/heartgold/red.png",
     "pokemon": []
   }
 ]

backend/src/app/seeds/data/legends-arceus-bosses.json

@@ -10,7 +10,7 @@
     "after_route_name": null,
     "location": "Grandtree Arena",
     "section": "Main Story",
-    "sprite_url": "/boss-sprites/legends-arceus/lord-kleavor.png",
+    "sprite_url": "/sprites/900.webp",
     "pokemon": []
   },
   {
@@ -24,7 +24,7 @@
     "after_route_name": null,
     "location": "Brava Arena",
     "section": "Main Story",
-    "sprite_url": "/boss-sprites/legends-arceus/lady-lilligant.png",
+    "sprite_url": "/sprites/10237.webp",
     "pokemon": []
   },
   {
@@ -38,7 +38,7 @@
     "after_route_name": null,
     "location": "Molten Arena",
     "section": "Main Story",
-    "sprite_url": "/boss-sprites/legends-arceus/lord-arcanine.png",
+    "sprite_url": "/sprites/10230.webp",
     "pokemon": []
   },
   {
@@ -52,7 +52,7 @@
     "after_route_name": null,
     "location": "Moonview Arena",
     "section": "Main Story",
-    "sprite_url": "/boss-sprites/legends-arceus/lord-electrode.png",
+    "sprite_url": "/sprites/10232.webp",
     "pokemon": []
   },
   {
@@ -66,7 +66,7 @@
     "after_route_name": null,
     "location": "Icepeak Arena",
     "section": "Main Story",
-    "sprite_url": "/boss-sprites/legends-arceus/lord-avalugg.png",
+    "sprite_url": "/sprites/10243.webp",
     "pokemon": []
   },
   {
@@ -80,7 +80,7 @@
     "after_route_name": null,
     "location": "Temple of Sinnoh",
     "section": "Main Story",
-    "sprite_url": "/boss-sprites/legends-arceus/origin-dialga--palkia.png",
+    "sprite_url": "/sprites/10245.webp",
     "pokemon": []
   },
   {
@@ -94,7 +94,7 @@
     "after_route_name": null,
     "location": "Temple of Sinnoh",
     "section": "Main Story",
-    "sprite_url": "/boss-sprites/legends-arceus/arceus.png",
+    "sprite_url": "/sprites/493.webp",
     "pokemon": []
   }
 ]

backend/src/app/seeds/data/scarlet-bosses.json

@@ -276,7 +276,7 @@
     "after_route_name": null,
     "location": "South Province (Area Three)",
     "section": "Path of Legends",
-    "sprite_url": "/boss-sprites/scarlet/stony-cliff-titan.png",
+    "sprite_url": "/sprites/950.webp",
     "pokemon": []
   },
   {
@@ -290,7 +290,7 @@
     "after_route_name": null,
     "location": "West Province (Area One)",
     "section": "Path of Legends",
-    "sprite_url": "/boss-sprites/scarlet/open-sky-titan.png",
+    "sprite_url": "/sprites/962.webp",
     "pokemon": []
   },
   {
@@ -304,7 +304,7 @@
     "after_route_name": null,
     "location": "East Province (Area Three)",
     "section": "Path of Legends",
-    "sprite_url": "/boss-sprites/scarlet/lurking-steel-titan.png",
+    "sprite_url": "/sprites/968.webp",
     "pokemon": []
   },
   {
@@ -318,7 +318,7 @@
     "after_route_name": null,
     "location": "Asado Desert",
     "section": "Path of Legends",
-    "sprite_url": "/boss-sprites/scarlet/quaking-earth-titan.png",
+    "sprite_url": "/sprites/984.webp",
     "pokemon": []
   },
   {
@@ -332,7 +332,7 @@
     "after_route_name": null,
     "location": "Casseroya Lake",
     "section": "Path of Legends",
-    "sprite_url": "/boss-sprites/scarlet/false-dragon-titan.png",
+    "sprite_url": "/sprites/977.webp",
     "pokemon": []
   }
 ]

backend/src/app/seeds/data/sun-bosses.json

@@ -10,7 +10,7 @@
     "after_route_name": null,
     "location": "Verdant Cavern",
     "section": "Melemele Island",
-    "sprite_url": "/boss-sprites/sun/totem-gumshoos.png",
+    "sprite_url": "/sprites/735.webp",
     "pokemon": []
   },
   {
@@ -38,7 +38,7 @@
     "after_route_name": null,
     "location": "Brooklet Hill",
     "section": "Akala Island",
-    "sprite_url": "/boss-sprites/sun/totem-wishiwashi.png",
+    "sprite_url": "/sprites/746.webp",
     "pokemon": []
   },
   {
@@ -52,7 +52,7 @@
     "after_route_name": null,
     "location": "Wela Volcano Park",
     "section": "Akala Island",
-    "sprite_url": "/boss-sprites/sun/totem-salazzle.png",
+    "sprite_url": "/sprites/758.webp",
     "pokemon": []
   },
   {
@@ -66,7 +66,7 @@
     "after_route_name": null,
     "location": "Lush Jungle",
     "section": "Akala Island",
-    "sprite_url": "/boss-sprites/sun/totem-lurantis.png",
+    "sprite_url": "/sprites/754.webp",
     "pokemon": []
   },
   {
@@ -94,7 +94,7 @@
     "after_route_name": null,
     "location": "Hokulani Observatory",
     "section": "Ula'ula Island",
-    "sprite_url": "/boss-sprites/sun/totem-vikavolt.png",
+    "sprite_url": "/sprites/738.webp",
     "pokemon": []
   },
   {
@@ -108,7 +108,7 @@
     "after_route_name": null,
     "location": "Thrifty Megamart",
     "section": "Ula'ula Island",
-    "sprite_url": "/boss-sprites/sun/totem-mimikyu.png",
+    "sprite_url": "/sprites/778.webp",
     "pokemon": []
   },
   {
@@ -136,7 +136,7 @@
     "after_route_name": null,
     "location": "Vast Poni Canyon",
     "section": "Poni Island",
-    "sprite_url": "/boss-sprites/sun/totem-kommo-o.png",
+    "sprite_url": "/sprites/784.webp",
     "pokemon": []
   },
   {

backend/src/app/seeds/data/ultra-sun-bosses.json

@@ -10,7 +10,7 @@
     "after_route_name": null,
     "location": "Verdant Cavern",
     "section": "Melemele Island",
-    "sprite_url": "/boss-sprites/ultra-sun/totem-gumshoos.png",
+    "sprite_url": "/sprites/735.webp",
     "pokemon": []
   },
   {
@@ -38,7 +38,7 @@
     "after_route_name": null,
     "location": "Brooklet Hill",
     "section": "Akala Island",
-    "sprite_url": "/boss-sprites/ultra-sun/totem-araquanid.png",
+    "sprite_url": "/sprites/752.webp",
     "pokemon": []
   },
   {
@@ -52,7 +52,7 @@
     "after_route_name": null,
     "location": "Wela Volcano Park",
     "section": "Akala Island",
-    "sprite_url": "/boss-sprites/ultra-sun/totem-salazzle.png",
+    "sprite_url": "/sprites/758.webp",
     "pokemon": []
   },
   {
@@ -66,7 +66,7 @@
     "after_route_name": null,
     "location": "Lush Jungle",
     "section": "Akala Island",
-    "sprite_url": "/boss-sprites/ultra-sun/totem-lurantis.png",
+    "sprite_url": "/sprites/754.webp",
     "pokemon": []
   },
   {
@@ -94,7 +94,7 @@
     "after_route_name": null,
     "location": "Hokulani Observatory",
     "section": "Ula'ula Island",
-    "sprite_url": "/boss-sprites/ultra-sun/totem-vikavolt.png",
+    "sprite_url": "/sprites/738.webp",
     "pokemon": []
   },
   {
@@ -108,7 +108,7 @@
     "after_route_name": null,
     "location": "Thrifty Megamart",
     "section": "Ula'ula Island",
-    "sprite_url": "/boss-sprites/ultra-sun/totem-mimikyu.png",
+    "sprite_url": "/sprites/778.webp",
     "pokemon": []
   },
   {
@@ -122,7 +122,7 @@
     "after_route_name": null,
     "location": "Hokulani Observatory",
     "section": "Ula'ula Island",
-    "sprite_url": "/boss-sprites/ultra-sun/totem-togedemaru.png",
+    "sprite_url": "/sprites/777.webp",
     "pokemon": []
   },
   {
@@ -150,7 +150,7 @@
     "after_route_name": null,
     "location": "Vast Poni Canyon",
     "section": "Poni Island",
-    "sprite_url": "/boss-sprites/ultra-sun/totem-kommo-o.png",
+    "sprite_url": "/sprites/784.webp",
     "pokemon": []
   },
   {
@@ -164,7 +164,7 @@
     "after_route_name": null,
     "location": "Seafolk Village",
     "section": "Poni Island",
-    "sprite_url": "/boss-sprites/ultra-sun/totem-ribombee.png",
+    "sprite_url": "/sprites/743.webp",
     "pokemon": []
   },
   {