pokemon-green-ko

name	pokemon-green-ko
description	포켓몬 그린 버전 텍스트 RPG. 1세대 151마리 포켓몬, 165개 기술, 관동 지방 완전 재현. 한국어 전용. 사용자가 '포켓몬', '피카츄', '전투', '체육관', '야생', '도감', '새 게임', '이어하기' 등의 키워드를 사용할 때 활성화됩니다. (project)
trigger-keywords	포켓몬, 피카츄, 체육관, 전투, 야생, 도감, 포켓몬스터, 새 게임, 이어하기, 포켓몬 그린
allowed-tools	Read, Write, Edit, Bash

포켓몬 그린 버전 - 텍스트 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

BGM 재생 규칙

파일 경로: data/audio/bgm/[파일명].mp3

주요 BGM 파일명

상황	파일명
오프닝	opening.mp3
태초마을	pallet_town.mp3
오박사 연구소	oak_lab.mp3
도로	route_theme.mp3
야생 전투	wild_battle.mp3
트레이너 전투	trainer_battle.mp3
포켓몬 센터	pokemon_center.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

---

게임 진행 흐름

오프닝

1. 오박사 인사
2. 플레이어 이름 설정
3. 라이벌 이름 설정

태초마을

1. 오박사 연구소에서 스타터 선택 (이상해씨/파이리/꼬부기)
2. 라이벌과 첫 배틀
3. 상록시티 소포 심부름

모험 시작

• 1번 도로 → 상록시티 → 상록숲 → 회색시티 (첫 체육관)
• 8개 뱃지 수집 → 챔피언 로드 → 사천왕 → 챔피언

---

전투 시스템

오리지널 전투 화면 (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 스프라이트 로딩 규칙

로딩 순서 (필수!)

1. data/sprites/npc-mapping.json에서 한글→영문 변환
2. data/sprites/npc_ascii/[영문명].json 파일 로드
3. .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]: 특정 슬롯 불러오기
• 세이브 목록: 모든 슬롯 확인

---

체육관 정보

1. 회색시티 - 웅 (바위) → 회색뱃지
2. 블루시티 - 이슬 (물) → 블루뱃지
3. 갈색시티 - 마티스 (전기) → 오렌지뱃지
4. 무지개시티 - 민화 (풀) → 레인보우뱃지
5. 연보라시티 - 독수 (독) → 핑크뱃지
6. 황금시티 - 초련 (에스퍼) → 골드뱃지
7. 홍련마을 - 강연 (불꽃) → 크림슨뱃지
8. 상록시티 - 비주기 (땅) → 그린뱃지

---

데이터 파일 참조

포켓몬 데이터

• 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 - 전투 메시지

---

도움말

게임 중 언제든지 다음 명령어를 사용할 수 있습니다:

• "도움말" - 명령어 목록
• "현재 위치" - 현재 장소 정보
• "진행 상황" - 스토리 진행도