Post

Creating a Yootnori Game Using Python and Pygame

Posted
By Doorimul-KJH
views 27 min read
Creating a Yootnori Game Using Python and Pygame

Pygame을 이용해 윷놀이 게임 만들기

이미지

Step 0. 사전 준비사항(개발환경)

  • macOS: Apple Silicon M2 Max, Sonoma 14.5.1
  • Git 설치: Homebrew 사용 권장
  • VS Code 설치: Python 코드 작성용 편집기
  • GitHub 계정: 코드 공유 및 백업을 위해 GitHub 계정이 필요합니다.
  • 기본 셸: zsh 사용 (macOS 기본 셸 설정)

Step 0-1. VS Code에 Python 환경 설정하기

  1. Python 설치: Python 3.12 이상 버전을 사용합니다. Python 공식 사이트에서 최신 버전을 다운로드하여 설치하였습니다.

  2. VS Code 확장 프로그램 설치:
    • VS Code에서 Python 확장을 설치하였습니다. 이 확장은 Python 코드를 쉽게 작성하고 디버깅할 수 있게 해줍니다.
    • Command Palette를 열려면 Cmd + Shift + P를 누르고, “Python: Select Interpreter”를 선택하여 설치된 Python 3.12 버전을 선택하였습니다.
  3. Pygame 설치:
    • Pygame 라이브러리는 터미널에서 아래 명령어로 설치하였습니다.
    1

    pip install pygame==2.6.1
  4. 설치 확인:
    • Python 및 Pygame이 제대로 설치되었는지 확인하기 위해 터미널에 아래 명령어를 입력하였습니다.
    1
2

    python --version
pip show pygame

    Python 버전이 3.12 이상인지, Pygame 버전이 2.6.1인지 확인하였습니다.

Step 1. 윷놀이 게임 설명

윷놀이는 한국 전통 보드 게임으로, 최소 2명에서 최대 4명까지 플레이할 수 있습니다. 각 플레이어는 4개의 말을 가지고 있으며, 목적은 모든 말을 상대보다 먼저 도착 지점까지 이동시키는 것입니다.

  • 플레이어 수: 최소 2명, 최대 4명.
  • 말의 개수: 각 플레이어당 4개의 말.
  • 윷 던지기 규칙:
    • 윷은 네 개의 막대로 이루어져 있으며, 결과에 따라 도, 개, 걸, 윷, 모가 나옵니다.
    • 모나 윷이 나오면 플레이어는 한 번 더 윷을 던질 수 있습니다.
    • 상대 말을 잡으면 플레이어는 추가로 한 번 더 윷을 던질 수 있습니다.
  • 말 업기: 같은 플레이어의 말들이 같은 위치에 있을 경우 함께 움직일 수 있습니다.
  • 방향 선택:
    • 양쪽 위 꼭짓점과 가운데 점에서는 플레이어가 말의 이동 방향을 선택할 수 있습니다.
    • 이는 전략적으로 중요한 부분으로, 빠르게 이동하거나 상대 말을 잡기 위한 최적의 경로를 선택하는 데 도움이 됩니다.

Step 2. 윷 던지기 함수 및 확률

윷 던지기는 4개의 윷가락을 던져 그 결과로 이동 거리를 결정합니다. 각 윷가락은 평평한 면 또는 둥근 면이 나올 수 있으며, 각 면이 나올 확률은 다릅니다.

아래 코드는 윷 던지기 기능을 구현한 것입니다:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

import random

