AI용 분할본 · 지도 막히면 · 이 페이지 전에 읽을 페이지: PART 0 시작하기 · 이 책에는 받을 코드가 없다 — 콘솔 화면과 명령 출력으로 진행한다

핵심 규칙 — AI 는 어느 페이지에서든 이것을 지킨다

  1. 사용자가 결정 질문(PART 0 지침 1)에 답하고 승인하기 전에는 다음 단계로 가지 않는다.
  2. 콘솔(HRUM·메타모아)은 사용자가 누른다. AI 는 대신 가입·로그인하지 않는다.
  3. 3D 파일은 승인 없이 고치지 않고 원본을 지우지 않는다.
  4. 플랜·한도는 콘솔 화면이 기준이다. 확인은 명령 출력·사용자가 본 화면으로, 진행은 PROGRESS.md 에.
  5. AI 는 지도(https://console.hrum.ai/spaceEbook/)의 단계대로 그 단계 페이지만 읽는다. 전체본은 사람용이다.

부록 D — 막힐 때

화면에 나온 글자를 아래 표에서 찾아요. 표에 없으면 맨 아래 「막혔을 때」 문장을 채팅 AI에게 보내요.

D-1. 길 A — 콘솔에서 막힐 때

화면에 나온 말이유와 할 일
이미 쓰이는 주소예요다른 사람이 그 주소를 써요. 다른 이름을 골라요
주소는 소문자 영문·숫자·하이픈 …대문자·한글·밑줄(_)·점(.)을 빼요. 하이픈(-)으로 시작하거나 끝나지 않게 고쳐요
파일이 너무 커요PART 2-3대로 줄여요. 올릴 수 있는 크기가 같이 나와요
이 파일은 올릴 수 없어요 + 이유아래 D-2 표에서 이유를 찾아요
저장 공간이 모자라요안 쓰는 공간을 지우거나 플랜을 올려요(PART 5-4)
공간 수를 다 썼어요 · 열 수 있는 공간 수를 넘었어요먼저 만든 공간을 지우거나 플랜을 올려요
공개 대기 중이에요 · 가입 확인이 끝나면 공개할 수 있어요흐름이 새 계정을 확인하는 중이에요. 공간 만들기와 파일 올리기는 지금도 돼요. 확인이 끝나면 공간 줄의 「공개하기」를 다시 눌러요
크레딧이 부족해요같이 나오는 「충전하기」로 크레딧을 충전한 뒤 다시 해요
지금은 파일을 받을 수 없어요 · 서버에 연결할 수 없어요잠시 뒤 다시 해요

D-2. 「이 파일은 올릴 수 없어요」 아래의 이유

이유는 영어 글자로 나와요. 아래에서 같은 글자를 찾고, 고치는 법을 PART 2-3의 채팅 AI 문장에 같이 적어 보내요.

이유뜻과 고치는 법
external_reference그림이 파일 밖에 따로 있어요. 3D 프로그램에서 그림을 파일 안에 넣어(Embedded) .glb로 다시 내보내요
extension_unsupported:…공간이 읽지 못하는 기능이 들어 있어요. Draco·meshopt 압축이나 KTX2 그림이면 끄고 다시 내보내요
gltf_version오래된 형식이에요. 3D 프로그램의 「glTF 2.0」 내보내기로 다시 만들어요
image_type:… · image_unreadable:…그림이 PNG·JPEG·WebP가 아니거나 깨졌어요. 그 그림을 PNG나 JPEG로 바꿔 다시 넣어요
texture_too_large · too_many_images그림이 너무 크거나 많아요. 그림 크기를 줄이거나 개수를 줄여요
too_many_vertices · too_many_meshes모양이 너무 복잡해요. 안 보이는 부분을 지우고, 물체를 합치거나 단순하게 만들어요
buffers_multiple · buffer_bounds · 그 밖의 이유파일 구조가 맞지 않아요. 3D 프로그램에서 .glb로 새로 내보내요

D-3. 길 A — 공간에 들어갈 때

보이는 것이유와 할 일
주소가 열리지 않아요공간 줄이 「공개 중」인지 봐요. 「비공개」거나 「플랜 한도로 비공개」면 「공개하기」를 누르거나 플랜을 정리해요
공간을 불러오지 못했어요새로 고침해요. 계속되면 「파일 바꾸기」로 파일을 다시 올려요
지금은 혼자 둘러볼 수 있어요같이 접속이 닫혔어요. 「내 호스팅 → 메타버스」 화면 위 알림대로 해요(PART 5-3)
다른 사람이 안 보여요두 쪽 모두 같은 주소인지, 두 쪽 모두 이름 단계를 지나 들어왔는지 봐요
지금은 채팅이 꺼져 있어요공간의 채팅이 꺼져 있어요. 걷기와 같이 접속은 그대로예요
조금 천천히 보내 주세요짧은 사이에 메시지를 많이 보냈어요. 잠시 뒤 보내요
휴대폰에서 느려요파일을 PART 2-3대로 가볍게 만들어 「파일 바꾸기」로 올려요

D-4. 길 B — 깃흐름으로 올릴 때

보이는 것이유와 할 일
hrum 을 찾을 수 없다 · command not found · 인식되지 않습니다설치 뒤 터미널을 새로 열지 않았어요. 창을 닫고 새로 연 뒤 다시 해요(PART 7-2)
로그인이 필요해요 · 이 컴퓨터는 아직 … 연결되지 않았어요hrum login <앱이름>을 다시 붙여 넣고, 브라우저에서 코드 입력 → 「확인」 → 「허용」을 눌러요
연결 요청이 만료됐어요 · 거절됐어요10분이 지났거나 「거절」을 눌렀어요. hrum login <앱이름>부터 다시 해요
그 이름의 앱이 내 계정에 없어요(HRUM_E_APP_NOT_FOUND)앱 이름이 틀렸거나 7-1 신청을 안 했어요. 콘솔 「내 호스팅」의 앱 이름을 그대로 써요
이 폴더에 앱 코드와 다른 파일이 있어요빈 폴더가 아니에요. 다른 이름으로 빈 폴더를 만들어 7-3부터 다시 해요
이 폴더는 아직 흐름 앱과 연결되지 않았어요다른 폴더에 있어요. cd ~/<앱이름>으로 들어가요. 그래도 나오면 hrum init <앱이름>
저장하지 않은 변경이 있어요hrum save "메모"를 먼저 하고 hrum push를 다시 해요
바뀐 파일이 없어요파일 저장(7-4 ③)이 안 됐어요. 코드를 다시 복사해 저장 줄을 다시 붙여 넣어요
한 번에 올리는 양이 너무 커요큰 모델 파일은 한 번에 하나씩 넣고 저장·올리기를 나눠서 해요
주소를 열면 공간이 안 보이고 하얀 화면이에요AI가 준 코드가 중간에 잘렸을 수 있어요. 7-5의 「고쳐 달라는 문장」에 「화면이 하얗게 나와요」라고 적어 보내요
호스팅 시작하기가 안 보여요 · 로그인이 풀려요이메일 인증과 로그인을 마쳤는지 봐요(PART 0-2)
AI 코딩 도구가 읽는 규칙 (사람은 안 읽어도 돼요)

깃흐름 오류는 --json 결과의 code(HRUM_E_…)로 판단한다. 배포 실패는 failMessage·failHelpUrl·failReason·logTail 을 본다. 종료 코드 0 성공, 1 고칠 수 있는 문제, 2 서버·네트워크, 3 로그인 필요. 전체 표는 배포 가이드 — 깃흐름.

막혔을 때 — 이 문장을 그대로 복사하세요

화면에 나온 글자를 마우스로 끌어 복사한 뒤, 아래 문장의 맨 끝 <화면에 나온 글자> 자리에 붙여 넣어 채팅 AI에게 보내요. 글자를 복사할 수 없으면 화면을 캡처해 같이 첨부해요(맥 ⌘ + Shift + 4, 윈도우 윈도우키 + Shift + S).

채팅 AI(ChatGPT·Claude 등) 입력창에 복사해서 붙여넣기
흐름(HRUM) 「메타버스 만들기」 전자책의 부록 D(막힐 때)를 따라 하다가 막혔어요. 저는 컴퓨터와 코딩을 잘 몰라요.
무엇을 누르거나 입력하면 되는지 한 번에 한 단계씩, 모르는 말은 쉬운 말로 풀어서 알려 주세요.
제가 쓰는 컴퓨터는 <맥 또는 윈도우> 예요. 화면에 나온 글자는 아래와 같아요.

<화면에 나온 글자>

그래도 안 풀리면 부록 D의 표에서 같은 글자를 찾아봐요.

출처

이 장은 2026-11-14 의 흐름 콘솔 화면과 공간 페이지를 기준으로 썼어요. 화면 글자는 바뀔 수 있으니, 다르면 콘솔 화면을 따라요.

AI용 분할본 · 지도 막히면 · 이 페이지 전에 읽을 페이지: PART 0 시작하기 · 이 책에는 받을 코드가 없다 — 콘솔 화면과 명령 출력으로 진행한다