콘텐츠로 이동
NP Editor 문서

설치와 첫 실행

NP Editor 는 Windows 용 설치 파일 하나로 배포합니다. 관리자 권한 없이 지금 사용자 계정에만 설치됩니다. 화면에 보이는 이름은 「Noplatea Editor」이고, 줄여서 NP Editor 라고 부릅니다.

준비물

섹션 제목: “준비물”
항목내용
운영체제Windows 64비트
.NET따로 설치하지 않습니다. 설치 파일에 들어 있습니다.
마인크래프트이 PC 에 런처로 설치한 바닐라 클라이언트가 있어야 합니다. 블록 텍스처와 모델을 그 jar 에서 읽습니다.
그래픽게임 화면(F6) · 경로 추적(F7) 보기 모드는 Forward+ 렌더러와 컴퓨트 셰이더가 필요합니다.
Java (선택)「서버 jar 로 블록 목록 만들기」를 쓸 때만 필요합니다. 서버를 돌리는 Java 면 됩니다.

마인크래프트 jar 는 에디터 폴더나 저장 파일로 복사하지 않습니다. 실행 중에 이 PC 의 jar 에서 직접 읽어 메모리에서만 씁니다.

설치하기

섹션 제목: “설치하기”
  1. 설치 파일 NPEditor_Setup_<판>.exe 를 받습니다(예: NPEditor_Setup_0.9.11.exe).
  2. 에디터가 켜져 있으면 먼저 닫습니다.
  3. 설치 파일을 실행합니다. 설치 화면은 한국어입니다.
  4. 설치 위치를 고르는 화면에서 폴더를 정합니다. 기본값은 %LOCALAPPDATA%\Programs\NP Editor 입니다.
  5. 설치가 끝나면 마지막 화면의 「Noplatea Editor 실행」을 켜 둔 채 닫습니다. 에디터가 바로 켜집니다.

설치 파일은 다음 바로 가기를 만듭니다.

위치바로 가기
시작 메뉴 › Noplatea EditorNoplatea Editor · Noplatea Editor 제거
바탕 화면Noplatea Editor

설치 폴더 안

섹션 제목: “설치 폴더 안”
경로내용
NPEditor.exe · NPEditor.pck에디터 본체
data_NPEditor_windows_x86_64\.NET 런타임과 에디터 라이브러리
mcp\NPEditorMcp.exeAI 연결(MCP) 서버. AI 연결(MCP) 참고
skills\np-editor-builder\AI 연결용 작업 설명서
samples\예제 월드 castle.npworld · elder_sanctuary.npworld
licenses\라이선스 고지
Uninstall.exe제거 프로그램

조용히 설치하기

섹션 제목: “조용히 설치하기”

명령 줄에서 화면 없이 설치할 수 있습니다.

하고 싶은 것명령
조용히 설치NPEditor_Setup_<판>.exe /S
폴더를 정해 조용히 설치NPEditor_Setup_<판>.exe /S /D=<설치 폴더> (/D= 는 맨 끝에 씁니다)
조용히 제거"<설치 폴더>\Uninstall.exe" /S

처음 켜기

섹션 제목: “처음 켜기”
  1. 시작 메뉴나 바탕 화면의 「Noplatea Editor」를 누릅니다.
  2. 시작 화면(NP 큐브와 「불러오는 중… · Loading…」)이 잠깐 보입니다.
  3. 로그인 화면이 나오면 로그인합니다(아래 「로그인」).
  4. 에디터가 빈 월드(「제목 없음」)로 열립니다. 모드는 블록 브러시입니다.
  5. 대상 버전의 클라이언트 jar 를 자동으로 찾아 블록 텍스처를 읽습니다.

에디터는 지난번에 연 월드를 자동으로 다시 열지 않습니다. 월드는 파일 › 열기…(Ctrl+O)로 엽니다. 예제 월드는 설치 폴더의 samples\ 에 있습니다.

0.9.9 부터: 켤 때 Godot 로고 대신 NP Editor 시작 화면이 나옵니다.

로그인

섹션 제목: “로그인”

일부 공개 베타 설치본은 초대받은 계정으로 로그인해야 에디터가 열립니다. 로그인이 필요 없는 설치본에서는 이 화면이 나오지 않습니다.

