[프로젝트] 🐢Turtle Run Game - Python 터틀 그래픽(Turtle Graphic) 게임 제작 (1탄)

개요

터틀런 게임은 Python의 turtle 모듈을 사용하여 만든 간단한 아케이드 게임입니다. 플레이어는 초록색 거북이를 조종하여 점수를 획득하고, 적 거북이를 피해야 합니다. 노란색과 하얀색 코인을 수집하면 각각 2점과 1점을 얻을 수 있습니다. 적 거북이와 충돌하면 게임이 종료됩니다.
한양대학교(ERICA) 파이썬 프로그래밍 과목의 과제로 진행하였습니다.

주요 기능

• 플레이어 조작: 방향키를 사용하여 플레이어 거북이의 방향을 조정할 수 있습니다.
• 코인 수집: 노란색과 하얀색 코인을 수집하여 점수를 획득합니다. 노란색 코인은 2점, 하얀색 코인은 1점을 제공합니다.
• 속도 증가: 점수가 10점씩 오를때마다 적 거북이의 속도가 증가합니다.
• 적 거북이 회피: 적 거북이와 충돌하지 않도록 피해야 합니다.
• 게임 종료 및 재시작: 게임이 종료되면 최종 점수가 화면에 표시되고, 스페이스바를 눌러 게임을 다시 시작할 수 있습니다.
• 배경 음악: 게임이 시작될 때 배경음악이 재생됩니다.

시스템 요구 사항

• Windows. Mac 환경 모두 지원
• Python 3.13 이상
• pygame
• PyInstaller (배포할 때 필요)

플레이 영상

Youtube : https://youtu.be/04S8M8CaDhQ

플레이 화면

설치 및 실행 방법

1. Python 및 라이브러리 설치

먼저 Python 3.6 이상이 설치되어 있어야 합니다. 터미널(또는 명령 프롬프트)에서 다음 명령어로 pygame과 turtle 모듈을 설치합니다.

pip install pygame

혹은

pip3 install pygame

게임 실행

python turtle_run_ois.py

배포

pyinstaller turtle_run_ois.spec

dist 폴더에 생성된 실행 파일(.exe 또는 .app)을 배포할 수 있습니다.
(※ 주의 : exe는 윈도우에서만, app은 mac에서만 빌드 가능합니다)

게임 플레이 방법

1. 게임이 시작되면 플레이어의 속도, 적 거북이의 속도 및 숫자, 코인의 개수를 입력합니다.
2. 방향키를 사용하여 초록색 플레이어 거북이를 조종합니다:
   • ⬆️(위쪽 화살표): 위로 이동
   • ⬇️(아래쪽 화살표): 아래로 이동
   • ⬅️(왼쪽 화살표): 왼쪽으로 이동
   • ➡️(오른쪽 화살표): 오른쪽으로 이동
3. 노란색과 하얀색 코인을 수집하여 점수를 얻고, 적 거북이와 충돌하지 않도록 피하세요.
4. 적 거북이와 충돌하면 게임이 종료되며, 최종 점수가 화면에 표시됩니다.
5. 게임 종료 후 스페이스바를 눌러 게임을 다시 시작할 수 있습니다.

파일 구조

• turtle_run_ois.py: 게임의 메인 소스 코드.
• BGM.mp3: 게임의 배경음악 파일.
• app_icon.icns: macOS 앱 아이콘 파일.
• dist/: PyInstaller로 빌드된 실행 파일이 저장되는 폴더.
• build/: PyInstaller의 임시 빌드 파일이 저장되는 폴더.
• .spec 파일: PyInstaller 설정 파일.

게임 설정 및 옵션

게임 시작 시 다음과 같은 설정을 입력할 수 있습니다:

• 나의 속도: 플레이어 거북이의 이동 속도를 설정합니다 (1 ~ 20).
• 적의 숫자: 적 거북이의 수를 설정합니다 (1 ~ 10).
• 적의 속도: 적 거북이의 속도를 설정합니다 (1 ~ 20).
• 보물의 개수: 화면에 등장할 코인의 수를 설정합니다 (1 ~ 10).

주의사항

• macOS에서 처음 실행할 경우 앱이 실행될 때 보안 경고가 나타날 수 있습니다. 이 경우, 시스템 환경설정 > 보안 및 개인정보 보호에서 앱을 허용해 주세요.
• 배경음악 파일과 아이콘 파일이 같은 폴더에 있어야 합니다.

문의

궁금한 사항이나 버그 리포트가 있을 경우, 프로젝트 관리자에게 연락해 주세요.

그럼 재밌게 즐겨주세요~!!!!🥰🥰

배경음악 출처

BGM.mp3 -> Hawaii Five O Theme Song Full Version(https://www.youtube.com/watch?v=bHxqcwRwt80)