Codex가 만든 게임이 보기에는 멀쩡한데, 움직이거나 저장 후 돌아오면 이상한가요? 수정 요청에 같은 시작 장면, 조작 순서, 기대한 결과, 실제 결과를 함께 적어 보세요. 화면이 정상인지와 실제로 이동·저장·복귀가 되는지를 나누어 확인하는 것이 핵심입니다. 이 글은 OpenAI 공식 게임 제작 사례와 게임 개발 활용 모음을 바탕으로 정리했습니다. 아래 요청서는 따라 해볼 예시이며 직접 실행한 결과가 아닙니다.
도착한 장면을 만드는 것과 직접 도착하는 것은 다릅니다
공식 제작 사례의 저자는 Codex에서 Astra를 사용해 우주 탐험 게임 Void Explorer를 만들었다고 설명합니다. 이 게임에는 궤도 비행, 대기권 하강, 해안 착륙처럼 이름이 붙은 테스트 장면이 있습니다. 매번 먼 곳에서 비행하지 않아도 같은 출발점으로 돌아가기 위한 장치입니다.
하지만 착륙한 장면을 불러왔다고 착륙 동작까지 확인한 것은 아닙니다. 사례에서는 Playwright라는 브라우저 테스트 도구로 장면을 불러오고 지형 준비 상태와 화면을 확인하는 검사 외에, 실제 조작을 거치며 위치와 상태 변화를 기록하는 별도 검사를 사용했습니다. 착륙, 하선, 걷기, 저장과 다시 불러오기, 탑승, 이륙이 그 대상입니다.
저자는 이런 검사가 스크린샷만으로 드러나지 않는 문제를 찾을 수 있다고 설명합니다. 예를 들면 땅은 보이지만 캐릭터가 디딜 충돌 표면이 준비되지 않았거나, 전환 중 우주선 위치가 갑자기 바뀌는 경우입니다.
내 게임에는 어떻게 적용할까요?
작은 게임이라면 문제가 생기는 동작 하나부터 고르는 것을 권합니다. 저장 오류라면 ‘저장 직전 위치에서 시작하는 장면’과 ‘실제로 저장한 뒤 다시 불러오는 순서’를 함께 준비하세요. 이는 공식 사례를 초보자 작업에 적용한 편집 제안이며, 모든 게임에 기본 제공되는 기능은 아닙니다.
“움직임이 이상해요”를 다시 따라 할 수 있는 메모로 바꾸기
재현은 같은 조건과 순서로 문제를 다시 일으켜 보는 일입니다. OpenAI의 게임 개발 활용 모음은 수정에 앞서 오류 보고, 실패한 검사, 로그, 재현 메모를 모아 우선순위를 정하는 작업을 제시합니다. 다음 표는 그 방향을 가상의 작은 탐험 게임에 적용한 작성 예시입니다.
| 기록할 항목 | 가상 작성 예시 |
|---|---|
| 시작 조건 | 우주선 옆 평지, 캐릭터가 밖에 서 있는 상태 |
| 조작 순서 | 앞으로 이동 → 저장 → 시작 화면으로 이동 → 저장 내용 불러오기 → 다시 앞으로 이동 |
| 기대한 결과 | 저장한 위치에서 다시 시작하며 이동할 수 있음 |
| 관찰한 결과 | 화면은 나타나지만 앞으로 이동하는 입력에 반응하지 않음 |
| 발생 조건 | 시도 횟수와 발생 횟수를 직접 세어 기록. 아직 세지 않았다면 미확인 |
| 함께 남길 자료 | 사용 브라우저, 게임 버전, 실제 조작 키, 문제가 난 단계, 확보한 오류 메시지 |
예시의 증상을 자신의 게임에서 확인한 사실처럼 복사하지 마세요. 실제로 본 현상으로 바꾸고, 모르는 항목은 ‘미확인’으로 남기면 됩니다. 저장 기능이 없는 게임이라면 벽 앞 이동이나 점프 후 착지처럼 현재 있는 동작을 고르세요.
관찰과 원인 추측을 따로 적으세요
‘불러온 뒤 이동 키에 반응하지 않는다’는 관찰입니다. ‘저장 파일이 망가졌다’는 원인 가설입니다. 같은 증상에도 여러 원인이 있을 수 있으므로, 요청서에서는 관찰한 현상과 확인할 가설을 분리하는 편이 좋습니다.
공식 사례의 게임은 현재 비행 모드, 지형 준비 여부, 활성 카메라 등을 확인하는 전용 JavaScript 인터페이스를 갖췄습니다. 내 게임에도 이런 정보가 있다면 화면과 함께 기록하도록 요청하세요. 없다면 Codex에 해당 동작을 확인하는 데 필요한 최소한의 상태 표시나 기록 방법을 제안해 달라고 할 수 있습니다.
복사해서 바꿔 쓸 Codex 요청서
아래 대괄호 부분을 자신의 게임에 맞게 채우세요. 자동 검사를 위한 실행 환경이 이미 갖춰져 있다고 가정하지 않는 요청입니다.
게임에서 다음 조작 문제가 있습니다.
시작 조건: [장소, 캐릭터 상태, 저장 내용 등]
실행 환경: [브라우저와 게임 버전, 모르면 미확인]
조작 순서: [실제로 누른 키나 버튼을 순서대로]
기대한 결과: [게임 규칙상 일어나야 하는 동작]
관찰한 결과: [직접 본 현상만]
발생 횟수: [시도 횟수 중 발생 횟수, 모르면 미확인]
첨부할 기록: [확보한 오류 메시지와 실패한 검사]
먼저 기존 테스트와 상태 기록 방법을 확인해 주세요.
같은 조건으로 돌아갈 시작 장면을 정하고,
장면을 불러오는 검사와 실제 조작을 거치는 검사를 구분해 주세요.
저장·복귀 문제라면 실제 저장과 불러오기 단계를 생략하지 마세요.
재현되면 문제가 난 단계의 위치, 조작 모드,
관련 준비 상태를 확인하고 원인 가설과 근거를 정리해 주세요.
수정 후에는 같은 시작 조건과 조작 순서로 다시 확인해 주세요.
결과는 재현 여부, 확인한 원인, 변경 내용,
수정 전후 검사 결과, 아직 확인하지 못한 항목으로 정리해 주세요.
실행할 수 없다면 막힌 이유와 사람이 따라 할 확인 순서를 알려 주세요.수정 뒤에는 무엇을 비교할까요?
같은 조건에서 이동이 되는지 확인한 뒤, 바로 연결된 동작도 살펴보세요. 아래는 편집자가 제안하는 확인 기준입니다. 게임의 설계가 다르면 기대 결과를 먼저 고쳐야 합니다.
- 이동: 입력에 반응하는지, 벽이나 지면을 의도치 않게 통과하지 않는지 확인합니다.
- 저장과 복귀: 게임에서 보존하기로 한 위치와 조작 상태가 돌아오는지 확인합니다.
- 탑승과 하선: 전환 뒤 조작 대상이 맞는지, 위치가 예상 밖으로 바뀌지 않는지 확인합니다.
검사가 통과해도 조작감은 직접 살펴볼 몫이 남습니다. 공식 사례에서도 자동 검사를 활용하면서 저자가 외관과 조작감을 계속 검토했습니다.
체크리스트
- 문제가 생기는 동작 하나를 골랐나요?
- 다시 돌아갈 시작 장소와 캐릭터 상태를 적었나요?
- 누른 키와 버튼을 순서대로 적었나요?
- 기대한 결과와 관찰한 결과를 분리했나요?
- 화면 확인 외에 실제 이동·저장·복귀 과정을 포함했나요?
- 상태 기록이 없을 때 무엇을 추가로 확인할지 정했나요?
- 수정 전후에 같은 조건으로 확인하도록 요청했나요?
- 실행하지 못한 검사와 사람이 확인할 조작감을 남겼나요?
한계와 주의
사례의 검사 장치는 해당 게임에 맞춰 만든 것입니다. Void Explorer의 상태 인터페이스나 이름 붙은 장면이 내 프로젝트에도 있는 것은 아닙니다. Playwright를 활용한 브라우저 게임 사례가 모든 게임 엔진과 실행 환경에 그대로 적용된다고 볼 수도 없습니다.
문제가 다시 나타나지 않았다는 사실만으로 해결됐다고 단정하지 마세요. 시작 상태나 조작 순서가 달랐는지 확인하고, 차이를 모르면 재현 조건이 미확인이라고 남기는 것이 좋습니다. 이는 결과 기록을 위한 편집 권고입니다.
공식 사례에서 현재 브라우저 화면을 살펴본 작업도 특정 시점의 확인이었습니다. 매 순간 게임을 계속 지켜본 것은 아니라고 저자가 명시합니다. 이 글 역시 특정 기기에서의 실행 성공이나 수정 효과를 검증하지 않았습니다.
제공 자료의 확인일은 2026년 10월 3일입니다. 이를 기능 발표일로 해석하지 않으며, 두 자료만으로 현재 모델 이용 조건이나 가격을 판단하지 않습니다.
자주 묻는 질문
스크린샷만 보내도 되나요?
화면 문제를 설명하는 데는 도움이 됩니다. 다만 공식 사례는 충돌 표면 준비나 전환 중 위치 변화처럼 화면 한 장으로 드러나지 않는 문제도 설명합니다. 조작 순서와 문제가 난 단계를 함께 적어 주세요.
테스트 장면을 만들면 실제 플레이 검사는 생략해도 되나요?
장면을 불러오는 것과 그곳까지 조작하는 과정은 별개입니다. 공식 사례에서도 시작 장면 검사와 실제 조작 검사를 구분했습니다. 저장·복귀 오류라면 저장하고 다시 불러오는 과정을 직접 거쳐야 해당 동작을 확인할 수 있습니다.
코드를 몰라도 재현 메모를 만들 수 있나요?
시작 위치, 누른 버튼, 기대한 동작, 실제 현상은 코드 없이도 적을 수 있습니다. 내부 상태 기록이나 자동 검사 구성은 Codex에 기존 프로젝트를 확인한 뒤 제안해 달라고 요청하세요.
Codex가 문제가 없다고 하면 끝내도 되나요?
어떤 시작 조건에서 어떤 조작을 실행했는지 확인하세요. 이 글에서는 실행한 검사와 미확인 항목을 함께 받도록 권합니다. 조작감처럼 직접 플레이하며 판단할 부분도 남습니다.
게임 전용 상태 인터페이스를 그대로 복사해야 하나요?
그럴 필요는 없습니다. 공식 사례의 인터페이스는 해당 우주 탐험 게임용입니다. 자신의 문제를 확인하는 데 필요한 위치나 조작 상태부터 정하고, 기존 기록 기능을 활용할 수 있는지 확인하세요.
출처
- OpenAI Developers: How to build games with Astra — 반복 가능한 장면, 상태 확인, 실제 조작 테스트와 사례의 한계. 자료 확인일: 2026-10-03.
- OpenAI: Game development 활용 모음 — 오류 보고, 실패한 검사, 로그와 재현 메모를 모으는 작업. 자료 확인일: 2026-10-03.