항목내용
로그인 화면「이메일」 · 「비밀번호」 칸과 「로그인」 · 「종료」 버튼이 있습니다.
계정 만들기화면에서 가입할 수 없습니다. 초대해 준 사람이 계정을 만들어 줍니다.
다음 실행한 번 로그인하면 다음부터는 바로 열립니다.
인터넷 없이 쓰기마지막 확인 뒤 7일까지 인터넷 없이 쓸 수 있습니다.
서버 확인켜져 있는 동안 6시간마다 계정을 확인합니다.
계정 메뉴도움말 › 계정: 비밀번호 바꾸기 · 도움말 › 계정: 로그아웃
로그인 정보 파일%APPDATA%\NPEditor\account.json

0.9.3 부터: 로그인 기능이 생겼습니다. AI 연결(MCP) 서버도 에디터에서 로그인한 계정이 있어야 시작합니다.

마인크래프트 jar 자동 찾기

섹션 제목: “마인크래프트 jar 자동 찾기”

에디터는 켤 때 이 PC 의 런처 폴더에서 바닐라 클라이언트 jar 를 찾습니다. 같은 버전이 여러 곳에 있으면 위쪽 런처를 씁니다.

순서런처찾는 폴더
1CurseForge%USERPROFILE%\curseforge\minecraft\Install\versions
2공식 런처%APPDATA%\.minecraft\versions
3Prism Launcher%APPDATA%\PrismLauncher\libraries\com\mojang\minecraft
4MultiMC%APPDATA%\MultiMC\libraries\com\mojang\minecraft
5TLauncher%APPDATA%\.tlauncher\legacy\Minecraft\game\versions
6Modrinth App%APPDATA%\ModrinthApp\meta\versions · %APPDATA%\com.modrinth.theseus\meta\versions
7공식 런처(홈)%USERPROFILE%\.minecraft\versions
8직접 고른 jar파일 › jar 불러오기… 로 고른 파일
  • 바닐라 버전 폴더만 씁니다. Forge · NeoForge · Fabric · Quilt · OptiFine 같은 모드 로더 폴더는 건너뜁니다.
  • jar 가 없으면 「마인크래프트 <버전> 클라이언트 jar 를 못 찾음」 알림이 뜹니다. 런처로 그 버전을 한 번 실행한 뒤 다시 켜거나, 파일 › jar 불러오기… 로 jar 를 직접 고릅니다.
  • 런처로 새 버전을 설치했다면 파일 › 런처 폴더 다시 찾기 (버전 목록)을 누릅니다.

대상 버전 고르기

섹션 제목: “대상 버전 고르기”

메뉴 막대 오른쪽 끝의 「대상 버전」 드롭다운에서 맵을 만들 마인크래프트 판을 고릅니다. 기본값은 1.21.11 입니다.

항목내용
목록이 PC 에서 찾은 바닐라 버전입니다. 줄마다 「버전 · 런처 이름」이 보이고, jar 가 없으면 「jar 없음」이 붙습니다.
「목록 있음」그 버전의 블록 목록(서버 리포트)이 이미 만들어져 있다는 뜻입니다.
고르면그 버전 jar 로 텍스처를 바꾸고, 블록 목록 · 내보내기 검사도 그 버전을 따릅니다.
저장프로젝트 설정의 「대상 버전」과 같은 값입니다. 월드 파일에 저장됩니다.

블록 목록(서버 리포트)이 없으면 파일 › 서버 jar 로 블록 목록 만들기… (대상 버전)으로 만듭니다. 서버 jar 를 고르면 Java 로 데이터 리포트를 만듭니다. 수십 초 걸리며 버전마다 한 번만 하면 됩니다. 자세한 내용은 마인크래프트 버전을 봅니다.

저장과 자동 저장

