dev-jelly avatar

pokemon-green-en

Pokemon Green Version Text RPG. Gen 1 with 151 Pokemon, 165 moves, full Kanto region. English only.

version
1.0.0
GitHub stars
9

Install

/plugin install pokemon-green-en@pokemon-skills

Run it inside Claude Code after adding the marketplace with /plugin marketplace add dev-jelly/pokemon-skills.

Contents

Discovered from source

Skills 1

Pokemon Green Version - Text RPG (English)

A Claude skill that fully recreates Gen 1 Pokemon Green Version as a text-based RPG. (English only)

When to Invoke

This skill is automatically activated when:

  • User mentions "pokemon", "pikachu"
  • "new game", "continue", "start game" requests
  • "battle", "gym", "wild", "pokedex" related conversation

Game Features

  • 151 Pokemon: From Bulbasaur to Mew
  • 165 Moves: All Gen 1 moves implemented
  • 15 Type Chart: Including Gen 1 specific bugs
  • Kanto Region: From Pallet Town to Pokemon League
  • 8 Gyms: Brock, Misty, Lt. Surge, Erika, Koga, Sabrina, Blaine, Giovanni
  • Save/Load: 10 slots + autosave
  • BGM Autoplay: 45 tracks (macOS afplay)
  • ASCII Art: 151 Pokemon sprites
  • Cries: 151 Pokemon cries

Opening Sequence (Fixed - Must Follow This Order)

Initialization

pkill -f 'pokemon-green.*bgm' 2>/dev/null

Step 1: Title Screen (Required)

Must start with this screen. Cannot be skipped.

╔════════════════════════════════════════════════════╗
║                                                    ║
║           ╔══════════════════════╗                 ║
║           ║                      ║                 ║
║           ║    P O K E M O N     ║                 ║
║           ║                      ║                 ║
║           ║    GREEN  VERSION    ║                 ║
║           ║                      ║                 ║
║           ╚══════════════════════╝                 ║
║                                                    ║
║                                                    ║
║                  Press Start                       ║
║                                                    ║
║                                                    ║
║           (C) 1996 Nintendo/GAME FREAK             ║
║                                                    ║
╚════════════════════════════════════════════════════╝

BGM: title_screen.mp3 (loop)

while true; do afplay [skillPath]/data/audio/bgm/title_screen.mp3 2>/dev/null || break; done
run_in_background: true

Step 2: Menu Screen (New Game/Continue)

Shown after "start" input:

╔══════════════════════════════════════════════════════════════╗
║                                                              ║
║                    P O K E M O N                             ║
║                    GREEN VERSION                             ║
║                                                              ║
║                   ▶ NEW GAME                                 ║
║                     CONTINUE                                 ║
║                                                              ║
╚══════════════════════════════════════════════════════════════╝

BGM: title_screen.mp3 (continues playing)

Step 3: Opening Movie (New Game - Required)

When "NEW GAME" selected, opening movie must play. Cannot skip.

╔══════════════════════════════════════════════════════════════╗
║                                                              ║
║     [Nidoran♂ silhouette]      [Nidoran♀ silhouette]        ║
║                                                              ║
║              Welcome to the world of Pokemon!                ║
║                                                              ║
╚══════════════════════════════════════════════════════════════╝

BGM Switch: opening.mp3 (play once)

pkill -f 'afplay.*pokemon-green' 2>/dev/null
afplay [skillPath]/data/audio/bgm/opening.mp3 2>/dev/null
# Only proceed to next step after opening.mp3 finishes

Step 4: Prof. Oak Appears

Auto-transition after opening movie ends:

BGM Switch: professor_oak.mp3

while true; do afplay [skillPath]/data/audio/bgm/professor_oak.mp3 2>/dev/null || break; done
run_in_background: true

Sequence:

  1. Prof. Oak greeting + Pokemon world introduction
  2. Set player name (default: RED)
  3. Set rival name (default: BLUE)

Step 5: Game Start (Pallet Town)

After name input complete:

BGM Switch: pallet_town.mp3 (loop)

pkill -f 'afplay.*pokemon-green' 2>/dev/null
while true; do afplay [skillPath]/data/audio/bgm/pallet_town.mp3 2>/dev/null || break; done
run_in_background: true

BGM Transition Flow (Fixed)

[Title Screen] ─── title_screen.mp3 (loop)
      │
      │ "start"
      ▼
[Menu Screen] ──── title_screen.mp3 (continues)
      │
      │ "new game"
      ▼
[Opening Movie] ── opening.mp3 (once, play to end)
      │
      │ auto-transition
      ▼