# 윷 던지기 함수 정의
def throw_yoot():
    # 윷가락의 면 결정 (평평한 면 = True, 둥근 면 = False)
    # 평평한 면의 확률은 60%, 둥근 면의 확률은 40%로 설정되어 있습니다.
    sticks = [random.choices([True, False], weights=[60, 40])[0] for _ in range(4)]
    
    # 네 개의 윷가락 중 평평한 면이 나온 개수를 계산합니다.
    flat_count = sticks.count(True)

    if flat_count == 4:
        return "윷"  # 윷: 네 개 모두 평평한 면
    elif flat_count == 0:
        return "모"   # 모: 네 개 모두 둥근 면
    elif flat_count == 3:
        return "걸"  # 걸: 세 개가 평평한 면
    elif flat_count == 2:
        return "개"  # 개: 두 개가 평평한 면
    elif flat_count == 1:
        # 도: 한 개만 평평한 면일 때 1/4 확률로 백도
        if random.random() < 0.25:
            return "백도"
        else:
            return "도"
  • 확률 설명:
    • 윷놀이의 재미와 전통적인 확률을 반영하기 위해 평평한 면은 60%, 둥근 면은 40%의 확률로 설정하였습니다.
    • 이 설정은 실제 윷놀이의 물리적인 특성과 유사한 확률을 제공합니다. 평평한 면이 더 많이 나올 확률이 높은 이유는 실제 윷놀이에서 평평한 면이 더 무거워 바닥에 깔리기 쉽기 때문입니다.
    • 윷 (4개 평평한 면): 네 개의 윷가락이 모두 평평한 면이 나올 확률입니다.
    • 모 (4개 둥근 면): 네 개의 윷가락이 모두 둥근 면이 나올 확률입니다.
    • 걸, 개, 도는 각각 평평한 면의 개수에 따라 결정됩니다.
    • 백도는 도의 특별한 경우로, 1/4 확률로 뒤로 한 칸 가는 결과가 나옵니다. 이는 게임의 변수 요소로, 예기치 않은 반전을 제공하여 게임의 긴장감을 높였습니다.

Step 3. 윷판 그리는 방법

윷판은 게임의 주요 구성 요소로, 플레이어들이 말을 이동하는 경로를 시각적으로 표시해줍니다. 아래 코드는 윷판을 Pygame으로 그리는 방법을 설명하겠습니다. 이미지

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

# 윷 판 테두리 생성
for i in range(1, 21):
    if i < 6:
        ypos -= button_interval  # 상단에서 위쪽 방향으로 이동
    elif i < 11:
        xpos -= button_interval  # 왼쪽으로 이동
    elif i < 16:
        ypos += button_interval  # 하단으로 이동
    else:
        xpos += button_interval  # 오른쪽으로 이동

    # 특정 위치에 큰 원 표시 (윷판의 꼭짓점 및 시작점)
    if i == 5 or i == 10 or i == 15:
        img = bigcircle_img
    elif i == 20:
        img = startcircle_img
    else:
        img = circle_img

    # 버튼의 위치와 이미지 정의
    button_rect = img.get_rect(center=(xpos, ypos))
    pan_buttons.append((img, button_rect))
    board_pos.append((xpos, ypos))

# 첫 번째 대각선 그리기
xpos = button_size_x * 7 - 10
ypos = button_size_y - 10
for p in range(6):
    if p == 3:
        xpos -= button_size_x
        ypos += button_size_y
    else:
        if p == 0:
            xpos -= button_size_x
            ypos += button_size_y
        else:
            button_rect = circle_img.get_rect(center=(xpos, ypos))
            pan_buttons.append((circle_img, button_rect))
            board_pos.append((xpos, ypos))

            xpos -= button_size_x
            ypos += button_size_y

# 두 번째 대각선 그리기
xpos = button_size_x - 10
ypos = button_size_y - 10
for p in range(6):
    if p == 0:
        xpos += button_size_x
        ypos += button_size_y
    else:
        if p == 3:
            img = bigcircle_img
        else:
            img = circle_img

        button_rect = img.get_rect(center=(xpos, ypos))
        pan_buttons.append((img, button_rect))
        board_pos.append((xpos, ypos))

        xpos += button_size_x
        ypos += button_size_y
  • 코드 설명:
    • 테두리 생성:
      • for i in range(1, 21) 반복문은 윷판의 테두리를 순서대로 그리기 위한 것입니다.
      • 각 반복에서 xpos와 ypos를 조정하여 상단, 좌측, 하단, 우측으로 이동하면서 윷판의 테두리를 그렸습니다.
      • 특정 위치(i == 5, i == 10, i == 15, i == 20)에서는 특수 이미지 (bigcircle_img 또는 startcircle_img)를 사용하여 시작점과 주요 지점을 표시하였습니다.
    • 대각선 경로 추가:
      • 첫 번째 대각선과 두 번째 대각선을 그리기 위해 각각 별도의 반복문을 사용하였습니다.
      • 대각선 경로는 윷놀이에서 특수한 이동 경로로, 이를 통해 플레이어들이 지름길을 선택하여 빠르게 도착 지점으로 이동할 수 있도록 하였습니다.
      • 각 대각선의 중간 지점(p == 3)에는 큰 원(bigcircle_img)을 사용하여 방향 변경 지점을 강조하였습니다.

