증상을 찾아 해결 칸대로 해 봅니다. 그래도 안 되면 아래 「로그 보기」로 기록을 확인합니다.
| 증상 | 원인 | 해결 |
|---|
| 설치가 끝나지 않거나 파일을 바꿀 수 없다는 오류 | 에디터가 켜져 있습니다. | 에디터를 닫고 설치 파일을 다시 실행합니다. |
| 켜면 로그인 화면만 나옴 | 로그인을 요구하는 일부 공개 설치본입니다. | 초대받은 계정으로 로그인합니다. 계정이 없거나 비밀번호를 잊었다면 초대해 준 사람에게 문의합니다. |
| 「로그인 확인 실패」 | 서버에 연결할 수 없습니다. | 인터넷 연결을 확인합니다. 한 번 로그인했다면 7일까지는 인터넷 없이 열립니다. |
| 쓰던 중 에디터가 잠김 | 6시간마다 하는 계정 확인에서 막힌 계정입니다. | 잠기기 전에 자동 저장합니다. 초대해 준 사람에게 문의합니다. |
| AI 연결(MCP) 서버가 바로 끝남 | 로그인을 요구하는 설치본에서 에디터 로그인 정보가 없습니다. | 에디터에서 먼저 로그인합니다. AI 연결(MCP) 참고. |
| 증상 | 원인 | 해결 |
|---|
| 「마인크래프트 <버전> 클라이언트 jar 를 못 찾음」 | 런처 폴더에 그 버전 jar 가 없습니다. | 런처로 그 버전을 한 번 실행합니다. 그다음 파일 › 런처 폴더 다시 찾기 (버전 목록)을 누릅니다. 또는 파일 › jar 불러오기… 로 jar 를 직접 고릅니다. |
| 블록이 텍스처 없이 색 상자로 보임 | jar 를 읽지 못했거나, 그 블록이 지금 jar 에 없습니다. | 위 jar 해결을 먼저 합니다. 상태 알림의 「이 jar 에 없는 블록 N종」 목록을 확인합니다. |
| 다른 버전 jar 로 바꾸니 일부 블록이 깨져 보임 | 그 버전에 없는 새 블록이거나 이름이 바뀐 블록입니다. | 0.9.10 부터는 이름만 바뀐 블록(sign ↔ oak_sign · grass_path ↔ dirt_path · grass ↔ short_grass · chain ↔ iron_chain)을 그 jar 이름으로 그립니다. 그 판에 없는 블록은 이 PC 의 더 새 jar 그림으로 보여 주고 알림을 띄웁니다. 더 새 jar 가 없으면 색 상자로 보입니다. 그 블록은 대상 버전 게임에 없으니 바꿔 줍니다. |
| 「블록 목록(서버 리포트)이 없음」 | 그 버전의 블록 목록 캐시가 없습니다. | 파일 › 서버 jar 로 블록 목록 만들기… (대상 버전)으로 서버 jar 를 고릅니다. 버전마다 한 번, 수십 초 걸립니다. |
| 「java 를 찾지 못함」 | 블록 목록을 만들 Java 가 없습니다. | Java 를 설치하고 JAVA_HOME 을 정하거나 PATH 에 넣습니다. 서버를 돌리는 Java 면 됩니다. |
| 대상 버전 목록에 새로 설치한 버전이 없음 | 켤 때 한 번만 찾습니다. | 파일 › 런처 폴더 다시 찾기 (버전 목록)을 누릅니다. 모드 로더(Forge · Fabric 등) 폴더는 목록에 나오지 않습니다. |
자세한 내용은 마인크래프트 버전을 봅니다.
| 증상 | 원인 | 해결 |
|---|
| 단축키가 하나도 안 먹음 | 콘솔 · 검색 칸 같은 글 칸에 커서가 있습니다. | 뷰포트를 한 번 누릅니다. 글 칸에서도 Ctrl+S 같은 일부 키는 동작합니다(단축키 참고). |
| 단축키가 안 먹고 「다른 키로 옮겨짐」 알림 | 그 기능의 키를 단축키 창에서 바꿨습니다. | 도구 › 단축키… 에서 지금 키를 보거나 「기본값」을 누릅니다. |
| 월드 편집 키가 안 먹음 | 페인트 탭이 보이고 있습니다. | Ctrl+Tab 으로 월드 탭으로 돌아갑니다. |
| 플레이 중 편집 키가 안 먹음 | 플레이 중에는 편집 단축키가 막힙니다. | Esc 로 플레이를 끝냅니다. |
| W · E · R 기즈모가 안 나옴 | 고른 것이 없습니다. | Q 로 선택 도구를 고르고 영역 · 소품 · 액터를 고른 뒤 누릅니다. |
| 큰 작업 중에 다른 편집 · 저장이 안 됨 | 20만 칸이 넘는 작업은 여러 프레임에 나눠 적용합니다. 진행 중에는 다른 편집과 저장이 막힙니다. | 상태줄 진행률이 끝날 때까지 기다리거나 Esc · 상태줄 취소 버튼으로 취소합니다. 취소하면 적용한 부분도 되돌립니다. |
| 하늘을 가리키고 놓으면 블록이 카메라 앞에 생김 | 블록이 없는 곳은 바닥(y = 0), 바닥도 안 보이면 카메라 앞 6칸 공중에 놓습니다. | 땅이나 블록 면을 가리키고 놓습니다. |
| 끌기 상자 높이가 아래로 안 내려감 | 0.9.9 이하 동작입니다. | 0.9.10 이상으로 업데이트합니다. |
| 되돌리기가 더 안 됨 | 되돌리기 기록은 최대 200단계입니다. 편집 › 기록 지우기 를 하면 기록이 비워집니다. | 창 › 기록 패널에서 남은 단계를 확인합니다. 중요한 시점은 빠른 스냅샷(Ctrl+Alt+S)으로 남겨 둡니다. |
| 천장 · 공중 판 아래를 찍었는데 나무가 위에 심김 | 0.9.10 이하 동작입니다. | 0.9.11 부터는 찍은 층(천장 아래 바닥)에 심습니다. |
| 증상 | 원인 | 해결 |
|---|
| 가져온 OBJ · FBX · glTF 모델이 리소스팩에서 빠짐 | 「원래 모양」(삼각형)으로 가져와 마인크래프트 모델이 될 수 없습니다. | 콘텐츠 브라우저에서 모델을 오른쪽 클릭 › 「가져오기 방식 바꾸기…」로 「디스플레이」나 「블록으로 변환」을 고릅니다. 0.9.9 부터는 리소스팩을 만들 때 디스플레이로 자동 변환하고 경고합니다. |
| UV 편집기에서 OBJ · FBX · glTF 를 고칠 수 없음 | UV 편집은 .bbmodel · .npmodel · 커스텀 블록만 됩니다. | UV 를 고칠 모델은 .bbmodel 로 가져옵니다. |
자세한 내용은 커스텀 모델 가져오기 · 리소스팩과 HUD를 봅니다.
| 증상 | 원인 | 해결 |
|---|
| 큰 맵에서 느림 · 끊김 | 보기 거리 · 그림자 거리가 PC 에 비해 큽니다. | 도구 › 성능 설정… 에서 「약한 PC」 프리셋을 누릅니다. Ctrl+F7 성능 표시로 FPS 와 메싱 대기열을 봅니다. |
| 열고 나서 한동안 멀리가 비어 보임 | 청크 메시를 만드는 중입니다. | 상태줄 「메싱」 수가 0 이 될 때까지 기다립니다. 메싱 스레드를 늘리면 빨라집니다. |
| F6 게임 화면이 예전 근사 화면으로 보임 | Forward+ 렌더러를 쓸 수 없는 환경입니다. | 그래픽 드라이버를 최신으로 올립니다. |
| F7 경로 추적이 안 됨 | 컴퓨트 셰이더를 쓸 수 없는 환경입니다. | 그래픽 드라이버를 최신으로 올립니다. |
| 멀리서 맵 전체를 보면 F6 에서 지형이 하늘색으로 사라짐 | 게임의 시야 거리 끝 안개입니다. | 뷰포트 막대 「대기·조명」 패널의 「게임 화면 (F6) 보기」에서 「시야 거리 (청크)」를 늘리거나 「조망 모드 (에디터 전용)」를 켭니다(0.9.1 부터, 기본 켬). |
| F6 에서 격자가 안 보임 | 게임 화면에서는 격자를 숨깁니다. | G 를 누릅니다. |
| 떠 있는 창이 에디터 밖으로 나가는 것이 불편함 | 0.9.9 부터 운영체제 창으로 뜹니다. | 환경설정 › 외관 › 「떠 있는 창을 에디터 밖으로」를 끕니다. |
| 패널 배치가 엉킴 | — | 창 › 레이아웃 초기화 를 누릅니다. |
| 언어를 바꿨는데 그대로임 | 언어는 다시 시작해야 바뀝니다. | 에디터를 다시 켭니다. |
| 증상 | 원인 | 해결 |
|---|
| 저장하지 않고 껐음 | — | 다시 켜고 파일 › 자동 저장 불러오기 를 누릅니다. 연 뒤 「다른 이름으로 저장」으로 저장합니다. |
| 저장 도중 PC 가 꺼졌음 | — | 그 월드를 다시 엽니다. 남은 .tmp · .bak 에서 되살리고 알림에 「되살림」이 표시됩니다. |
| 「등록부를 읽을 수 없어 빈 등록부로 시작합니다」 | 프로젝트 폴더의 assets\registry.json 을 읽지 못했습니다. | 그 파일이 지워지거나 다른 프로그램이 바꾸지 않았는지 확인합니다. |
| 마인크래프트 월드로 저장한 월드가 싱글 목록에 없음 | saves 폴더에 넣지 않았습니다. | 만들어진 <이름>_world 폴더를 %APPDATA%\.minecraft\saves\(또는 쓰는 런처의 saves 폴더)에 복사합니다. |
| 구역 트리거가 싱글플레이 월드에서 안 돎 | 월드 로직은 서버 플러그인 NP Scene 이 실행합니다. | 서버용 파일을 내보내기 창(Ctrl+Shift+E)에서 만듭니다. 내보내기와 가져오기 참고. |
| 증상 | 원인 | 해결 |
|---|
| 플러그인이 꺼져 있고 오류가 보임 | 플러그인이 예외를 내면 그 플러그인만 끄고 에디터는 계속 돕니다(격리). | 도구 › 플러그인 관리자… 에서 오류 내용을 보고 다시 읽습니다. 도움말 › 플러그인 목록 에 경고가 모여 있습니다. |
| 플러그인이 목록에 없음 | 플러그인 폴더에 없습니다. | 도구 › 플러그인 폴더 열기 로 연 폴더(%APPDATA%\NPEditor\plugins\)에 넣습니다. |
플러그인을 만드는 쪽의 문제는 플러그인 개발 개요와 SDK 문제 해결 문서를 봅니다.
| 어디 | 내용 |
|---|
| 출력 로그 패널 | 에디터 · 플러그인이 남긴 모든 알림과 오류입니다. 아래 영역의 「출력 로그」 탭입니다. |
| 로그 파일 | %APPDATA%\NPEditor\logs\ 에 실행 기록 파일이 남습니다. |
| 도움말 › 플러그인 목록 | 불러온 플러그인과 등록 경고 |
| 도움말 › 정보 / 라이선스 | 에디터 판(문의할 때 함께 알려 줍니다) |