본문으로 건너뛰기

Paseo로 역할을 나눠 만든 Godot ARPG: 전투 구현부터 자동 테스트까지

연준서

2026.10.06

Paseo로 역할을 나눠 만든 Godot ARPG: 전투 구현부터 자동 테스트까지 본문 이미지

소개

Godot 4.7로 3D 탑다운 액션 RPG 시제품 simpleARPG를 만들고 있어요. WASD로 움직이고, 마우스로 방향을 잡아 검을 휘두르며, 늑대를 처치해 얻은 무기로 강해지는 게임이에요. 동굴에서 산길을 지나 무너진 마을을 탐험하는 흐름으로 맵도 넓히고 있어요.

기능이 작동하는 것과 플레이하기 자연스러운 것은 달랐어요. 벽을 향해 공격해도 전진하고, 떨어진 검이 시체에 가리고, 비탈길에서는 베기 효과가 땅에 묻혔어요. 기능을 추가할수록 기존 동작을 다시 확인할 필요도 커졌고요.

그래서 Paseo에서 기획자·개발자·검수자로 역할을 나누고, 직접 플레이와 자동 검사를 함께 쓰는 방식으로 진행했어요. 이번 글은 전투와 맵을 다듬고, 재사용 가능한 테스트를 기본 브랜치인 main에 병합한 과정이에요. AI와 게임을 만들면서 구현과 확인을 어떻게 나눌지 고민하는 분들께 도움이 되면 좋겠어요.

진행 방법

1. 역할을 나누고, 기능 하나씩 확인했어요

  • Claude Code 기획자: 다음 기능의 요구사항과 합격 기준을 문서로 만들어요. 코드와 씬은 수정하지 않아요.

  • Codex 개발자: 문서에 정한 범위만 구현하고 검증 결과를 보고해요.

  • Claude Code 검수자: 요구사항과 실제 변경 내용을 대조해 문제를 보고해요. 직접 수정하지 않아요.

  • 저: Godot에서 조작감과 화면을 확인하고, 다음 방향과 고칠 점을 정해요.

작업 순서는 기획 → 구현 → 검수 → 직접 플레이 → 수정이에요. 예를 들어 공격 전진을 고칠 때는 발동 조건을 먼저 정하고, 개발자가 구현한 뒤 검수와 플레이로 확인했어요. 한 번에 여러 기능을 맡기기보다 확인 가능한 기능 하나씩 진행했어요.

2. “공격이 된다”에서 전투 손맛을 다듬었어요

마우스 방향으로 부채꼴 베기를 하고, 늑대가 플레이어를 쫓아와 공격하도록 만들었어요. 늑대의 공격 예고를 보고 피할 수 있게 하고, 체력과 사망 처리도 붙였어요. 그런데 직접 해보니 벽을 향해 공격해도 캐릭터가 앞으로 나가는 게 어색했어요. 당시 남긴 작업 요청 전문이에요.

플레이하면서 체크리스트는 만족했어 다만 문제점을 발견했어 벽으로 전진이 허용되는게 이상해 몬스터에게만 돌진 가능한걸로 알고 있는데, 의도된건가?

이 피드백을 받아 앞에 적이 있을 때만 짧게 전진하도록 바꿨어요. 이어서 베는 동안 이동속도를 잠깐 줄여 공격에 무게감을 더했어요. 자동 검사로 발동 조건과 속도를 확인하고, 실제 플레이로 자연스럽게 느껴지는지 판단했어요.

늑대를 처치하면 검이 떨어지고, E 키로 획득해 장착하게 했어요. 첫 무기 Stormfang은 기본 공격보다 범위와 피해가 커져요. 검이 시체에 가리거나 획득 안내가 작았던 문제도 드롭 위치와 글자 크기를 조정해 고쳤어요.