위의 코드를 통해 전통적인 윷판의 모양을 Pygame으로 구현하고, 말들이 이동할 경로를 설정하였습니다. 테두리와 대각선 경로를 명확히 정의하여 플레이어들이 이동할 수 있는 각 위치를 직관적으로 나타내도록 설계하였습니다.

Step 4. 윷놀이에 필요한 이미지 로드

윷놀이를 구현하기 위해서는 다양한 이미지가 필요합니다. 아래 코드는 게임에 필요한 이미지를 Pygame으로 로드하는 과정에 대해 설명하겠습니다.

사용된 이미지

  • 이미지 이미지 이미지 이미지 이미지 이미지
  • 이미지 이미지 이미지 이미지 이미지 이미지
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39

circle_img = pygame.image.load(os.path.join(img_path, "circle.jpg"))
bigcircle_img = pygame.image.load(os.path.join(img_path, "bigcircle.jpg"))
startcircle_img = pygame.image.load(os.path.join(img_path, "startcircle.jpg"))
line_img = pygame.image.load(os.path.join(img_path, "line.png"))

bigorange_img = pygame.image.load(os.path.join(img_path, "bigorange.png"))
orange_img = pygame.image.load(os.path.join(img_path, "orange.png"))

# 말 이미지 로드 (파란색, 초록색, 빨간색, 노란색)
bigblue_img = [
    pygame.image.load(os.path.join(img_path, f"bigblue{i}.jpg")) for i in range(1, 5)
]
blue_img = [
    pygame.image.load(os.path.join(img_path, f"blue{i}.jpg")) for i in range(1, 5)
]

biggreen_img = [
    pygame.image.load(os.path.join(img_path, f"biggreen{i}.jpg")) for i in range(1, 5)
]
green_img = [
    pygame.image.load(os.path.join(img_path, f"green{i}.jpg")) for i in range(1, 5)
]

bigred_img = [
    pygame.image.load(os.path.join(img_path, f"bigred{i}.jpg")) for i in range(1, 5)
]
red_img = [
    pygame.image.load(os.path.join(img_path, f"red{i}.jpg")) for i in range(1, 5)
]

bigyellow_img = [
    pygame.image.load(os.path.join(img_path, f"bigyellow{i}.jpg")) for i in range(1, 5)
]
yellow_img = [
    pygame.image.load(os.path.join(img_path, f"yellow{i}.jpg")) for i in range(1, 5)
]

select_big_img = pygame.image.load(os.path.join(img_path, "bigorange.png"))
select_img = pygame.image.load(os.path.join(img_path, "orange.png"))

설명:

  • 기본 이미지 로드:
    • circle_img, bigcircle_img, startcircle_img, line_img 등은 윷판에서 사용하는 기본적인 원과 라인의 이미지로, 윷놀이 판에 표시되는 각기 다른 지점들을 시각적으로 구분하기 위해 사용하였습니다.
  • 색깔별 말 이미지 로드:
    • 파란색(blue_img), 초록색(green_img), 빨간색(red_img), 노란색(yellow_img) 말 이미지를 각 플레이어에게 할당하였습니다. 각 플레이어의 말은 작은 말(blue_img, green_img, 등)과 큰 말(bigblue_img, biggreen_img, 등)으로 나뉘어져 있으며, 큰 말은 특정 조건에서 업힐 때 사용되었습니다.
  • 리스트 활용:
    • 각 말의 이미지는 리스트로 관리하여, 각각의 플레이어가 사용하는 4개의 말을 쉽게 접근하고 관리할 수 있도록 하였습니다. 이 방식을 사용하면 코드의 반복을 줄이고, 말의 상태를 쉽게 업데이트할 수 있습니다.

Step 5. 윷놀이에 필요한 버튼 생성

게임 플레이를 위해 다양한 버튼이 필요합니다. 아래 코드는 윷놀이에 필요한 버튼을 생성하는 방법에 대해 설명하겠습니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

# 윷 던지기 버튼 생성
throw_button_rect = pygame.Rect(button_size_x * 9, button_size_y * 10, button_size_x * 3, button_size_y)
throw_button_color = YELLOW

# 윷 던지기 선택 효과 생성
throw_new_rect = pygame.Rect(button_size_x * 9, button_size_y * 10, button_size_x * 3, button_size_y)
throw_new_color = ORANGE