섹션 제목: “저장과 자동 저장”
항목내용
월드 파일.npworld 입니다. 파일 › 저장(Ctrl+S) · 파일 › 다른 이름으로 저장…(Ctrl+Shift+S)
프로젝트 폴더월드 파일이 있는 폴더입니다. 커스텀 블록·모델 등록부(assets\), 내보내기 결과(export\), 스크린샷(shots\)이 여기에 생깁니다.
안전한 저장임시 파일에 먼저 쓰고 바꿔치기합니다. 이전 파일은 .bak 으로 남습니다.
되살리기저장 도중 꺼졌다면, 다음에 그 월드를 열 때 남은 .tmp · .bak 에서 되살립니다.
자동 저장바뀐 것이 있으면 120초마다 백그라운드로 저장합니다. 원래 파일은 건드리지 않습니다.
자동 저장 위치%APPDATA%\NPEditor\autosave\<이름>_<경로 해시>.npworld (제목 없는 월드는 untitled.npworld)
보관 개수10개를 넘으면 오래된 것부터 지웁니다.
자동 저장 불러오기파일 › 자동 저장 불러오기 = 가장 새 자동 저장 파일을 엽니다. 연 뒤에는 「다른 이름으로 저장」으로 저장합니다.
끌 때저장하지 않은 변경이 있으면 「저장 후 종료」 · 「저장 안 하고 종료」 · 「취소」를 묻습니다. 저장하지 않고 끝내도 자동 저장 파일에는 남깁니다.

자동 저장 간격과 보관 개수는 설정의 「자동 저장」에서 바꿉니다.

새 판으로 업데이트하기

섹션 제목: “새 판으로 업데이트하기”
  1. 에디터를 닫습니다.
  2. 새 설치 파일을 실행합니다.
  3. 지난번 설치 폴더가 기본값으로 나옵니다. 그대로 설치합니다.
  • 프로그램 파일(data_NPEditor_windows_x86_64\ · mcp\ · skills\np-editor-builder\ · licenses\)은 지우고 새로 넣습니다.
  • samples\ 는 같은 이름 파일만 덮어씁니다.
  • 만든 월드, 설정, 단축키, 프리팹, 플러그인(사용자 데이터 폴더)은 그대로 남습니다.
  • 지금 판은 도움말 › 정보 / 라이선스 에서 확인합니다.

제거하기

섹션 제목: “제거하기”
  1. Windows 설정의 앱 목록에서 「Noplatea Editor」를 제거하거나, 시작 메뉴의 「Noplatea Editor 제거」를 누릅니다.
  2. 제거 프로그램이 바로 가기, 프로그램 파일, samples\, 레지스트리 항목을 지웁니다.
  3. 설치 폴더에 직접 넣은 파일이 남아 있으면 폴더는 지우지 않고 그 목록을 알려 줍니다.

제거해도 아래 사용자 데이터 폴더와 직접 저장한 월드 파일은 남습니다. 모두 지우려면 그 폴더를 직접 지웁니다.

사용자 데이터 폴더

섹션 제목: “사용자 데이터 폴더”
폴더 · 파일내용
%APPDATA%\NPEditor\settings.cfg에디터 환경설정 · 도킹 레이아웃 · 보기 설정
%APPDATA%\NPEditor\shortcuts.json바꾼 단축키
%APPDATA%\NPEditor\autosave\자동 저장 파일
%APPDATA%\NPEditor\prefabs\프리팹
%APPDATA%\NPEditor\project\아직 저장하지 않은 월드의 프로젝트 폴더
%APPDATA%\NPEditor\plugins\외부 플러그인 폴더
%APPDATA%\NPEditor\plugins_state.json · plugin_settings\플러그인 켜기/끄기 상태 · 플러그인별 설정
%APPDATA%\NPEditor\account.json로그인 정보(로그인을 쓰는 설치본)
%APPDATA%\NPEditor\mcp\AI 연결 다리 연결 정보
%APPDATA%\NPEditor\logs\실행 기록(로그 파일)
%LOCALAPPDATA%\NPEditor\versions\<버전>\버전별 블록 목록(서버 리포트) 캐시
%LOCALAPPDATA%\NPEditor\texture_index\ · block_colors\텍스처 색인 · 블록 색 캐시(그림은 저장하지 않음)
문서\NPEditor\looks\ · 문서\NPEditor\shaderpacks\저장한 대기·조명 느낌 · 만든 셰이더팩

캐시 폴더(%LOCALAPPDATA%\NPEditor\)는 지워도 됩니다. 다음에 필요할 때 다시 만듭니다.

관련 문서

섹션 제목: “관련 문서”