위는 실제 게임 화면이에요. 패널에서 Stormfang의 3.4m / 130° / 피해 2와 두 무리의 CLEAR 상태를 확인할 수 있어요. 이 한 장을 장착 전후 성능 비교로 쓰지는 않았고, 구현된 무기 능력과 처치 기록을 보여주는 자료로 넣었어요.

3. 평지를 동굴과 산길, 마을로 넓혔어요

작은 테스트 평지는 동굴 → 산길 → 산 아래 무너진 마을 조망 → 마을로 내려가는 길 → 마을 안으로 확장됐어요. 여기서는 전투와 다른 문제가 나왔어요. 고원 사이에 하늘색 틈이 보이거나 절벽 그림자가 어색했고, 비탈길에서는 공격 효과가 가려졌어요.

각 문제를 수정 요구사항으로 정리하고 구현·검수·플레이를 반복했어요. 집 충돌과 플레이어를 가리는 집의 반투명 처리도 확인했어요. 이후에는 가족의 집을 살펴보는 상호작용과 그 검사까지 추가하는 작업으로 이어졌어요.

4. worktree는 버리고, 같은 폴더에서 브랜치를 썼어요

처음에는 기능마다 worktree를 만들었어요. 같은 프로젝트를 별도 폴더에 펼쳐 작업하는 방식이에요. 그런데 Godot이 폴더마다 다시 임포트해야 했고, 수정한 폴더가 아니라 원래 폴더를 실행하면 변경이 안 된 것처럼 보였어요.

그래서 프로젝트 폴더는 하나만 두고 기능별 브랜치로 변경을 관리하도록 바꿨어요. 개발하는 폴더와 제가 플레이하는 폴더가 같아져 확인이 편해졌어요. worktree가 나쁘다는 뜻이 아니라, 사용하는 도구에 맞는 방식을 고른 거예요.

5. 일회성 검사를 반복 실행할 수 있게 묶었어요

그동안 기능마다 따로 실행하던 검사들을 tests/run_all.gd로 묶었어요. 이런 실행 틀을 테스트 하네스라고 해요. 화면 없이 게임 로직과 물리를 실행하는 헤드리스 방식으로, 새 기능이 기존 동작을 망가뜨리지 않았는지 다시 확인해요.

  • combat / player / packs: 베기 거리·각도·피해, 무기 장착, 체력·사망, 늑대 공격, 전진·감속, 무리 집계와 드롭

  • movement / world: 평지·경사로 이동, 벽·집 충돌, 카메라 가림 판정과 메인 씬 구성

  • 이후 추가한 family: 가족의 집 배치, 상호작용 안내와 독백 진행, 재입력·사망 시 처리, 형체 충돌 등

검사를 늘리다가 남쪽 벽을 실제로 건드리지 않고도 통과하는 거짓 양성을 발견했어요. 출입구 한가운데서 밀면서 엉뚱한 좌표축 조건만 확인하고 있었던 거예요. 실제 벽 구간에서 광선이 벽을 맞히는지, 시작점과 이동량이 맞는지, 최종 위치가 벽 안쪽인지 함께 확인하도록 고쳤어요. 게임 버그가 아니라 검사 자체의 오류였어요.

다시 실행하는 방법도 문서로 남겼어요. Godot 콘솔 실행 파일을 godot 명령으로 실행할 수 있게 설정했다면, 프로젝트 폴더에서 아래처럼 전체 검사나 원하는 묶음만 실행할 수 있어요.

godot --headless --path . -s res://tests/run_all.gd
godot --headless --path . -s res://tests/run_all.gd -- --test=movement

출력은 PASS/FAIL과 측정값·기대값을 함께 보여줘요. 실패가 있으면 종료 코드 1, 모두 통과하면 0이에요. 전투 수치를 바꾸는 기능을 만들 때는 테스트 기대값도 함께 갱신해야 해요.

결과와 배운 점