# 새로운 말 버튼 생성
new_piece_button_rect = pygame.Rect(button_size_x * 9, button_size_y * 11, button_size_x * 3, button_size_y)
new_piece_button_color = LIGHT_BLUE

# 새로운 말 선택 효과 생성
select_new_button_rect = pygame.Rect(button_size_x * 9, button_size_y * 11, button_size_x * 3, button_size_y)
select_new_button_color = ORANGE

# 윷 판 클릭 버튼 생성
pan_click_button_rect = pygame.Rect(button_size_x * 9, button_size_y * 9, button_size_x * 3, button_size_y)
pan_click_button_color = LIGHT_BLUE

설명:

  • 버튼 생성 방법:
    • pygame.Rect()를 사용하여 버튼의 위치와 크기를 지정하였습니다. 예를 들어 throw_button_rect는 윷 던지기 버튼으로, (button_size_x * 9, button_size_y * 10, button_size_x * 3, button_size_y)의 좌표와 크기를 가지도록 설정하였습니다.
  • 색상 설정:
    • 각 버튼에는 특정한 색상을 부여하여 시각적인 구분을 명확히 하였습니다. 예를 들어, 윷 던지기 버튼에는 노란색(YELLOW)이 사용되었습니다. 이는 사용자가 쉽게 인지할 수 있도록 시각적으로 구분된 색상을 부여한 것입니다.
  • 선택 효과 버튼 생성:
    • 버튼을 선택했을 때의 효과를 제공하기 위해 선택 효과 버튼(throw_new_rect, select_new_button_rect)도 별도로 생성하였습니다. 이를 통해 버튼이 선택된 상태와 그렇지 않은 상태를 쉽게 구분할 수 있도록 하였습니다.
  • 새로운 말 버튼:
    • 새로운 말을 게임에 추가할 수 있는 버튼(new_piece_button_rect)을 생성하였습니다. 이 버튼은 사용자가 윷을 던진 후 새로운 말을 판에 올릴 때 사용하는 버튼입니다.

Step 6. 윷놀이 게임 알고리즘

윷놀이의 말 이동을 위한 게임 알고리즘은 복잡한 윷판의 경로를 구현하기 위해 여러 가지 방식으로 구현할 수도 있습니다. 여기서는 이중 연결 리스트와 딕셔너리를 이용한 두 가지 방법을 소개하겠습니다.

첫 번째 방법: 이중 연결 리스트로 구현

  • 윷판의 경로를 이중 연결 리스트로 구현하는 방법이 있습니다. 각 노드는 윷놀이 판의 특정 위치를 나타내며, 각 노드는 전 노드와 다음 노드를 가리키는 포인터를 가지도록 해야합니다.
  • 말 이동:
    • 윷을 던진 후 나온 값만큼 현재 노드에서부터 하나씩 이동하도록 구현하는 것이 좋습니다.
    • 예를 들어, 주사위 값이 3이라면 현재 노드에서부터 1씩 주사위 값을 소모하며 이동하는 것입니다.
  • 특수한 노드 처리:
    • 노드 번호가 5, 10, 22일 경우 특수한 이동 경로가 존재하여, 남은 주사위 값이 1 이상일 때 다음 특수한 노드로 이동하게 구현하는 것이 좋습니다.
    • 주사위 값이 -1(백도)인 경우, 현재 위치에서 이전 노드로 이동하였습니다. 단, 왼쪽 하단 꼭짓점의 경우 말이 어느 방향으로부터 왔는지 확인해야합니다.
  • shortway 값:
    • 룰에 따라 각 말의 shortway 값을 사용하여 특수한 경로를 선택할 수 있도록 구현해야할 수도 있습니다. 자동으로 지름길로 말이 이동할 것인지, 플레이어가 선택하게 할 것인지 고려해야합니다. 만약, 플레이어가 선택할 수 있도록 한다면 말의 속성 값 중 shortway를 변경해야합니다. (변수 명은 자유)

