Add standalone Pokémon Legends: Arceus POC tracker (Hisui 242 Pokédex, Research Tasks & RL10 mode, Satchel MP & Save Mythicals toggles, Noble/story battles, saves/movesets), bundle local sprite packs across all three trackers into Git/Docker/Nginx with attribution credits, and update Hub landing page & unified server/tests.
120 lines
9.9 KiB
Markdown
120 lines
9.9 KiB
Markdown
# 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.
|
||
|
||
### 3. Pokémon Legends: Arceus (`/legends-arceus/`)
|
||
A complete **Nintendo Switch · Gen VIII · Hisui** Professor Oak Challenge & Research Lv. 10 tracker organized by **Noble Pokémon & Ride Mount Checkpoints**:
|
||
|
||
- **Hisui Pokédex (`240` + Optional `+2` Save-Data Mythicals = `242`):** Spans **6 Noble & Progression Sections** (`Pre-Kleavor` -> `Pre-Lilligant` -> `Pre-Arcanine` -> `Pre-Electrode` -> `Pre-Avalugg` -> `Climax & Post-Game Arceus`) with earliest-section evolutions and Space-Time Distortion milestones.
|
||
- **Dual Caught & Research Lv. 10 (`RL10`) Sync:** Check off both **Caught** and **`Lv10`** across Routes, Pokédex, and Modals, and toggle progress bars & filters between **Caught Only** and **Research Lv. 10** (accurately shifting `#142 Unown` RL10 to Section 5 once all `28/28` forms are reachable with Braviary).
|
||
- **Optional Satchel MP Shop Toggle:** Enable **Satchel MP Shop** in the header to move Trading Post items (`Golem`, `Machamp`, `Scizor`, `Glaceon`) into **Section 1 Pre-Kleavor**, or leave it off for Sparkling Ore, Graveler (`8% Black Augurite`), and Section 2 Distortion timing.
|
||
- **Research Tasks, Mastery Movedex & Story Trainers:** Every entry includes its Serebii Research Tasks table (highlighting `2×` boost tasks), Hisui Base Stats, Level-Up + Mastery Lv. & Move Shop learnsets, and collapsible Noble / Warden / Bandit / Volo battle drawers.
|
||
|
||
---
|
||
|
||
## 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/)
|
||
├── legends-arceus/ # Pokémon Legends: Arceus tracker (/legends-arceus/)
|
||
├── scripts/ # Offline sprite cache & Gitea/Unraid automation scripts
|
||
├── 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
|
||
|
||
### Unified Tracker Hub (`/`)
|
||

|
||
|
||
### Omega Ruby & Alpha Sapphire — Route Checklist (`/oras/`)
|
||

|
||
|
||
### Luminescent Platinum v2.1 — Live Incense Burner Slot Overrides (`/luminescent-platinum/`)
|
||

|
||
|
||
### Pokédex View & Pokémon Detail / Movedex Modal
|
||

|
||
|
||

|
||
|
||
---
|
||
|
||
## Running Locally or with Docker
|
||
|
||
Requires **Node.js 20+** for local development/testing:
|
||
|
||
```bash
|
||
# Run all test suites (Hub + ORAS + Luminescent Platinum + Legends: Arceus)
|
||
npm test
|
||
|
||
# Start unified local server on http://127.0.0.1:4173
|
||
npm start
|
||
|
||
# Refresh or verify the bundled local sprite caches in <game>/assets/sprites/
|
||
npm run download-sprites
|
||
```
|
||
|
||
Or run as a self-contained static container (`nginx:1.27-alpine`, serving on port `28473`, with all Pokémon and item sprites bundled locally inside the image):
|
||
|
||
```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, Sprites & Credits
|
||
|
||
All Pokémon & item sprites are bundled locally inside `*/assets/sprites/` courtesy of the open-source communities below so the site runs self-contained without depending on external image hosts at runtime:
|
||
|
||
- **Sprites courtesy of [PokeAPI/sprites](https://github.com/PokeAPI/sprites):** Bundled Gen VI Omega Ruby & Alpha Sapphire sprites/items (`oras/assets/sprites/`) and Pokémon HOME / Hisui sprites & items (`legends-arceus/assets/sprites/`, plus Poké Ball fallback icon).
|
||
- **Sprites & mod data courtesy of [Team Luminescent (`TeamLumi/luminescent-team`)](https://github.com/TeamLumi/luminescent-team):** Bundled BDSP-style regular, shiny, item, rock, and incense sprites (`luminescent-platinum/assets/sprites/`), plus Luminescent Platinum v2.0/v2.1 Pokédex, encounter tables, trainer teams, and learnsets.
|
||
- **Encounter, trainer & Pokédex data courtesy of [Serebii.net](https://www.serebii.net):** ORAS Pokéarth encounters & Gen VI `pokedex-xy` stats/abilities, and Pokémon Legends: Arceus Pokéarth Hisui subareas, Distortions, Research Tasks, Noble/Warden/Miss Fortune/Volo battles, Requests, and Hisuian stats.
|
||
- **Learnset & stat tables courtesy of [PokéAPI (`PokeAPI/pokeapi`)](https://github.com/PokeAPI/pokeapi):** Structured ORAS (`Gen VI`) and Legends: Arceus (`version_group_id=24`) Level-Up / Mastery / Move Shop move tables.
|
||
|
||
> *Pokémon and all related names, characters, and artwork are trademarks of Nintendo, Creatures Inc., and GAME FREAK inc. This is a non-commercial fan-made challenge tracker and is not affiliated with or endorsed by them.*
|