테스트 결과는 두 시점으로 구분했어요.

  • main 병합 당시: 보고서에 전체 검사 64개 통과·0개 실패로 연속 두 번 실행한 기록이 있어요. 2026년 10월 6일 18:33, overnight-test-harness를 main에 병합했어요.

  • 이후 가족의 집 검사 추가 후: 제가 제공한 실행 캡처에는 74개 통과·0개 실패와 종료 코드 0이 보여요. 아래 이미지는 이 시점의 결과이며, 74개 검사가 모두 main에 병합됐다는 뜻은 아니에요.

처음에는 기능마다 일회성 검사와 플레이 확인을 반복했지만, 이제는 핵심 전투·이동·충돌을 한 명령으로 다시 확인할 기반이 생겼어요. 다만 이 글을 쓰면서 새 테스트를 실행하거나 새 플레이 검증을 한 것은 아니에요. 결과 수치는 병합 기록과 제공한 실행 캡처를 기준으로 했어요.

가장 크게 배운 세 가지

  1. 역할은 분명하게, 작업은 작게. 기획과 구현, 검수를 분리하고 한 번에 확인 가능한 기능 하나씩 맡기는 것이 좋았어요.

  2. 테스트의 통과 조건도 검수해야 해요. PASS가 나온다는 이유만으로 실제 동작을 확인했다고 볼 수는 없었어요. 남쪽 벽 검사가 그 사례였어요.

  3. 자동 검사와 직접 플레이는 서로 보완해요. 수치와 충돌은 자동으로 반복 확인하고, 공격 무게감·글자 크기·화면 가림은 직접 플레이해야 알 수 있어요.

앞의 일러스트는 설명용 생성 이미지예요. 실제 결과 자료는 게임 화면과 테스트 로그 캡처로 구분했어요. 헤드리스 검사는 화면 픽셀·스크린샷·실제 OS 마우스 조작을 확인하지 않고, 화면 전체 광선 격자 검사도 현재 하네스 범위 밖이에요.

아직 완성된 게임이 아니라 계속 만드는 시제품이에요. 다음 기능에서도 자동 검사와 직접 플레이를 함께 이어가려고 해요. 작은 ARPG의 전투 손맛을 다듬는 방법이나, 게임 테스트를 어디까지 자동화하는지 팁이 있다면 듣고 싶어요.

도움 받은 글 (옵션)

닿님의 write-post 저장소(MIT): https://github.com/daht-mad/write-post. 사례 기록과 작성 흐름의 참고 자료로 활용했어요.

3

함께 이야기해요 3

로그인하고 댓글을 남겨 주세요

박무경 프로필 이미지
박무경2026.10.07

3D 게임에 도전하시는군요! 저희도 3D 영역에 여러 모로 도전중이었습니다. 아직 이렇다할 성과가 없고 드릴만한 노하우도 별로 없어 스터디 커리큘럼에 포함은 안했지만요. 앞으로 배움을 청할 일이 있을 것 같습니다.

연두부 프로필 이미지
연두부2026.10.07

3D 액션 RPG면 상당한 난이도가 될 것 같습니다. 제 경험상으로는 1. 검수할 부분을 구체적으로 설명하고, 그 부분이 실제로 개선되었는지를 확인하는 게 좋습니다. 2. 개발 로그를 보존해 두고 거기서 QA 리스트를 따로 만든 다음, 항목별로 검수하라고 하면 조금 더 검수가 됩니다. 3. 말씀하신 것처럼 PASS도 믿기 어려워서, 일부러 기능을 망가뜨려 보고 FAIL이 나오는지 확인하면 테스트 자체를 검수할 수 있습니다. 4. 그래도 결국 사람이 직접 테스트해야 하는 구간은 따로 있는 것 같습니다. 애매한데 플레이하기 불편한 경우도 많이 있었습니다. 스터디에 계실 때는, 서로 같이 논의하고 개선해나가면 좋을 것 같습니다.

이구구 프로필 이미지
이구구2026.10.07

가족 집 살펴보는 영상 보기만 했는데도 벌써 슬퍼요.. 3d 는 고려해야할게 많아서 쉽지않을것 같은데 대단하시네요!

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기