
pokemon-green-ko
포켓몬 그린 버전 텍스트 RPG. 1세대 151마리 포켓몬, 165개 기술, 관동 지방 완전 재현. 한국어 전용.
- version
- 1.0.0
- GitHub stars
- 9
Install
/plugin install pokemon-green-ko@pokemon-skillsRun it inside Claude Code after adding the marketplace with /plugin marketplace add dev-jelly/pokemon-skills.
Contents
Discovered from sourceSkills 1
포켓몬 그린 버전 - 텍스트 RPG (한국어)
1세대 포켓몬 그린 버전을 텍스트 기반 RPG로 완전 재현한 클로드 스킬입니다. (한국어 전용)
When to Invoke
이 스킬은 다음 상황에서 자동 활성화됩니다:
- 사용자가 "포켓몬", "피카츄", "포켓몬스터" 언급 시
- "새 게임", "이어하기", "게임 시작" 요청 시
- "전투", "체육관", "야생", "도감" 관련 대화 시
- "pokemon", "pikachu" 영어 키워드 사용 시
게임 특징
- 151마리 포켓몬: 이상해씨부터 뮤까지 완전 수록
- 165개 기술: 모든 1세대 기술 구현
- 15타입 상성: 1세대 고유 버그 포함
- 관동 지방: 태초마을부터 포켓몬 리그까지
- 8개 체육관: 웅, 이슬, 마티스, 민화, 독수, 초련, 강연, 비주기
- 세이브/로드: 10개 슬롯 + 자동저장
- BGM 자동재생: 45곡 (macOS afplay)
- ASCII 아트: 151마리 포켓몬 스프라이트
- 울음소리: 151마리 포켓몬 울음소리
오프닝 시퀀스 (고정 - 반드시 이 순서대로 진행)
초기화
pkill -f 'pokemon-green.*bgm' 2>/dev/null
1단계: 타이틀 화면 (필수 표시)
반드시 이 화면부터 시작합니다. 생략 불가.
╔════════════════════════════════════════════════════╗
║ ║
║ ╔══════════════════════╗ ║
║ ║ ║ ║
║ ║ P O K E M O N ║ ║
║ ║ ║ ║
║ ║ GREEN VERSION ║ ║
║ ║ ║ ║
║ ╚══════════════════════╝ ║
║ ║
║ ║
║ Press Start ║
║ ║
║ ║
║ (C) 1996 Nintendo/GAME FREAK ║
║ ║
╚════════════════════════════════════════════════════╝
BGM: title_screen.mp3 (반복 재생)
while true; do afplay [skillPath]/data/audio/bgm/title_screen.mp3 2>/dev/null || break; done
run_in_background: true
2단계: 메뉴 화면 (새 게임/이어하기)
"시작" 입력 후 표시:
╔══════════════════════════════════════════════════════════════╗
║ ║
║ P O K E M O N ║
║ GREEN VERSION ║
║ ║
║ ▶ 새 게임 ║
║ 이어하기 ║
║ ║
╚══════════════════════════════════════════════════════════════╝
BGM: title_screen.mp3 (계속 재생)
3단계: 오프닝 무비 (새 게임 선택 시 - 필수 재생)
"새 게임" 선택 시 반드시 오프닝 무비 재생. 스킵 불가.
╔══════════════════════════════════════════════════════════════╗
║ ║
║ [니드런♂ 실루엣] [니드런♀ 실루엣] ║
║ ║
║ 포켓몬의 세계에 오신 것을 환영합니다! ║
║ ║
╚══════════════════════════════════════════════════════════════╝
BGM 전환: opening.mp3 (1회 재생)
pkill -f 'afplay.*pokemon-green' 2>/dev/null
afplay [skillPath]/data/audio/bgm/opening.mp3 2>/dev/null
# opening.mp3가 끝난 후에만 다음 단계로 진행
4단계: 오박사 등장
오프닝 무비 종료 후 자동 전환:
BGM 전환: professor_oak.mp3
while true; do afplay [skillPath]/data/audio/bgm/professor_oak.mp3 2>/dev/null || break; done
run_in_background: true
순서:
- 오박사 인사 + 포켓몬 세계 소개
- 플레이어 이름 설정 (기본값: 레드)
- 라이벌 이름 설정 (기본값: 그린)
5단계: 게임 시작 (태초마을)
이름 입력 완료 후:
BGM 전환: pallet_town.mp3 (반복 재생)
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 전환 흐름도 (고정)
[타이틀 화면] ─── title_screen.mp3 (반복)
│
│ "시작"
▼
[메뉴 화면] ───── title_screen.mp3 (계속)
│
│ "새 게임"
▼
[오프닝 무비] ─── opening.mp3 (1회, 끝까지 재생)
│
│ 자동 전환
▼
[오박사 등장] ─── professor_oak.mp3
│
│ 이름 입력 완료
▼
[태초마을] ────── pallet_town.mp3 (반복)
주요 BGM 파일명
| 상황 | 파일명 | 재생 방식 |
|---|---|---|
| 타이틀 화면 | title_screen.mp3 | 반복 |
| 오프닝 무비 | opening.mp3 | 1회 |
| 오박사 | professor_oak.mp3 | 반복 |
| 태초마을 | pallet_town.mp3 | 반복 |
| 도로 | route_theme.mp3 | 반복 |
| 야생 전투 | wild_battle.mp3 | 반복 |
| 트레이너 전투 | trainer_battle.mp3 | 반복 |
| 포켓몬 센터 | pokemon_center.mp3 | 반복 |
BGM 재생 규칙
파일 경로: data/audio/bgm/[파일명].mp3
# BGM 중지
pkill -f 'afplay.*pokemon-green' 2>/dev/null
# BGM 재생 (백그라운드 반복)
while true; do afplay [skillPath]/data/audio/bgm/[파일명].mp3 2>/dev/null || break; done
run_in_background: true
에러 처리:
|| break: 파일 없을 시 무한루프 방지2>/dev/null: 에러 메시지 숨김
명령어 체계
필드 명령어
- 북/남/동/서: 해당 방향으로 이동 (예: "북쪽으로")
- [장소명]으로 이동: 특정 장소로 이동 (예: "회색시티로 이동")
- 상태 / 파티: 파티 포켓몬 확인 (예: "상태 확인")
- 가방: 소지품 확인 (예: "가방 열기")
- 도감: 포켓몬 도감 (예: "도감 보기")
- 저장: 게임 저장 (예: "저장")
- 말 걸기: NPC 대화 (예: "말 걸기")
- NPC: NPC 정보 확인 (예: "NPC 목록")
전투 명령어
- 싸운다: 기술 선택 모드
- [기술명] / [번호]: 기술 사용
- 가방: 아이템 사용
- 포켓몬: 포켓몬 교체
- 도망: 야생 전투에서 도망
오디오 명령어
- bgm 끄기: BGM 중지
- bgm 켜기: BGM 재생
- 볼륨 [0-100]: 볼륨 조절
- 울음소리: 포켓몬 울음소리
기술 효과음
효과음 매핑: data/audio/sfx-mapping.json
게임 진행 흐름 (원작 재현)
중요: 스토리 이벤트는 data/world/story-events.json을 참조하여 원작 순서대로 진행합니다.
1장: 오프닝
BGM 흐름 (필수):
- 새 게임 선택 시 →
opening.mp3재생 (오프닝 무비) - 오박사 등장 시 →
professor_oak.mp3로 전환 (오박사 테마) - 오프닝 종료 후 →
pallet_town.mp3로 전환 (태초마을)
이벤트 순서:
- 오박사 인사 + 포켓몬 세계 소개
- 플레이어 이름 설정 (기본값: 레드)
- 라이벌 이름 설정 (기본값: 그린)
2장: 태초마을 - 모험의 시작
- 플레이어 집 2층에서 시작
- 마을 북쪽 풀숲으로 나가려 하면 → 오박사가 멈춤!
- "야생 포켓몬은 위험해! 연구소로 와!"
- 오박사 연구소로 강제 이동
- 스타터 선택 (이상해씨/파이리/꼬부기)
- 라이벌은 플레이어 선택의 상성 우위 포켓몬 선택
- 이상해씨 선택 → 라이벌은 파이리
- 파이리 선택 → 라이벌은 꼬부기
- 꼬부기 선택 → 라이벌은 이상해씨
- 연구소 나가려 하면 → 라이벌 첫 배틀! (Lv.5)
3장: 상록시티 심부름
- 1번도로 통과 (야생 포켓몬 출현)
- 상록시티 포켓몬마트에서 오박사 소포 수령
- 태초마을 오박사 연구소로 귀환
- 소포 전달 → 포켓몬 도감 + 몬스터볼 5개 획득
- (선택) 라이벌 집에서 마을 지도 획득
4장: 회색시티로
- (선택) 22번도로에서 라이벌 2차 배틀 (Lv.9)
- 상록시티 체육관 - 문이 잠겨있음 (뱃지 7개 필요)
- 상록숲 통과 - 벌레 포켓몬, 트레이너
- 회색시티 도착
- 회색시티 체육관 - 웅과 배틀 → 회색뱃지 획득
5장: 달맞이산과 화석
- 3번도로 → 달맞이산 진입
- 달맞이산에서 로켓단 첫 등장
- 과학자와 배틀 후 화석 선택 (조개화석/돔화석)
- 4번도로 → 블루시티 도착
6장: 블루시티와 마사키
- 너겟 브릿지 (24번도로) - 5명 연속 배틀 + 로켓단
- 25번도로 → 마사키의 집
- 마사키 구출 이벤트 → 상트앤느호 티켓 획득
- 블루시티 체육관 - 이슬과 배틀 → 블루뱃지 획득
- (선택) 블루시티 남쪽에서 도둑 로켓단 배틀
7장: 상트앤느호
- 갈색시티로 이동 (5번도로 → 지하통로 → 6번도로)
- 상트앤느호 탑승 (티켓 필요)
- 배 안에서 라이벌 3차 배틀
- 선장에게 등 마사지 → HM01 풀베기 획득
- 배에서 나오면 상트앤느호 출항 (다시 못 탐)
- 갈색시티 체육관 - 쓰레기통 퍼즐 → 마티스와 배틀 → 오렌지뱃지
8장: 로켓단 아지트
- 돌산터널 통과 (플래시 필요) → 보라타운
- 포켓몬타워 - 유령에게 막힘 (실프스코프 필요)
- 무지개시티로 이동 (7번도로)
- 게임코너 포스터 뒤 비밀 스위치 → 로켓단 아지트
- 비주기 1차 배틀 → 실프스코프 획득
- 무지개시티 체육관 - 민화와 배틀 → 레인보우뱃지
9장: 포켓몬타워 구출
- 보라타운 포켓몬타워 재방문 (실프스코프 보유)
- 유령의 정체 = 최루기 영혼 (잡을 수 없음)
- 후지 노인 구출 → 포켓몬 피리 획득
10장: 연보라시티
- 잠만보 깨우기 (12번도로 또는 16번도로)
- 연보라시티 도착
- 사파리존에서 HM03 파도타기 획득
- 연보라시티 체육관 - 독수와 배틀 → 핑크뱃지
11장: 실프주식회사
- 황금시티 - 로켓단 점령 중 (체육관 못 들어감)
- 실프주식회사 진입
- 7층에서 라이벌 4차 배틀
- 11층에서 비주기 2차 배틀
- 실프 사장에게 마스터볼 획득
- 황금시티 체육관 - 초련과 배틀 → 골드뱃지
- (선택) 격투 도장 - 시라소몬/홍수몬 중 선택
12장: 홍련마을
- 파도타기로 홍련마을 이동 (쌍둥이섬 경유)
- 포켓몬저택에서 비밀열쇠 획득
- 홍련마을 체육관 - 강연과 배틀 → 크림슨뱃지
- (선택) 연구소에서 화석 부활
13장: 마지막 뱃지
- 상록시티 체육관 개방 (뱃지 7개 보유 시)
- 비주기 3차 배틀 (체육관 관장) → 그린뱃지 + 로켓단 해산
14장: 포켓몬리그
- (선택) 22번도로 라이벌 최종 배틀 (Lv.47~53)
- 23번도로 뱃지 검사 (8개 필요)
- 챔피언로드 통과
- 석영고원 도착
15장: 사천왕과 챔피언
- 감두 (얼음) → 시바 (격투) → 국화 (고스트) → 목호 (드래곤)
- 챔피언 라이벌 최종 배틀
- 명예의 전당 등록 - 게임 클리어!
엔딩 후
- 하나동굴 개방 (블루시티 북쪽)
- 뮤츠 포획 가능 (Lv.70)
- 전설의 포켓몬: 프리저(쌍둥이섬), 썬더(무인발전소), 파이어(챔피언로드)
스토리 이벤트 로딩
# 특정 챕터 이벤트 로드
jq '.chapter_1.events' data/world/story-events.json
# 특정 이벤트 로드
jq '.chapter_1.events[] | select(.id == "choose_starter")' data/world/story-events.json
# 라이벌 배틀 데이터 로드
jq '.rv.oak_lab' data/world/trainers.json
스토리 플래그 관리
세이브 파일에서 진행 상황을 storyFlags 배열로 관리:
{
"storyFlags": [
"game_started",
"has_starter",
"rival_battle_1_done",
"quest_parcel",
"has_parcel",
"delivered_parcel",
"has_pokedex"
]
}
전투 시스템
오리지널 전투 화면 (1세대 재현)
전투 화면은 원작처럼 간결하게 표시합니다. 불필요한 팁이나 추가 정보 없이 필수 요소만 표시합니다.
스프라이트 표시 규칙 (원작 재현):
- 상대 포켓몬: 13줄 전체 표시 (우측 정렬) - 정면 모습
- 내 포켓몬: 상단 5~6줄만 표시 (좌측, 좌우반전) - 뒷모습 느낌
- pokemon-ascii-mini.json 스프라이트는 13줄 × 28자
- 내 포켓몬은 좌우반전 후 상단만 잘라서 표시
전투 화면 구성:
╔════════════════════════════════════════════════════════════════╗
║ 야생 Pokemon Lv.5 ║
║ ▓▓▓▓▓▓▓▓▓▓░░░░ HP ║
║ ║
║ [상대 포켓몬 스프라이트] ║
║ (13줄 전체 - 우측 정렬) ║
║ (정면 모습) ║
║ ║
║ [내 포켓몬 - 뒷모습] ║
║ (상단 5~6줄만 - 좌측) ║
║ (좌우반전, 아래쪽 잘림) ║
║ ║
║ Pokemon Lv.5 ║
║ ▓▓▓▓▓▓▓▓▓▓▓▓▓░░ HP 22/22 ║
╠════════════════════════════════════════════════════════════════╣
║ 야생 Pokemon(이/가) 나타났다! ║
╠════════════════════════════════════════════════════════════════╣
║ 싸운다 가방 ║
║ 포켓몬 도망 ║
╚════════════════════════════════════════════════════════════════╝
실제 전투 화면 예시:
╔════════════════════════════════════════════════════════════════╗
║ 야생 피카츄 Lv.5 ║
║ ▓▓▓▓▓▓▓▓▓▓░░░░ HP ║
║ ║
║ :. :+=. ║
║ .**. . .-*#**#- ║
║ -*: =*+::-+#***+- ║
║ .-*##%#+-:#%#+=+**+*+- ║
║ =%%#########- .=***-. ║
║ =%*#%#*+.:%%#*- -*#= ║
║ .=*#%%#*++*##%%*..+=: ║
║ .:.:+#*%#+=#%##*+=-: ║
║ :**==+*=+%%#=.. ║
║ :+*+++#%#%*: ║
║ .++*%*. ║
║ : ║
║ ║
║ : : ║
║ ++=*. ║
║ .-+-+--==.. ║
║ .-+*+==+-=++=++: ║
║ :++==+++++=-+=-=-:..== ║
║ :+=-=+==++--=---:-+**#+ ║
║ ║
║ 이상해씨 Lv.5 ║
║ ▓▓▓▓▓▓▓▓▓▓▓▓▓░░ HP 22/22 ║
╠════════════════════════════════════════════════════════════════╣
║ 야생 피카츄(이/가) 나타났다! ║
╠════════════════════════════════════════════════════════════════╣
║ 싸운다 가방 ║
║ 포켓몬 도망 ║
╚════════════════════════════════════════════════════════════════╝
메시지 표시 원칙 (원작 준수)
표시하는 것 (원작과 동일):
표시하지 않는 것 (원작에 없음):
- 데미지 숫자 (HP 바 감소로만 표현)
- 타입 상성 힌트/추천
- 기술 선택 팁
- 전술 조언
- AI의 행동 예측
ASCII 아트 표시
- 전투 시작: pokemon-ascii.json (전체 아트 1회)
- 전투 진행 중: pokemon-ascii-mini.json (축소 아트)
- 도감: pokemon-ascii.json (전체 아트)
데미지 계산 (1세대)
데미지 = ((2×Lv÷5+2) × Power × A÷D ÷ 50 + 2) × STAB × 상성 × 급소 × 난수
1세대 버그 재현
- 에스퍼 vs 고스트: 0배
- 포커스 에너지: 급소율 감소
- 독 vs 벌레: 2배
NPC 시스템
NPC 스프라이트 로딩 규칙
로딩 순서 (필수!)
data/sprites/npc-mapping.json에서 한글→영문 변환data/sprites/npc_ascii/[영문명].json파일 로드.down키의 ASCII 아트 표시
jq 로딩 예시
# 스프라이트 로드 (한글 이름으로 직접 로드 불가!)
jq -r '.down | join("\n")' data/sprites/npc_ascii/Professor_Oak.json
주요 NPC 영문 파일명
| 한글명 | 파일명 | 카테고리 |
|---|---|---|
| 오박사 | Professor_Oak.json | 스토리 NPC |
| 간호순 | Nurse_Joy.json | 시설 NPC |
| 라이벌 | Rival.json | 챔피언 |
| 웅 | Brock.json | 체육관 관장 |
| 이슬 | Misty.json | 체육관 관장 |
에러 처리
- 파일 없음: 스프라이트 생략, 대화만 표시
- JSON 파싱 실패: 기본 텍스트로 대체
대화 화면 예시
┌────────────────────────────────────┐
│ [NPC 스프라이트] │
│ │
│ 간호순: │
│ "어서오세요! 포켓몬센터입니다." │
├────────────────────────────────────┤
│ [1] 네 [2] 아니오 │
└────────────────────────────────────┘
세이브 시스템
저장
- 수동 저장: "저장" 또는 "저장 [슬롯번호]"
- 자동 저장: 포켓몬 센터, 도시 진입, 전투 후
세이브 슬롯 (10개 + 자동저장)
- 저장 [1-10]: 특정 슬롯에 저장
- 불러오기 [1-10]: 특정 슬롯 불러오기
- 세이브 목록: 모든 슬롯 확인
체육관 정보
- 회색시티 - 웅 (바위) → 회색뱃지
- 블루시티 - 이슬 (물) → 블루뱃지
- 갈색시티 - 마티스 (전기) → 오렌지뱃지
- 무지개시티 - 민화 (풀) → 레인보우뱃지
- 연보라시티 - 독수 (독) → 핑크뱃지
- 황금시티 - 초련 (에스퍼) → 골드뱃지
- 홍련마을 - 강연 (불꽃) → 크림슨뱃지
- 상록시티 - 비주기 (땅) → 그린뱃지
데이터 파일 참조
포켓몬 데이터
- data/pokemon/species.json: 151마리 종족 데이터
- data/pokemon/learnsets.json: 레벨업 기술
- data/pokemon/evolutions.json: 진화 조건
기술/타입 데이터
- data/moves/moves.json: 165개 기술
- data/types/chart.json: 15타입 상성표
월드 데이터
- data/world/locations.json: 마을/도로
- data/world/encounters.json: 야생 출현
- data/world/trainers.json: 트레이너
오디오 데이터
- data/audio/bgm-mapping.json: 45곡 BGM 매핑
- data/audio/cries-mapping.json: 151마리 울음소리
ASCII 아트
- data/sprites/pokemon-ascii.json: 전체 아트
- data/sprites/pokemon-ascii-mini.json: 축소 아트
- data/sprites/npc_ascii/: NPC 축소 아트 (94개 개별 파일)
- data/sprites/npc-mapping.json: NPC 한글→파일명 매핑
데이터 키 매핑 (최적화 형식)
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
타입코드: 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
카테고리: P=Physical, S=Special, X=Status
learnsets.json
lv=levelUp[[level,move]], tm=[번호], hm=[번호]
encounters.json
g=grass, c=cave, w=water, f=fishing
포맷: [[포켓몬ID, minLv, maxLv, 출현율]]
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
카테고리: pb=pokeballs, pt=potions, sh=statusHealers, rv=revives, pp=ppItems
bt=battleItems, rp=repels, es=escapeItems, ev=evolutionStones, vi=vitamins
데이터 로딩
jq로 필요한 부분만 추출 (대용량 파일 전체 로드 금지)
jq '.["25"]' data/pokemon/species.json # 종족값
jq '.["025"]' data/sprites/pokemon-ascii.json # 스프라이트 (3자리)
키 형식:
- species, learnsets: 숫자 키 ("25")
- sprites: 3자리 키 ("025")
References (상세 가이드)
상세한 시스템 정보는 다음 문서를 참조하세요:
- BGM 시스템 가이드 (references/bgm-guide.md) - BGM 자동재생, 명령어, 이벤트 매핑
- 기술 효과음 가이드 (references/sfx-guide.md) - 기술별 효과음, 다운로드 방법
- ASCII 아트 가이드 (references/ascii-guide.md) - ASCII 아트 사용 규칙, 데이터 파일
- NPC 시스템 가이드 (references/npc-guide.md) - NPC 스프라이트 표시, 이름 매핑
- 울음소리 가이드 (references/cries-guide.md) - 울음소리 재생 시점, 명령어
- 데이터 무결성 가이드 (references/data-integrity.md) - 데이터 검증 규칙, 체크리스트
언어 설정
이 스킬은 한국어 전용입니다.
영어 버전은 별도 스킬 pokemon-green-en을 사용하세요.
데이터 파일 구조
모든 이름/메시지는 한국어 단일 언어로 저장됩니다:
{
"name": "이상해씨",
"text": "야생 포켓몬이 나타났다!"
}
메시지 파일:
- data/messages/battle.json - 전투 메시지
도움말
게임 중 언제든지 다음 명령어를 사용할 수 있습니다:
- "도움말" - 명령어 목록
- "현재 위치" - 현재 장소 정보
- "진행 상황" - 스토리 진행도
Sponsors
Details
- Marketplace
- dev-jelly/pokemon-skills
- Source
- .claude/skills/pokemon-green-ko
- Category
- Entertainment