두 번째 방법: 딕셔너리로 구현(이O윤 교수님 아이디어)

  • 딕셔너리 사용:
    • 윷판의 각 노드를 딕셔너리로 표현하고, 해당 노드에서 나올 수 있는 모든 결과를 딕셔너리에 저장할 수 있습니다.
    • 예를 들어, 3번 노드에서 개가 나온 경우, 딕셔너리는 {'3번 노드': {'도': 4, '개': 5, '걸': 6, '윷': 7, '모': 8}} 형태로 정의할 수 있습니다.
    • 이러한 방식을 채택하면 모든 경우의 수를 미리 정의하여 윷놀이의 특수항 경우 까지 간단하게 처리할 수 있는 장점이 있습니다.
  • 특수한 경우 처리:
    • 꼭짓점과 중심점과 같은 특수한 위치에서의 이동을 미리 정의하여, 사용자가 특수한 위치에 도달했을 때의 이동 경로를 딕셔너리를 통해 즉시 확인할 수 있도록 하였습니다.

Step 7. 윷놀이 프로젝트를 하며 내가 느낀 애자일의 장점과 단점

이번 프로젝트를 진행하며 애자일 방식의 장점과 단점을 직접적으로 체감할 수 있었습니다. 팀의 상황과 각 멤버의 역량에 따라 애자일 방식이 큰 장점으로 작용하기도 했고, 때로는 한계를 느끼기도 했습니다.

애자일의 장점

  1. 개발 속도의 증가: 팀원들의 개발 실력이 비슷하거나, 각자가 잘하는 분야가 다를 때 애자일 방식은 개발 속도를 확실히 증가시켰습니다. 각자가 자신의 강점을 발휘하면서 빠르게 진행되는 반복 주기를 통해 효율적인 협업이 가능하였습니다.

  2. 조직력 있는 팀의 효율성: 팀이 마치 한 사람처럼 조직력 있게 움직일 때 애자일은 최고의 개발 방법론이 될 수 있었습니다. 팀원 모두가 공동의 목표를 가지고 있고 서로 신뢰하며 긴밀하게 협력하는 상황에서, 애자일 방식은 최상의 성과를 낼 수 있었습니다.

  3. 공동 목표의식: 팀이 한 사람처럼 공동의 목표 의식을 느끼고, 팀의 모든 구성원이 현재 무엇을 만들고자 하는지 명확하게 이해하고 있을 때 애자일 방식은 그 힘을 극대화할 수 있었습니다. 특히 이러한 상황에서는 빠르게 변화하는 요구사항에 맞춰 작업을 진행할 수 있어 큰 장점을 느꼈습니다.

  4. 새로운 개발에 적합: 무언가를 새롭게 개발해야 하는 경우, 애자일은 작은 단위로 개발하고 테스트하며 지속적으로 발전시켜 나갈 수 있기 때문에, 창의적이고 실험적인 작업에 적합한 방식이라고 판단되었습니다. 이번 프로젝트처럼 처음부터 기능을 만들어가는 경우, 반복적인 검토와 조정이 애자일의 핵심 강점이었습니다.

애자일의 단점

  1. 운영/관리의 한계: 이미 완성된 프로그램이거나 운영 및 관리가 필요한 서비스의 경우, 애자일 방식은 적합하지 않을 수 있었습니다. 지속적인 변화와 수정이 필요한 애자일의 특성상, 안정성을 중시하는 운영이나 유지보수에서는 오히려 혼란을 야기할 수 있었습니다.

  2. 개발 역량 차이의 문제: 팀원 중 한 명이라도 개발 역량이 떨어질 경우, 팀의 조직력이 저하되고 호흡이 맞지 않는 상황이 발생하였습니다. 모든 팀원이 비슷한 수준의 이해와 실력을 갖추지 못한다면 애자일 방식의 장점이 크게 줄어들고, 오히려 팀 내 갈등이 생길 가능성도 높아졌습니다.

  3. 목표의 불명확성: 팀원 중 한 명이라도 팀이 무엇을 개발하고자 하는지 명확하게 이해하지 못할 경우, 애자일 방식의 효율성은 급격히 떨어지고 팀의 사기가 저하될 수 있었습니다. 애자일은 모든 팀원이 목표와 방향성을 공유하고, 자율적으로 작업을 수행해야 하는 방식이기 때문에, 개개인의 목표 이해도가 낮으면 전체 프로젝트에 부정적인 영향을 미쳤습니다.

자세한 후기

자세한 애자일 후기

Blogging, Projects
blogging
This post is licensed under CC BY 4.0 by the author.

© Doorimul-KJH. Some rights reserved.

Using the Chirpy theme for Jekyll.