[Prof. Oak] ────── professor_oak.mp3
      │
      │ name input complete
      ▼
[Pallet Town] ──── pallet_town.mp3 (loop)

Main BGM Files

SituationFilenamePlayback
Title Screentitle_screen.mp3Loop
Opening Movieopening.mp3Once
Prof. Oakprofessor_oak.mp3Loop
Pallet Townpallet_town.mp3Loop
Routeroute_theme.mp3Loop
Wild Battlewild_battle.mp3Loop
Trainer Battletrainer_battle.mp3Loop
Pokemon Centerpokemon_center.mp3Loop

BGM Playback Rules

File path: data/audio/bgm/[filename].mp3

# Stop BGM
pkill -f 'afplay.*pokemon-green' 2>/dev/null

# Play BGM (background loop)
while true; do afplay [skillPath]/data/audio/bgm/[filename].mp3 2>/dev/null || break; done
run_in_background: true

Error handling:

  • || break: Prevents infinite loop if file missing
  • 2>/dev/null: Hides error messages

Command System

Field Commands

  • north/south/east/west: Move in that direction (e.g., "go north")
  • go to [location]: Move to specific location (e.g., "go to Pewter City")
  • status / party: Check party Pokemon (e.g., "check status")
  • bag: Check inventory (e.g., "open bag")
  • pokedex: Pokemon encyclopedia (e.g., "view pokedex")
  • save: Save game (e.g., "save")
  • talk: Talk to NPC (e.g., "talk")
  • NPC: Check NPC info (e.g., "NPC list")

Battle Commands

  • fight: Enter move selection mode
  • [move name] / [number]: Use a move
  • bag: Use item
  • pokemon: Switch Pokemon
  • run: Flee from wild battle

Audio Commands

  • bgm off: Stop BGM
  • bgm on: Play BGM
  • volume [0-100]: Adjust volume
  • cry: Pokemon cry

Move Sound Effects

Sound effect mapping: data/audio/sfx-mapping.json


Game Flow (Original Recreation)

IMPORTANT: Story events follow data/world/story-events.json in original game order.

Chapter 1: Opening

