Mandir Jumper: Amazon Q CLI와 Pygame으로 만든 수직 점프 게임 개발 기록

카테고리

프로그래밍/소프트웨어 개발

서브카테고리

앱 개발

대상자

• 초보 개발자, 게임 개발에 관심 있는 학습자, Python/Pygame을 활용한 프로젝트 기획자
• 난이도: 초보자 중심, 도구 활용 중심의 설명

핵심 요약

• Amazon Q CLI와 Pygame을 사용해 Nepali 문화를 반영한 수직 점프 게임 개발 가능
• 자동 오르기(Auto Climbing), 벽 점프(Wall Jumping), 문화적 아이템(Chiyaa, Prayer Wheel) 등 주요 기능 구현
• Python 3.11과 Pygame을 기반으로 한 간단한 프로젝트 구조 및 빠른 배포 절차 제공

섹션별 세부 요약

1. 게임 개요

• 세로 화면의 단일 입력 게임: 네팔 전사가 절벽을 오르며 적과 피아를 피하고 문화 아이템 수집
• 점수 시스템: 오른 높이 기반, 세션 고기록 기능 포함
• 모바일 스타일 레이아웃: 400x700 해상도로 가로 여백 없음

2. 사용 도구 및 기술 스택

• Amazon Q CLI: AI 기반 코드 생성, 디버깅, 디자인 지원
• Python 3.11: 주요 언어
• Pygame: 게임 렌더링 및 로직 처리
• VS Code: 개발 및 테스트

3. 게임 구현 과정

• 플레이어 이동: "SPACE 입력 시 좌우 점프" 기능 생성
• 적 생성: Flying crows 및 Spinning khukuris 수평 이동
• 보너스 아이템: Chiyaa(속도 증가), Prayer Wheel(무적 효과) 추가
• 점수 시스템: 높이 기반 점수 계산, 세션 고기록 저장

4. 개발 중 겪은 문제 및 해결

• 프레임 렝(Stuttery): "60 FPS 유지" 요청으로 즉시 해결
• 화면 오류(White Triangle): 배경 요소 제거 요청으로 해결
• 배경 이미지 틀림: "화면 가득 확대" 요청으로 수정

5. 프로젝트 구조

• mandir_jumper.py: 게임 로직
• requirements.txt: Pygame 의존성
• README.md: 게임 설명 및 실행 방법
• .bashrc: 환경 설정 파일

6. 실행 방법

• 설치: pip install pygame 및 pip install -r requirements.txt
• 실행: python mandir_jumper.py
• 조작: SPACE 또는 클릭으로 점프, R 키로 재시작

7. 문화적 영감

• Mandir(절벽), Khukuri(전통 칼), Chiyaa(차), Prayer Wheel(기도 휠) 등 네팔 문화 요소 반영

8. 향후 개선 방향

• 새로운 적 추가(절벽 수비병, 사자)
• 보너스 아이템 확장(더블 점프, 시간 지연)
• 애니메이션 배경(구름, 기도 깃발)
• 모바일 터치 제어 및 음향 효과 추가

결론

• Amazon Q CLI의 강력한 자동 생성 기능과 Pygame의 간단한 API를 활용해 초보자도 게임 개발 가능
• 명확한 요구사항 정의와 도구의 적절한 사용이 성공의 핵심
• 문화적 요소 통합을 통해 차별화된 게임 개발 가능
• "간단한 아이디어를 구체화하는 데 도움을 줄 수 있는 도구"로 활용 가능