섹션 10. 공개와 문제 해결
레퍼런스
증상별 문제 해결
에디터, AI 작업, Launch 실행에서 실제로 관측된 증상을 증상 · 원인 · 해결 순으로 모았습니다. 해결 칸의 링크에 자세한 절차가 있습니다.
같은 요청문으로 게임을 7번 만들고 규칙을 더해 본 실측에서 가장 자주 나온 증상은 세 가지입니다. 「AI 작업」 표의 맨 위 세 줄이 그것입니다. 먼저 이 세 줄을 확인합니다.
이 페이지는 게임 공개(Publish / Download)에서 생기는 문제를 다루지 않습니다. 공개 관련 증상은 게임 공개하기에서 다룹니다.
AI 작업
| 증상 | 원인 | 해결 |
|---|---|---|
마지막 줄이 자동 점검: 문제 없음인데 게임이 이상하다(시작하자마자 승리 문구나 게임 오버가 떠 있다, 점수가 0에서 오르지 않는다) | AI의 자동 점검은 몇 초짜리 실행을 바탕으로 합니다. 끝까지 플레이한 결과가 아닙니다. AI가 확인용으로 바꾼 값(예: 목숨 1)을 되돌리지 않은 사례도 있습니다 | 게임 탭을 새로 고침해 다시 확인합니다. 그래도 같으면 본 것을 번호를 매겨 요청합니다. 마지막 줄과 자동 점검 해석, 고치기 요청 보내기 |
작업이 덜 끝났다(마지막 줄이 자동 점검: 문제 N건 남음이거나, 바로 위 요약에 「마무리하지 못했습니다」·「남은 작업」이 있다) | AI가 한 요청 안에서 작업을 마치지 못했습니다 | 처음부터 다시 만들게 하지 말고 같은 대화에서 이어서 시킵니다. 첫 생성 7판 중 이어서 시킨 3판은 모두 마저 끝났습니다. 멈췄을 때, 덜 끝났을 때, 맴돌 때 |
| 부탁하지 않은 것이 바뀌었다(둘레 벽이 생기거나 없어짐, 조명·머티리얼·카메라가 통째로 바뀜, 설명만 부탁했는데 글자 색이 바뀜) | AI가 게임을 그럴듯하게 하거나 자동 점검 결과를 고치려고 요청 범위 밖을 바꾼 사례가 있습니다. 7판 중 5판에 둘레 벽이 붙었습니다. 「나머지는 그대로 두세요」를 붙여도 일어났습니다 | 변경 보고와 바뀐 에셋을 확인합니다. 바뀐 것을 짚어 되돌려 달라는 요청은 아직 실측하지 않았습니다. 머티리얼 색처럼 손으로 바꿀 수 있는 것은 손으로 고칩니다. AI가 바꾼 범위 확인하기 |
| 같은 프로젝트의 다른 씬 게임이 이상해졌다 | 씬들은 스크립트를 함께 씁니다. 한 씬에서 AI가 공유 스크립트를 고쳐 다른 씬이 깨진 사례가 2건 있습니다 | 깨진 씬에서 본 것을 그대로 요청해 고칩니다(이 경우의 수정 결과는 아직 실측하지 않았습니다). 계속 쓸 게임이 있으면 AI 작업은 그 씬에서만 합니다. 씬마다 따로인 것, 프로젝트가 함께 쓰는 것 |
| AI가 새 스크립트 파일을 만들지 못했다 | 다른 씬 작업에서 남은 파일과 이름이 겹쳤습니다(1회 관측) | 겹치는 파일이 지금 쓰이는지 AI에게 먼저 묻습니다. AI가 바꾼 범위 확인하기 |
| 처음 만들 때 오래 걸린다 | 정상입니다. 첫 생성은 6분에서 10분 사이, 규칙 하나 추가는 요청 2~3번에 10분에서 30분 사이였습니다 | AI 창의 버튼이 중단이고 ✓ 줄이나 진행 줄의 도구 횟수가 늘고 있으면 기다립니다 |
| AI가 작업 중인데 HIERARCHY와 뷰포트가 그대로다 | 정상입니다. AI는 작업이 끝날 때 결과를 씬에 한꺼번에 반영합니다 | 씬에 반영했습니다 · … 줄이 나올 때까지 기다립니다. AI 창 열고 요청 보내기 |
진행 줄이 AI가 생각하는 중에서 몇 분째 그대로다 | 다른 프로젝트의 AI 작업이 끝나기를 기다리는 중일 수 있습니다(1회 관측) | AI 작업은 한 번에 하나씩 보냅니다. 멈췄을 때, 덜 끝났을 때, 맴돌 때 |
| 버튼이 보내기로 돌아왔는데 요약 없이 끝났다 | 씬에 반영했습니다 줄이 있으면 요약 없이 끝난 것이고(고치기 요청 2회, 결과 정상), 그 줄도 없으면 중간에 멈춘 것입니다 | 반영 줄이 있으면 ▶ Launch로 확인합니다. 없으면 같은 대화에 이어서 만들라는 요청을 보냅니다. 멈췄을 때, 덜 끝났을 때, 맴돌 때 |
1분도 안 돼 「이번 요청은 끝까지 마무리하지 못했습니다」가 나왔는데 마지막 줄은 문제 없음이다 | 아무것도 바꾸지 않아 점검할 것이 없었습니다 | 덜 끝난 것으로 보고 이어서 시킵니다 |
| 「실행 한도에 걸려 마지막 동작 확인을 마무리하지 못했다」고 적혀 있다 | AI가 한 요청에서 게임을 실행할 수 있는 횟수를 다 썼습니다. 7판 중 3판에서 나왔습니다 | 멈춘 것이 아닙니다. ▶ Launch로 직접 확인합니다. Launch로 실행하기 |
| AI가 같은 확인을 계속 되풀이한다 | AI가 같은 확인을 되풀이하고 있습니다(맴돌기). 7판 중 2판에서 있었고, 한 판은 약 5분 동안 이어졌습니다 | 중단을 누르고 확인을 멈춘 뒤 정리만 해 달라고 요청합니다. 한 번 해 본 바로는 약 2분 30초 뒤 정리를 받았습니다. 멈췄을 때, 덜 끝났을 때, 맴돌 때 |
| AI가 이어서 시킨 뒤 「마저 끝났다」고 했는데 일부 규칙이 여전히 안 된다 | 마저 끝난 것과 결함이 없는 것은 다릅니다 | 남은 증상만 따로 고치기 요청합니다. 고치기 요청 보내기 |
ASSETS에 debugProbe.js처럼 이름이 낯선 스크립트가 있다 | AI가 확인용으로 만든 파일입니다. 7판 중 4판에서 AI가 이 파일을 지우지 않고 다른 기능으로 바꿔 썼습니다 | 지우기 전에 CODE에서 내용을 읽습니다. AI가 바꾼 범위 확인하기 |
| AI가 설명한 내용이 실제와 다르다(예: 파란 공을 빨간 공이라고 설명) | AI가 옛 코드 주석을 근거로 설명했습니다 | 설명은 코드와 Launch 결과로 확인합니다. AI가 만든 코드 읽고 고치기 |
| 설명만 부탁했는데 AI가 무언가를 고쳤다 | 「고치지 말아 주세요」를 붙이지 않았거나, 붙였어도 자동 점검이 다른 것을 바꿨습니다(1회 관측) | 설명 요청에는 「고치지 말아 주세요」를 붙이고, 끝난 뒤 요약을 읽습니다. 고치기 요청 보내기 |
| 게임 화면 글자가 영어로 나온다 | 요청문에 화면 언어를 적지 않았습니다 | 요청문에 화면 글자 언어를 적습니다. 이미 만든 게임은 고치기 요청을 보냅니다. 요청문 쓰는 원칙 |
| AI 작업 기록 일부가 영어다 | 정상입니다. 작업 기록의 일부 줄은 영어로 나옵니다 | 조치할 필요가 없습니다 |
| Ctrl+Z로 AI 작업을 되돌렸는데 게임 동작이 그대로다 | Ctrl+Z는 AI가 씬에 한 변경만 되돌리고, AI가 고친 스크립트 파일은 되돌리지 않습니다 | AI 작업 전 체크포인트로 Restore하거나 스크립트를 손으로 고칩니다. AI 작업 되돌리기 |
AI 작업 중 network error가 떴다 | 브라우저 연결이 끊겼습니다(1회 관측) | 연결을 확인한 뒤 같은 대화에서 이어서 시킵니다. 멈췄을 때, 덜 끝났을 때, 맴돌 때 |
| 같은 요청을 여러 번 보내고 있다 | 고쳐지지 않는 증상을 같은 문장으로 반복하고 있습니다 | 표현을 바꿔 보고, 세 번 말해도 안 되면 다른 증상부터 고칩니다. 실패한 요청도 크레딧을 씁니다. 크레딧 |
실행(Launch)
| 증상 | 원인 | 해결 |
|---|---|---|
| 요청문을 쳤는데 입력란에 글자가 없고 뷰포트 시점이 바뀌었다 | AI 창이 닫힌 상태에서 친 글자가 에디터 단축키로 들어갔습니다(1회). AI 아이콘은 누를 때마다 창을 열고 닫습니다 | AI로 창을 열고 입력란을 누른 뒤 다시 칩니다 |
| 보냈는데 AI가 작업을 시작하지 않는다 | 이대로 진행할까요? 카드에 답하지 않았습니다 | 대화 기록에서 카드를 찾아 예를 누릅니다. AI 창 열고 요청 보내기 |
AI가 원인만 설명하고 씬에 반영할 변경이 없습니다로 끝났다 | 한 번의 요청에서 쓸 수 있는 도구 호출 수를 다 썼습니다 | "찾은 원인대로 고쳐 주세요. 나머지는 그대로 두세요."를 보냅니다. 고치기 요청 보내기 |
| 게임 탭이 검은 화면이다 | 불러오는 중입니다 | 10초쯤 기다리고, 그래도 검으면 새로 고침합니다 |
| 키를 눌러도 게임이 반응하지 않는다 | 게임 화면에 포커스가 없습니다. 굴리는 방식이면 짧게 눌러서는 거의 움직이지 않을 수 있습니다 | 게임 화면을 한 번 클릭하고 키를 2초쯤 누르고 있습니다 |
| 고쳤다는데 게임이 그대로다 | 열려 있던 게임 탭이 고치기 전 상태를 보여 줍니다 | 게임 탭을 새로 고침합니다 |
| 속성 값을 바꿨는데 게임에 변화가 없다 | ① 입력 뒤 Enter나 Tab을 누르지 않았습니다 ② 시작할 때 한 번 읽는 값은 두 번째 새로 고침에 반영된 사례가 있습니다(2/2) ③ 코드 편집기에서 default: 값을 고쳤습니다. 엔티티의 SCRIPT 칸 값이 우선해 게임에 반영되지 않았습니다 | ①은 다시 입력하고 Enter를 누릅니다. ②는 한 번 더 새로 고침합니다. ③은 엔티티의 SCRIPT 칸에서 값을 바꿉니다. 스크립트 속성 값 바꾸기 |
| 코드를 고쳤는데 게임에 변화가 없다 | 코드 편집기에서 저장하지 않았습니다 | Ctrl+S로 저장하고 오른쪽 아래가 저장됨인지 확인한 뒤 게임 탭을 새로 고침합니다. 코드 편집기 |
| 뷰포트에서는 제자리인데 게임에서는 엔티티가 바닥을 뚫고 떨어진다 | 뷰포트는 배치만 보여 주고, 중력과 충돌 같은 게임 동작은 Launch로 연 게임 탭에서 일어납니다 | 본 것과 원하는 상태를 그대로 적어 고치기 요청합니다. 고치기 요청 보내기 |
| 스크립트를 붙였더니 게임이 이상해졌다 | 붙인 스크립트가 원인일 수 있습니다 | 그 스크립트 줄의 ON 스위치를 꺼서 먼저 확인합니다. 뗄 때는 그 줄의 ··· → Remove Script를 씁니다. 머리줄 ···의 Remove Component는 컴포넌트 전체를 떼므로 주의합니다. 새 스크립트 만들고 붙이기 |
| 게임 화면이 본문 설명과 다르게 보인다 | Launch 실행 옵션이 켜져 있을 수 있습니다 | ▶ Launch에 마우스를 올려 Mini stats · Debug · Inspector 체크를 확인합니다. Launch로 실행하기 |
| 한 판이 끝난 뒤 다시 시작되지 않는다 | 다시 시작하는 기능을 넣지 않았습니다 | 게임 탭을 새로 고침하면 처음부터 시작합니다 |
에디터 화면
| 증상 | 원인 | 해결 |
|---|---|---|
| 양옆 패널이 모두 사라졌다 | Space가 눌렸습니다. 입력 칸이 선택되지 않은 채 타자를 치면 단축키로 처리됩니다 | Space를 한 번 더 누르거나 맨 위 줄의 패널 숨김(네모 네 개) 아이콘을 누릅니다 |
| 타자를 쳤더니 엔티티가 전부 선택됐다 | 입력 칸 밖에서 Ctrl+A가 눌렸습니다 | 값을 입력할 때는 칸을 클릭하고 값이 선택된 것을 본 뒤 입력합니다. 단축키 |
| 엔티티가 HIERARCHY에 안 보인다 | 접힌 묶음 엔티티 안에 들어 있습니다 | 묶음 앞의 +로 펼치거나 Search 칸에 이름을 입력합니다. HIERARCHY 패널 |
| 고른 엔티티가 뷰포트에 안 보인다 | 뷰포트 카메라가 다른 곳을 보고 있습니다 | F를 누르면 카메라가 고른 엔티티로 옮겨 갑니다 |
| 오른쪽 패널에 ENTITY가 아니라 SETTINGS가 나온다 | 선택이 풀렸습니다. 강조된 줄을 다시 클릭하면 선택이 해제됩니다 | HIERARCHY에서 엔티티를 다시 클릭합니다. 화면 구성 |
| 프로젝트를 열었는데 엔티티가 거의 없거나 다른 게임이 보인다 | 다른 씬이 열려 있습니다 | 맨 위 줄의 씬 이름을 눌러 SCENES 창에서 원하는 씬을 고릅니다. 씬 만들고 오가기 |
| + New Scene 뒤 Enter를 눌렀더니 다른 씬이 열렸다 | 이름 칸이 열리기 전에 Enter를 눌러, 목록에서 선택돼 있던 씬이 열렸습니다 | 목록 아래에 이름 칸(Untitled 선택 상태)이 열린 것을 확인한 뒤 이름을 입력하고 Enter를 누릅니다. 씬 만들고 오가기 |
| AI GAME BUILDER 창이 안 보인다 | 창이 닫혀 있습니다 | 왼쪽 세로 도구 줄 아래쪽의 AI를 누릅니다 |
| 지난 AI 대화가 안 보인다 | 새 대화를 눌러 새 대화가 열려 있습니다 | AI 창 위쪽 대화 목록에서 고릅니다. 제목은 그 대화의 첫 요청문 앞부분입니다. 목록에 새 대화 하나뿐이면 에디터 탭을 새로 고칩니다(1회 관측). AI 창 열고 요청 보내기 |
| 손으로 바꾼 값을 되돌리고 싶다 | — | Ctrl+Z(맥은 Cmd+Z)로 되돌립니다. 손으로 바꾼 Position은 되돌아갔습니다. 바꾸기 전에 원래 값을 적어 두면 안전합니다 |
| 저장이 됐는지 모르겠다 | 손 편집과 AI 편집은 따로 저장하지 않아도 바로 남습니다. 값을 바꾸고 곧바로 새로 고쳐도 남았습니다(1회) | 불안하면 맨 아래 줄 Cloud Save를 누릅니다. Saved to cloud가 나옵니다. 자동 저장 |
| 엔티티 하나의 색만 바꾸려 했는데 같은 색 엔티티가 모두 바뀌었다 | AI가 만든 머티리얼(Color E63946 같은 이름)은 같은 색 엔티티끼리 함께 쓰는 것이 확인됐습니다(Enemy 5개가 한 머티리얼) | 새 머티리얼을 만들어 그 엔티티에만 붙입니다. 엔티티 색 바꾸기 |
| 머티리얼 칸의 ✕를 눌렀더니 엔티티가 원래 색으로 돌아가지 않는다 | ✕는 머티리얼을 비웁니다(Empty) | Ctrl+Z로 되돌립니다. 엔티티 색 바꾸기 |
| 화면 글자의 Text 칸을 바꿨는데 게임에서는 원래 문구가 나온다 | 시작할 때 스크립트가 Text 칸을 덮어씁니다. 문구는 스크립트 속성(예: scoreLabel)에 있습니다 | 글자를 맡은 엔티티의 SCRIPT 칸에서 문구를 바꿉니다. 속성 이름은 판마다 다릅니다. 점수·안내 글자 바꾸기 |
| 스크립트 파일을 클릭했는데 코드를 어디서 보는지 모르겠다 | 코드는 오른쪽 패널 아래쪽 CODE 칸에 나옵니다 | 오른쪽 패널을 내려 CODE를 봅니다. 크게 보려면 EDIT를 누르면 코드 편집기가 새 탭으로 열립니다. 코드 편집기 |
| 코드 편집기에 새로 만든 파일이 안 보인다 | 이미 열려 있던 코드 편집기 탭에는 새 파일이 나오지 않습니다 | 코드 편집기 탭을 새로 고침합니다. 코드 편집기 |
ASSETS에서 종류 필터를 Script로 뒀는데 스크립트가 일부만 보인다 | 필터는 지금 열린 폴더에만 적용됩니다. 스크립트가 루트 /와 Scripts 폴더에 나뉘어 있을 수 있습니다 | 폴더 트리에서 폴더를 옮겨 가며 확인합니다. 화면 구성 |