BGM Flow (Required):

  1. New Game selected -> Play opening.mp3 (Opening Movie)
  2. Prof. Oak appears -> Switch to professor_oak.mp3 (Oak's Theme)
  3. Opening ends -> Switch to pallet_town.mp3 (Pallet Town)

Event Sequence:

  1. Prof. Oak greeting + Pokemon world introduction
  2. Set player name (default: RED)
  3. Set rival name (default: BLUE)

Chapter 2: Pallet Town - The Beginning

  1. Start in Player's Room 2F
  2. Try to leave town north -> Oak stops you!
    • "It's dangerous! Wild Pokemon live in the grass!"
  3. Forced to Oak's Lab
  4. Choose starter (Bulbasaur/Charmander/Squirtle)
    • Rival picks type advantage Pokemon
    • Pick Bulbasaur -> Rival gets Charmander
    • Pick Charmander -> Rival gets Squirtle
    • Pick Squirtle -> Rival gets Bulbasaur
  5. Try to leave lab -> Rival's first battle! (Lv.5)

Chapter 3: Oak's Parcel

  1. Route 1 (wild Pokemon appear)
  2. Viridian Poke Mart - receive Oak's Parcel
  3. Return to Pallet Town Oak's Lab
  4. Deliver parcel -> POKEDEX + 5 POKE BALLS
  5. (Optional) Get TOWN MAP from rival's house

Chapter 4: Road to Pewter City

  1. (Optional) Route 22 - Rival battle 2 (Lv.9)
  2. Viridian Gym - locked (need 7 badges)
  3. Viridian Forest - Bug Pokemon, trainers
  4. Arrive at Pewter City
  5. Pewter Gym - Brock battle -> Boulder Badge

Chapter 5: Mt. Moon and the Fossil

  1. Route 3 -> Enter Mt. Moon
  2. Team Rocket first encounter in Mt. Moon
  3. Beat Super Nerd -> Choose fossil (Helix/Dome)
  4. Route 4 -> Arrive at Cerulean City

Chapter 6: Cerulean City and Bill

  1. Nugget Bridge (Route 24) - 5 trainers + Team Rocket
  2. Route 25 -> Bill's House
    • Bill rescue event -> S.S. TICKET
  3. Cerulean Gym - Misty battle -> Cascade Badge
  4. (Optional) Catch Team Rocket thief south of Cerulean

Chapter 7: S.S. Anne

  1. Travel to Vermilion City (Route 5 -> Underground -> Route 6)
  2. Board S.S. Anne (ticket required)
  3. Rival battle 3 on the ship
  4. Rub Captain's back -> HM01 CUT
  5. Exit ship -> S.S. Anne departs (can't return)
  6. Vermilion Gym - trash can puzzle -> Lt. Surge -> Thunder Badge

Chapter 8: Rocket Hideout

  1. Rock Tunnel (Flash needed) -> Lavender Town
  2. Pokemon Tower - blocked by ghost (need Silph Scope)
  3. Travel to Celadon City (Route 7)
  4. Game Corner poster switch -> Rocket Hideout
  5. Giovanni battle 1 -> SILPH SCOPE
  6. Celadon Gym - Erika battle -> Rainbow Badge

Chapter 9: Pokemon Tower Rescue

  1. Return to Lavender Town Pokemon Tower (with Silph Scope)
  2. Ghost identity = Marowak's ghost (can't catch)
  3. Rescue Mr. Fuji -> POKE FLUTE

Chapter 10: Fuchsia City

  1. Wake Snorlax (Route 12 or Route 16)
  2. Arrive at Fuchsia City
  3. Safari Zone -> HM03 SURF
  4. Fuchsia Gym - Koga battle -> Soul Badge

Chapter 11: Silph Co.

  1. Saffron City - Team Rocket occupation (gym blocked)
  2. Enter Silph Co.
  3. Rival battle 4 on 7F
  4. Giovanni battle 2 on 11F
  5. Receive MASTER BALL from president
  6. Saffron Gym - Sabrina battle -> Marsh Badge
  7. (Optional) Fighting Dojo - choose Hitmonlee/Hitmonchan

Chapter 12: Cinnabar Island

  1. Surf to Cinnabar Island (via Seafoam Islands)
  2. Pokemon Mansion -> SECRET KEY
  3. Cinnabar Gym - Blaine battle -> Volcano Badge
  4. (Optional) Revive fossil at lab

Chapter 13: Final Badge

  1. Viridian Gym opens (with 7 badges)
  2. Giovanni battle 3 (Gym Leader) -> Earth Badge + Team Rocket disbands

Chapter 14: Pokemon League

  1. (Optional) Route 22 final rival battle (Lv.47~53)
  2. Route 23 badge check (8 required)
  3. Victory Road passage
  4. Arrive at Indigo Plateau

Chapter 15: Elite Four and Champion

  1. Lorelei (Ice) -> Bruno (Fighting) -> Agatha (Ghost) -> Lance (Dragon)
  2. Champion Rival final battle
  3. Hall of Fame registration - Game Clear!

Post Game

  1. Cerulean Cave opens (north of Cerulean City)
  2. Mewtwo catchable (Lv.70)
  3. Legendary Pokemon: Articuno (Seafoam), Zapdos (Power Plant), Moltres (Victory Road)

Story Event Loading

# Load chapter events
jq '.chapter_1.events' data/world/story-events.json

# Load specific event
jq '.chapter_1.events[] | select(.id == "choose_starter")' data/world/story-events.json

# Load rival battle data
jq '.rv.oak_lab' data/world/trainers.json

Story Flag Management

Track progress with storyFlags array in save file:

{
  "storyFlags": [
    "game_started",
    "has_starter",
    "rival_battle_1_done",
    "quest_parcel",
    "has_parcel",
    "delivered_parcel",
    "has_pokedex"
  ]
}

Battle System

Original Battle Screen (Gen 1 Recreation)

Battle screen is displayed simply like the original. Shows only essential elements without unnecessary tips or extra information.

Sprite Display Rules (Original Recreation):

  • Opponent Pokemon: Full 13 lines (right-aligned) - Front view
  • My Pokemon: Top 5-6 lines only (left, horizontally flipped) - Back view feel
  • pokemon-ascii-mini.json sprites are 13 lines × 28 characters
  • My Pokemon: flip horizontally and show only top portion

Battle Screen Layout:

╔════════════════════════════════════════════════════════════════╗
║  Wild Pokemon                                       Lv.5      ║
║  ▓▓▓▓▓▓▓▓▓▓░░░░  HP                                           ║
║                                                                ║
║                                  [Opponent Pokemon Sprite]     ║
║                                  (Full 13 lines - right align) ║
║                                  (Front view)                  ║
║                                                                ║
║  [My Pokemon - Back view]                                      ║
║  (Top 5-6 lines only - left)                                   ║
║  (Horizontally flipped, bottom cut off)                        ║
║                                                                ║
║  Pokemon                                            Lv.5      ║
║  ▓▓▓▓▓▓▓▓▓▓▓▓▓░░  HP  22/22                                   ║
╠════════════════════════════════════════════════════════════════╣
║  A wild Pokemon appeared!                                      ║
╠════════════════════════════════════════════════════════════════╣
║     FIGHT             BAG                                      ║
║     POKEMON           RUN                                      ║
╚════════════════════════════════════════════════════════════════╝

Actual Battle Screen Example:

╔════════════════════════════════════════════════════════════════╗
║  Wild PIKACHU                                       Lv.5      ║
║  ▓▓▓▓▓▓▓▓▓▓░░░░  HP                                           ║
║                                                                ║
║                                          :.            :+=.   ║
║                                        .**.       . .-*#**#-  ║
║                                        -*:    =*+::-+#***+-   ║
║                                    .-*##%#+-:#%#+=+**+*+-     ║
║                                    =%%#########- .=***-.      ║
║                                   =%*#%#*+.:%%#*-   -*#=      ║
║                                   .=*#%%#*++*##%%*..+=:       ║
║                                   .:.:+#*%#+=#%##*+=-:        ║
║                                        :**==+*=+%%#=..        ║
║                                         :+*+++#%#%*:          ║
║                                             .++*%*.           ║
║                                                 :             ║
║                                                                ║
║       :  :                                                     ║
║       ++=*.                                                    ║
║    .-+-+--==..                                                 ║
║ .-+*+==+-=++=++:                                               ║
║ :++==+++++=-+=-=-:..==                                         ║
║ :+=-=+==++--=---:-+**#+                                        ║
║                                                                ║
║  BULBASAUR                                          Lv.5      ║
║  ▓▓▓▓▓▓▓▓▓▓▓▓▓░░  HP  22/22                                   ║
╠════════════════════════════════════════════════════════════════╣
║  A wild PIKACHU appeared!                                      ║
╠════════════════════════════════════════════════════════════════╣
║     FIGHT             BAG                                      ║
║     POKEMON           RUN                                      ║
╚════════════════════════════════════════════════════════════════╝

Message Display Principles (Original Faithful)

What to Display (same as original):

  • "A wild [Pokemon] appeared!"
  • "[Pokemon] used [Move]!"
  • "It's super effective!" or "It's not very effective..."
  • "A critical hit!"
  • "[Pokemon] fainted!"
  • Status condition messages

What NOT to Display (not in original):

  • Damage numbers (HP bar decrease only)
  • Type effectiveness hints/recommendations
  • Move selection tips
  • Tactical advice
  • AI behavior predictions

ASCII Art Display

  • Battle Start: pokemon-ascii.json (full art once)
  • During Battle: pokemon-ascii-mini.json (mini art)
  • Pokedex: pokemon-ascii.json (full art)

Damage Calculation (Gen 1)

Damage = ((2*Lv/5+2) * Power * A/D / 50 + 2) * STAB * Type * Crit * Random

Gen 1 Bug Recreation

  • Psychic vs Ghost: 0x
  • Focus Energy: Decreases critical rate
  • Poison vs Bug: 2x

NPC System

NPC Sprite Loading Rules

Loading Order (Required!)
  1. Convert Korean->English in data/sprites/npc-mapping.json
  2. Load data/sprites/npc_ascii/[EnglishName].json file
  3. Display .down key ASCII art
jq Loading Example
# Load sprite (cannot load directly with Korean name!)
jq -r '.down | join("\n")' data/sprites/npc_ascii/Professor_Oak.json
Main NPC English Filenames
NameFilenameCategory
Prof. OakProfessor_Oak.jsonStory NPC
Nurse JoyNurse_Joy.jsonFacility NPC
RivalRival.jsonChampion
BrockBrock.jsonGym Leader
MistyMisty.jsonGym Leader
Error Handling
  • File not found: Skip sprite, show dialogue only
  • JSON parse fail: Use default text

Dialogue Screen Example

+------------------------------------+
|  [NPC Sprite]                      |
|                                    |
|  Nurse Joy:                        |
|  "Welcome to the Pokemon Center!"  |
+------------------------------------+
|  [1] Yes    [2] No                 |
+------------------------------------+

Save System

Saving

  • Manual save: "save" or "save [slot number]"
  • Auto save: Pokemon Center, city entry, after battle

Save Slots (10 + autosave)

  • save [1-10]: Save to specific slot
  • load [1-10]: Load specific slot
  • save list: View all slots

Gym Information

  1. Pewter City - Brock (Rock) -> Boulder Badge
  2. Cerulean City - Misty (Water) -> Cascade Badge
  3. Vermilion City - Lt. Surge (Electric) -> Thunder Badge
  4. Celadon City - Erika (Grass) -> Rainbow Badge
  5. Fuchsia City - Koga (Poison) -> Soul Badge
  6. Saffron City - Sabrina (Psychic) -> Marsh Badge
  7. Cinnabar Island - Blaine (Fire) -> Volcano Badge
  8. Viridian City - Giovanni (Ground) -> Earth Badge

Data File Reference

Pokemon Data

  • data/pokemon/species.json: 151 species data
  • data/pokemon/learnsets.json: Level-up moves
  • data/pokemon/evolutions.json: Evolution conditions

Move/Type Data

  • data/moves/moves.json: 165 moves
  • data/types/chart.json: 15 type chart

World Data

  • data/world/locations.json: Towns/routes
  • data/world/encounters.json: Wild encounters
  • data/world/trainers.json: Trainers

Audio Data

  • data/audio/bgm-mapping.json: 45 BGM mapping
  • data/audio/cries-mapping.json: 151 cries

ASCII Art

  • data/sprites/pokemon-ascii.json: Full art
  • data/sprites/pokemon-ascii-mini.json: Mini art
  • data/sprites/npc_ascii/: NPC mini art (94 individual files)
  • data/sprites/npc-mapping.json: NPC Korean->filename mapping

Data Key Mapping (Optimized Format)

species.json

n=name, t=types, s=stats[hp,atk,def,spc,spd], c=catchRate, e=baseExp
g=growthRate(ms=medium_slow,mf=medium_fast,s=slow,f=fast), hw=[height,weight]

moves.json

i=id, n=name, t=type, c=category, p=power, a=accuracy, pp=pp, pr=priority, ef=effect
Type codes: N=Normal,F=Fire,W=Water,G=Grass,E=Electric,I=Ice,K=Fighting,P=Poison,R=Ground,Y=Flying,S=Psychic,B=Bug,O=Rock,H=Ghost,D=Dragon
Category: P=Physical, S=Special, X=Status

learnsets.json

lv=levelUp[[level,move]], tm=[number], hm=[number]

encounters.json

g=grass, c=cave, w=water, f=fishing
Format: [[pokemonID, minLv, maxLv, encounterRate]]

trainers.json

n=name, ti=title, g=gym, c=city, ty=type, b=badge, r=reward, tm=tmReward
o=order, d=dialogue, p=team[[id,lv,[moves]]], cl=class
gl=gymLeaders, e4=eliteFour, ch=champion, rt=routeTrainers

items.json

n=name, d=desc, p=price, cm=catchMod, ha=heal, c=cures, ra=revive
ppr=ppRestore, am=allMoves, sb=statBoost, ef=effect, st=steps, et=evoType
Categories: pb=pokeballs, pt=potions, sh=statusHealers, rv=revives, pp=ppItems
bt=battleItems, rp=repels, es=escapeItems, ev=evolutionStones, vi=vitamins

Data Loading

Extract only needed parts with jq (don't load entire large files)

jq '.["25"]' data/pokemon/species.json      # Species data
jq '.["025"]' data/sprites/pokemon-ascii.json  # Sprite (3 digits)

Key formats:

  • species, learnsets: number key ("25")
  • sprites: 3-digit key ("025")

References (Detailed Guides)

For detailed system information, refer to these documents:

  • BGM System Guide (references/bgm-guide.md) - BGM autoplay, commands, event mapping
  • Move SFX Guide (references/sfx-guide.md) - Move sound effects, download method
  • ASCII Art Guide (references/ascii-guide.md) - ASCII art usage rules, data files
  • NPC System Guide (references/npc-guide.md) - NPC sprite display, name mapping
  • Cries Guide (references/cries-guide.md) - Cry playback timing, commands
  • Data Integrity Guide (references/data-integrity.md) - Data validation rules, checklist

Language Settings

This skill is English only.

For Korean version, use the separate skill pokemon-green-ko.

Data File Structure

All names/messages are stored in single language format:

{
  "name": "Bulbasaur",
  "text": "A wild Pokemon appeared!"
}

Message files:

  • data/messages/battle.json - Battle messages

Help

Use these commands anytime during the game:

  • "help" - Command list
  • "location" - Current location info
  • "progress" - Story progress

Sponsors

Details

Marketplace
dev-jelly/pokemon-skills
Source
.claude/skills/pokemon-green-en
Category
Entertainment

More from dev-jelly/pokemon-skills

All 2