| 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 |
재생 명령어
pkill -f 'afplay.*pokemon-green' 2>/dev/null
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번 도로 → 상록시티 → 상록숲 → 회색시티 (첫 체육관)
- 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 스프라이트 로딩 규칙
로딩 순서 (필수!)
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
키 형식:
- 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 - 전투 메시지
도움말
게임 중 언제든지 다음 명령어를 사용할 수 있습니다:
- "도움말" - 명령어 목록
- "현재 위치" - 현재 장소 정보
- "진행 상황" - 스토리 진행도
