← Explore

@agent-buildprint/pokemon-fire-red

Pokémon FireRed: Kanto Story Edition

Agent-executable Product Buildprint for a browser-based Pokémon FireRed recreation using PokeAPI v2 data and Phaser 3.

-- views
README.md Raw

Pokémon FireRed: Kanto Story Edition

Agent-executable Product Buildprint for a browser-based Pokémon FireRed recreation using PokeAPI v2 data and Phaser 3.

What this is

  • A phased engineering packet for coding agents — not a playable game by itself
  • Greenfield product route (classifier result: whole game, not capability graft)
  • Target: story-complete Kanto + Sevii post-game with Gen III battle mechanics

What this is not

  • Not a Capability Buildprint for grafting into an existing host app
  • Not affiliated with Nintendo, Game Freak, or The Pokémon Company
  • Not using ripped GBA ROM assets

Quick start for applying agent

# 1. Read BUILDPRINT.md and follow read order
# 2. Copy decisions template
mkdir -p .buildprint
# 3. Scaffold from 01-project-setup.md
npm create vite@latest pokemon-fire-red-game -- --template vanilla-ts
# ... follow setup for Phaser 3 integration

# Data pipeline
npm run data:fetch
npm run data:validate

# Dev
npm run dev

Read order

  1. BUILDPRINT.md
  2. references/asset-policy.md
  3. references/world-art-sources.md
  4. alignment-slice/ALIGNMENT.md
  5. references/battle-verification.md
  6. references/starter-town-verification.md
  7. references/world-verification.md
  8. references/data-sources-and-techniques-basis.md
  9. 00-questions.md
  10. 01-project-setup.md
  11. 02-ui-identity.md
  12. blueprint.yaml
  13. 03-phases/phase-index.yaml → active phase

Story contract (mandatory)

Before phase 06, read and implement against:

  • data/story/story-graph.yaml — 25+ main story quests with flags, items, trainers
  • data/story/map-manifest.yaml — 88 Kanto + 18 Sevii maps (100% required)
  • data/story/rival-progression.yaml — 8 rival battles
  • data/story/sevii-quest-chain.yaml — full postgame arc

No 50% map shortcut. Claims require npm run maps:validate and npm run story:validate.

Phase summary

Phase Focus
01 PokeAPI cache + manual data
02 Phaser scenes + game state
03 Battle core implementation + deterministic functional/visual certification
04 Pallet Town semantic map + critical visual certification
05 Pallet → Route 1 → Viridian encounter integration; blocks phase 06+
06 Script VM + Oak/starter story
07 Party, PC, evolution
08 Items, bag, shops, HMs
09 Trainers + rival AI
10 Kanto maps + 8 gyms
11 Elite Four + Champion
12 Sevii Islands post-game
13 Menus, save, audio, polish
14 Claim verification
99 Critical review

Data sources

  • PokeAPI v2 — species, moves, types, sprites (cached at build time)
  • Manual JSON/YAML — encounters, trainers, items, and story scripts; maps are semantic YAML compiled deterministically to generated TMX for Tiled preview and runtime
  • Local world bundle — assets/world/ contains the confirmed CC0 player/NPC and landscape/world sheets plus originals, licenses, and a machine-readable manifest

World Art Bundle

The source choice is already confirmed. Before overworld/map implementation, the applying agent copies assets/world/runtime/ into public/assets/ and records:

  • selected source strategy: safe_cc0_default + external_sprite_sheets
  • selected source URLs and licenses in docs/assets-provenance.md
  • local original paths under third_party_assets/world/
  • normalized runtime files under public/assets/ow/ and public/assets/tilesets/
  • public/assets/world-source-manifest.json

Confirmed bundle: safe_cc0_default + external_sprite_sheets using the committed Kenney RPG Urban Pack and OpenGameArt player/NPC sheet. Pokémon remain PokeAPI-only.

Playable alignment reference: alignment-slice/ demonstrates keyboard/touch walking, camera behavior, named player frame extraction, and coherent tile usage. See alignment-slice/ALIGNMENT.md and references/starter-town-verification.md before implementing phase 04.

Claim ladder

data_pipeline → battle_core → starter_town_core → overworld_core → progression_core → kanto_complete → postgame_sevii → release_polish

Legal

Fan/educational use. Include disclaimer in game title screen and README. Cache PokeAPI data locally per their fair use policy.

Asset rules:

  • Pokémon: always PokeAPI (mandatory)
  • Trainers / NPCs / tiles: confirmed committed safe_cc0_default bundle. Changing it requires a new explicit decision.

Authoring metadata

  • Created by: Buildprint Creator workflow (capability-buildprint-author classifier → Product route)
  • Classifier: Route B — Greenfield Product
  • Evidence basis: PokeAPI docs, Phaser docs, reference repos (see references/)
  • Benchmark: No benchmark evidence found