# Professor Oak Challenge Trackers A dark-mode **Professor Oak Challenge (POC)** web tracker hub covering multiple Pokémon games under one site. Built to make multi-section Pokédex planning fast, readable, and easy to track directly in your browser without spreadsheets. > **Browser-First & Private:** All progress, save profiles, and ruleset toggles are stored locally in your browser (`localStorage`), with one-click JSON backup export and import. There is no account system, database, or tracking. --- ## Included Trackers ### 1. Pokémon Omega Ruby & Alpha Sapphire (`/oras/`) A full **Nintendo 3DS · Gen VI** Professor Oak Challenge tracker supporting both **Alpha Sapphire** and **Omega Ruby** in one app: - **Version Modes & Rulesets:** Switch between **Alpha Sapphire** (`410` Solo POC Pokémon) and **Omega Ruby** (`410` Solo POC Pokémon), or toggle **Show All** (`478` total Pokémon including trade evolutions and version exclusives). - **10 Level-Capped Checkpoints:** Enforces evolutions achievable at or below each upcoming Gym Leader / Champion level cap (`Roxanne Lv. 14` → `Steven Lv. 59` + `Post-Game / Delta Episode`). - **Optional Secret Super Training Toggle:** Off by default—keep stone evolutions in later checkpoints via overworld/NPC stones and Dive Shards, or turn it on if you grind 510-EV Secret Super Training early. - **Interactive Route Checklists:** Displays Pokémon sprites, elemental type pills, encounter rates, level ranges, evolution item icons, mutually exclusive branch locking (Starters, Fossils, Johto/Sinnoh/Unova gifts), and global **Caught** sync across every route and the Pokédex tab. - **Route-Level Trainer & Gym Battles:** Collapsible battle drawers directly beneath each route and Gym, tracking trainer defeats and dynamically adapting Rival teams to your chosen starter. - **Gen VI Pokédex, Stats & Movedex:** Sortable Pokédex table with `BST` / Base Stats, plus a detail inspector showing **Gen VI Base Stats**, **Abilities**, Regular & Shiny ORAS sprites, evolution family, all encounter locations, a searchable **ORAS Movedex** (`Level-Up`, `TM/HM`, `Tutor`, `Egg`, `All`), and external links (`Serebii`, `Bulbapedia`, `Pokémon Database`, `Smogon`). ### 2. Pokémon Luminescent Platinum v2.1 (`/luminescent-platinum/`) A dedicated tracker tailored to the **Nintendo Switch · BDSP Mod (Luminescent Platinum v2.1)** Pokédex and mechanics: - **Complete v2.1 Pokédex (`547` + Optional `+3` Special Forms):** Tracks every catch and evolution across **10 Boss Level-Cap Sections** (`Roark Lv. 16` → `Gardenia Lv. 26` → `Fantina Lv. 33` → `Maylene Lv. 39` → `Wake Lv. 44` → `Byron Lv. 53` → `Candice Lv. 56` → `Volkner Lv. 62` → `Cynthia Lv. 78` → `Post-Game Lv. 100`), with an optional **Special Forms (+3)** toggle for Crystal Onix, Stitched Gengar, and Spiky-Eared Pichu (`550`). - **Live Incense Burner Slot Simulator:** Toggle **Incense Burner** right from the header, section banner, or next to `Any Incense` spawns to activate regional encounters (`Any Incense` / `Any Incense Surf`) and see real-time overwritten spawn rates (`20%` Grass slots 4–5 pushing displaced Pokémon into `1%` slots 10–11, and `30%` Surf slot 1 overrides marked **`Replaced by Incense`**). - **Accurate Chronological Progression:** Includes the **Route 201 Initial Starter Picker**, **Jubilife Trainer School 1-of-18 Mystery Egg Picker** (tracks early bonus picks without locking the remaining 17 babies out of later routes), chronological **Old Rod** backtracks after visiting the Jubilife–Route 218 Gatehouse, and separate backtrack cards for Good Rod, Honey Trees, Surf, and Super Rod. - **Route Trainers & `[Team 1–4]` Boss Variants:** Collapsible battle cards covering regular trainers, Rivals (`Barry`, `Dawn`, `Lucas`, `Cedric`), Team Galactic raids, Johto Time Portals, Type Masters, and randomized `[Team 1–4]` boss lineups with variant filtering. - **Luminescent Base Stats & Movedex:** Sortable Pokédex plus full inspector modal with Luminescent v2.1 stats, custom abilities, Regular & Shiny sprites, full learnsets, and external Pokédex links. --- ## Core Site Features - **Unified Hub Landing Page (`/`):** Launch either tracker cleanly from [index.html](./index.html), with live client-side detection showing your saved profile progress on each game card and a **`← Hub`** navigation button in every tracker header. - **Independent Multi-Save Profiles:** Run multiple challenge playthroughs per game (Create, Rename, Delete, Reset, Export Save, Import JSON backup). - **Zero-Dependency Stack:** Built with plain HTML, CSS, and Vanilla ES Modules—no frontend bundler, framework runtime, or third-party npm packages required. --- ## Project Layout ```text . ├── index.html # Landing hub page (/) ├── assets/ # Hub styles & save-badge preview script ├── oras/ # Alpha Sapphire & Omega Ruby tracker (/oras/) ├── luminescent-platinum/ # Luminescent Platinum v2.1 tracker (/luminescent-platinum/) ├── tests/ # Hub server & packaging tests ├── docker/nginx.conf # Nginx static server configuration ├── Dockerfile # Lightweight Nginx container build ├── docker-compose.yml # Container deployment definition └── server.mjs # Local Node.js static server ``` --- ## Screenshots *(You can add screenshots to `docs/screenshots/`—such as `hub.png`, `oras-checklist.png`, `luminescent-incense.png`, and `pokedex-modal.png`—and link them here.)* --- ## Running Locally or with Docker Requires **Node.js 20+** for local development/testing: ```bash # Run all test suites (Hub + ORAS + Luminescent Platinum) npm test # Start unified local server on http://127.0.0.1:4173 npm start ``` Or run as a self-contained static container (`nginx:1.27-alpine`, serving on port `28473`): ```bash docker compose up -d --build ``` Behind a reverse proxy, point your host/subdomain to container port `28473` over `http` (`absolute_redirect off` is already enabled in [docker/nginx.conf](./docker/nginx.conf)). --- ## Data Sources & Credits - **Team Luminescent:** Pokémon Luminescent Platinum v2.0/v2.1 Pokédex data, encounter tables, trainer teams, move learnsets, and sprites. - **Serebii.net:** Pokémon ORAS Pokéarth encounter data and Gen VI `pokedex-xy` base stats & abilities. - **PokeAPI:** Gen VI Pokémon/item sprites and ORAS learnset tables.