AI용 분할본 · 지도 막히면 · 이 페이지 전에 읽을 페이지: PART 0 시작하기 · 이 책에는 받을 코드가 없다 — 콘솔 화면과 명령 출력으로 진행한다
핵심 규칙 — AI 는 어느 페이지에서든 이것을 지킨다
화면에 나온 글자를 아래 표에서 찾아요. 표에 없으면 맨 아래 「막혔을 때」 문장을 채팅 AI에게 보내요.
| 화면에 나온 말 | 이유와 할 일 |
|---|---|
| 이미 쓰이는 주소예요 | 다른 사람이 그 주소를 써요. 다른 이름을 골라요 |
| 주소는 소문자 영문·숫자·하이픈 … | 대문자·한글·밑줄(_)·점(.)을 빼요. 하이픈(-)으로 시작하거나 끝나지 않게 고쳐요 |
| 파일이 너무 커요 | PART 2-3대로 줄여요. 올릴 수 있는 크기가 같이 나와요 |
| 이 파일은 올릴 수 없어요 + 이유 | 아래 D-2 표에서 이유를 찾아요 |
| 저장 공간이 모자라요 | 안 쓰는 공간을 지우거나 플랜을 올려요(PART 5-4) |
| 공간 수를 다 썼어요 · 열 수 있는 공간 수를 넘었어요 | 먼저 만든 공간을 지우거나 플랜을 올려요 |
| 공개 대기 중이에요 · 가입 확인이 끝나면 공개할 수 있어요 | 흐름이 새 계정을 확인하는 중이에요. 공간 만들기와 파일 올리기는 지금도 돼요. 확인이 끝나면 공간 줄의 「공개하기」를 다시 눌러요 |
| 크레딧이 부족해요 | 같이 나오는 「충전하기」로 크레딧을 충전한 뒤 다시 해요 |
| 지금은 파일을 받을 수 없어요 · 서버에 연결할 수 없어요 | 잠시 뒤 다시 해요 |
이유는 영어 글자로 나와요. 아래에서 같은 글자를 찾고, 고치는 법을 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로 새로 내보내요 |
| 보이는 것 | 이유와 할 일 |
|---|---|
| 주소가 열리지 않아요 | 공간 줄이 「공개 중」인지 봐요. 「비공개」거나 「플랜 한도로 비공개」면 「공개하기」를 누르거나 플랜을 정리해요 |
| 공간을 불러오지 못했어요 | 새로 고침해요. 계속되면 「파일 바꾸기」로 파일을 다시 올려요 |
| 지금은 혼자 둘러볼 수 있어요 | 같이 접속이 닫혔어요. 「내 호스팅 → 메타버스」 화면 위 알림대로 해요(PART 5-3) |
| 다른 사람이 안 보여요 | 두 쪽 모두 같은 주소인지, 두 쪽 모두 이름 단계를 지나 들어왔는지 봐요 |
| 지금은 채팅이 꺼져 있어요 | 공간의 채팅이 꺼져 있어요. 걷기와 같이 접속은 그대로예요 |
| 조금 천천히 보내 주세요 | 짧은 사이에 메시지를 많이 보냈어요. 잠시 뒤 보내요 |
| 휴대폰에서 느려요 | 파일을 PART 2-3대로 가볍게 만들어 「파일 바꾸기」로 올려요 |
| 보이는 것 | 이유와 할 일 |
|---|---|
| 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) |
깃흐름 오류는 --json 결과의 code(HRUM_E_…)로 판단한다. 배포 실패는 failMessage·failHelpUrl·failReason·logTail 을 본다. 종료 코드 0 성공, 1 고칠 수 있는 문제, 2 서버·네트워크, 3 로그인 필요. 전체 표는 배포 가이드 — 깃흐름.
화면에 나온 글자를 마우스로 끌어 복사한 뒤, 아래 문장의 맨 끝 <화면에 나온 글자> 자리에 붙여 넣어 채팅 AI에게 보내요. 글자를 복사할 수 없으면 화면을 캡처해 같이 첨부해요(맥 ⌘ + Shift + 4, 윈도우 윈도우키 + Shift + S).
흐름(HRUM) 「메타버스 만들기」 전자책의 부록 D(막힐 때)를 따라 하다가 막혔어요. 저는 컴퓨터와 코딩을 잘 몰라요. 무엇을 누르거나 입력하면 되는지 한 번에 한 단계씩, 모르는 말은 쉬운 말로 풀어서 알려 주세요. 제가 쓰는 컴퓨터는 <맥 또는 윈도우> 예요. 화면에 나온 글자는 아래와 같아요. <화면에 나온 글자>
그래도 안 풀리면 부록 D의 표에서 같은 글자를 찾아봐요.
이 장은 2026-11-14 의 흐름 콘솔 화면과 공간 페이지를 기준으로 썼어요. 화면 글자는 바뀔 수 있으니, 다르면 콘솔 화면을 따라요.
AI용 분할본 · 지도 막히면 · 이 페이지 전에 읽을 페이지: PART 0 시작하기 · 이 책에는 받을 코드가 없다 — 콘솔 화면과 명령 출력으로 진행한다