설정
설정은 두 가지입니다. 에디터 환경설정은 이 PC 의 사용자마다 저장되고 모든 월드에 적용됩니다. 프로젝트 설정은 월드 파일 안에 저장되고 그 월드에만 적용됩니다.
| 창 | 여는 방법 | 저장 위치 |
|---|---|---|
| 에디터 환경설정 | 편집 › 에디터 환경설정… (Ctrl+,) | %APPDATA%\NPEditor\settings.cfg |
| 프로젝트 설정 | 편집 › 프로젝트 설정… | 지금 월드 파일(.npworld) |
| 성능 설정 | 도구 › 성능 설정… (보기 거리·LOD·그림자·스레드) | settings.cfg (환경설정 「성능」과 같은 값) |
| 단축키 | 도구 › 단축키… (Ctrl+Alt+K) | %APPDATA%\NPEditor\shortcuts.json |
설정 창 쓰는 법
섹션 제목: “설정 창 쓰는 법”에디터 환경설정과 프로젝트 설정은 같은 모양의 창입니다.
| 부분 | 내용 |
|---|---|
| 왼쪽 위 「설정 검색」 | 이름 · 설명 · 영어 키워드로 모든 칸에서 찾습니다. |
| 왼쪽 칸 목록 | 분류입니다. 기본값에서 바꾼 설정 수가 함께 보입니다. |
| 오른쪽 속성 표 | 줄마다 이름 · 값 편집기가 있습니다. 이름에 마우스를 올리면 설명이 나옵니다. |
| 「기본값으로」 화살표 | 바꾼 줄에만 보입니다. 누르면 그 줄을 기본값으로 돌립니다. |
| 다시 시작 표시 | 다시 시작해야 적용되는 설정에 붙습니다. |
값은 바꾸는 즉시 적용됩니다. 에디터 환경설정은 바로 settings.cfg 에 저장됩니다. 프로젝트 설정은 월드를 저장할 때 월드 파일에 들어가고, 바꾼 것은 되돌리기(Ctrl+Z)로 되돌릴 수 있습니다.
에디터 환경설정
섹션 제목: “에디터 환경설정”| 설정 | 기본값 | 내용 |
|---|---|---|
| 언어 · Language | 자동 (OS 언어) | 화면 글의 언어입니다. 아래 「화면 언어」 참고. 다시 시작하면 적용됩니다. |
| 도형마다 액터 만들기 | 켬 | 도형 · 브러시 한 번 = 액터 하나. 끄면 활성 폴더 · 그룹에 놓습니다. 편집 메뉴에서도 켜고 끕니다. |
| 가린 블록도 선택 | 끔 | 끌기 상자 · 화면 사각형 선택이 앞 블록에 가린 블록까지 고릅니다. |
| 소리 미리듣기 크기 | 0.8 | 소리 발생기 미리듣기 전체 크기(0~1). 툴바 슬라이더와 같습니다. |
| 설정 | 기본값 | 내용 |
|---|---|---|
| UI 배율 | 0 (자동) | 0 = 화면 크기에 맞춰 자동입니다. 0.75~3 으로 고정할 수 있습니다. 다시 시작하면 적용됩니다. |
| 떠 있는 창을 에디터 밖으로 | 켬 | 떠 있는 패널 · 도구 창을 운영체제 창으로 띄웁니다. 끄면 에디터 화면 안에만 뜹니다. |
| 테마 강조색 | #2f7cf6 | 선택 · 눌린 버튼 · 체크 상자 · 진행 막대 색입니다. |
0.9.9 부터: 「떠 있는 창을 에디터 밖으로」 설정이 생겼습니다.
뷰포트
섹션 제목: “뷰포트”| 묶음 | 설정 | 기본값 | 범위 · 내용 |
|---|---|---|---|
| 카메라 | 카메라 속도 단계 | 4 | 1~8 (4 = 12블록/초) |
| 카메라 | 카메라 속도 배율 | 1.0× | 0.05~16. 단계 × 배율 = 속도 |
| 카메라 | 마우스 감도 | 1.0× | 0.1~5. 오른쪽 버튼 둘러보기 빠르기 |
| 카메라 | 이동 가속(부드러움) | 0.07 초 | 0~0.5. WASD 가 최고 속도에 닿는 시간. 0 = 바로 |
| 카메라 | 휠 방향 반대로 | 끔 | 휠 앞뒤 · 확대와 날기 속도 바꾸기 방향을 뒤집습니다. |
| 격자·스냅 | 격자 스냅 | 1 블록 | 0~64. 소품 · 기즈모 이동 단위. 0 = 끔 |
| 격자·스냅 | 회전 스냅 | 15° | 0~90. 0 = 끔 |
| 격자·스냅 | 바닥 격자 보이기 | 켬 | G 와 같습니다. |
| 격자·스냅 | 청크 경계 보이기 | 끔 | |
| 기즈모·표시 | 기즈모 크기 | 92 px | 40~240. 손잡이 길이(UI 배율을 곱함) |
| 기즈모·표시 | 밉맵 | 켬 | 먼 블록 텍스처를 부드럽게 합니다. 끄면 또렷하지만 멀리서 반짝입니다. |
단축키
섹션 제목: “단축키”단축키 칸에는 등록된 기능 수 · 바꾼 키 수 · 충돌 수가 보입니다. 「단축키 편집…」으로 단축키 창을 엽니다. 아래 「단축키 창」 참고.
| 설정 | 기본값 | 범위 · 내용 |
|---|---|---|
| 보기 거리 | 1536 블록 | 128~4096. 이보다 먼 곳은 그리지 않습니다. |
| 먼 거리 LOD | 켬 | 멀리 있는 지형을 낮은 디테일(2³ · 4³ 블록을 한 칸)로 그립니다. |
| LOD 시작 거리 | 320 블록 | 64~4096. 이 거리부터 2단계, 두 배부터 4단계 |
| 그림자 거리 | 220 블록 | 16~2000. 짧을수록 빠르고 선명합니다. |
| 메싱 스레드 | CPU 코어 − 2 (1~6) | 0~16. 0 = 화면 스레드에서만(느림) |
| 성능 표시 | 끔 | 뷰포트 왼쪽 위 FPS · 프레임 ms · 청크 · 메모리 (Ctrl+F7) |
칸 위의 「프리셋」 버튼으로 한 번에 맞출 수 있습니다.
| 프리셋 | 보기 거리 | LOD 시작 | 그림자 | 메싱 스레드 |
|---|---|---|---|---|
| 약한 PC | 512 | 160 | 96 | 1~2 |
| 기본 | 1536 | 320 | 220 | 코어 − 2 (1~6) |
| 고사양 | 3072 | 512 | 320 | 코어 − 2 (1~8) |
가까운 곳(약 112블록 안)은 청크마다 그리고, 그 밖은 64³ 구역으로 묶어 그립니다. 모습은 같고 그리기 호출만 줄어듭니다.
자동 저장
섹션 제목: “자동 저장”| 설정 | 기본값 | 범위 · 내용 |
|---|---|---|
| 자동 저장 | 켬 | 바뀐 것이 있으면 백그라운드로 자동 저장 폴더에 씁니다. 원래 파일은 그대로입니다. |
| 간격 | 120 초 | 30~3600 |
| 보관 개수 | 10 개 | 1~100. 넘으면 오래된 것부터 지웁니다. |
자동 저장 폴더는 %APPDATA%\NPEditor\autosave\ 입니다. 파일 › 자동 저장 불러오기 로 가장 최근 것을 엽니다.
AI 연결
섹션 제목: “AI 연결”| 설정 | 기본값 | 내용 |
|---|---|---|
| AI 연결(MCP) 켜기 | 끔 | 127.0.0.1 다리를 열어 NPEditorMcp 가 이 에디터를 쓰게 합니다. 다음 실행 때도 켜집니다. |
| 다리 포트 | 0 (자동) | 0~65535. 정한 포트를 못 쓰면 자동으로 바꿉니다. |
「설정 복사 (Claude Desktop용)」 버튼은 MCP 등록 JSON 을 클립보드에 복사합니다. 자세한 내용은 AI 연결(MCP)을 봅니다.
플러그인
섹션 제목: “플러그인”불러온 플러그인 수와 경고 수가 보입니다. 「플러그인 관리자…」로 외부 플러그인을 켜고 끄고 다시 읽습니다.
화면 언어
섹션 제목: “화면 언어”| 값 | 화면 언어 |
|---|---|
| 자동 (OS 언어) | 운영체제 언어를 따릅니다. 한국어 · 일본어 · 중국어가 아니면 영어입니다. |
| 한국어 | 한국어 |
| English | 영어 |
| 日本語 | 일본어 |
| 简体中文 | 중국어 간체 |
- 편집 › 에디터 환경설정… › 일반 › 「언어 · Language」를 고릅니다.
- 에디터를 다시 시작합니다.
0.9.7 부터: 화면 글을 한국어 · 영어 · 일본어 · 중국어로 볼 수 있습니다.
프로젝트 설정
섹션 제목: “프로젝트 설정”지금 월드에만 적용됩니다. 월드 파일에 저장되고, 바꾸면 되돌리기로 되돌릴 수 있습니다.
| 칸 | 설정 | 기본값 | 내용 |
|---|---|---|---|
| 맵 정보 | 맵 이름 | (비움) | 비우면 파일 이름입니다. 내보내기 이름의 기본값입니다. |
| 맵 정보 | 설명 | (비움) | |
| 맵 정보 | 작성자 | (비움) | |
| 월드 | 대상 버전 | 1.21.11 | 블록 목록 · 내보내기 형식의 마인크래프트 판. 메뉴 막대 오른쪽 드롭다운과 같습니다. |
| 월드 | 기본 스폰 | 0, 64, 0 | 플레이어가 처음 나타나는 칸입니다. 서버 · 내보내기 메타와 플레이 「스폰 지점에서」에 씁니다. |
| 월드 | 월드 경계 크기 | 0 | 한 변 길이(가운데 = 기본 스폰). 0 = 없음 |
| 보기 | 기본 대기·조명 느낌 | (비움) | 이 월드를 열면 게임 화면(F6)을 이 프리셋으로 맞춥니다. 비우면 에디터 설정 그대로입니다. |
| 리소스팩 | 리소스팩 이름 | (비움) | 내보낼 파일 이름(<이름>_rp_vN.zip). 비우면 맵 이름 → 파일 이름 |
| 리소스팩 | 리소스팩 설명 | (비움) | pack.mcmeta 설명. § 색 코드를 쓸 수 있습니다. |
| 내보내기 | 마커 포함 | 켬 | 내보내기 창 「마커 포함」의 이 월드 기본값 |
| 내보내기 | 씬 포함 (scene.json) | 켬 | 씬 액터 · 애니메이션 · 규칙을 내보내기에 넣는 기본값 |
성능 설정 창
섹션 제목: “성능 설정 창”도구 › 성능 설정… 은 환경설정 「성능」과 같은 값을 따로 된 창으로 보여 줍니다. 위쪽에 「약한 PC」 · 「기본」 · 「고사양」 프리셋 버튼이 있습니다. 아래쪽에 CPU 코어 수와 그리는 방식 설명이 나옵니다.
- 느리면 먼저 「약한 PC」 프리셋을 누릅니다.
- 그다음 Ctrl+F7 성능 표시로 FPS 와 메싱 대기열을 봅니다.
- 큰 맵에서 멀리가 끊겨 보이면 보기 거리를 늘립니다.
단축키 창
섹션 제목: “단축키 창”도구 › 단축키… (Ctrl+Alt+K)로 엽니다. 표의 칸은 「기능」 · 「키」 · 「범위」 · 「출처」입니다.
| 버튼 · 조작 | 동작 |
|---|---|
| 검색 칸 | 기능 · 키 · 플러그인 이름으로 찾습니다. |
| 「바꾸기…」 또는 줄 두 번 클릭 | 새 키 조합을 누릅니다(Ctrl · Alt · Shift + 키). Esc = 취소 |
| 「해제」 | 그 기능의 단축키를 없앱니다. |
| 「기본값」 | 그 기능을 기본 키로 돌립니다. |
| 「모두 기본값」 | 모든 단축키를 기본값으로 돌립니다. |
| 「닫기」 | 창을 닫습니다(Esc). |
| 표시 | 뜻 |
|---|---|
| 빨간 키 | 다른 기능과 같은 키이고 범위가 겹칩니다. 둘 중 하나를 바꿉니다. |
| 노란 키 | 기본값끼리 같은 키입니다. 보통 같은 기능(메뉴와 모드)입니다. |
| 키 옆 파란 아이콘 | 기본값에서 바꾼 키입니다. |
| 「고정」 묶음 | 바꿀 수 없는 키입니다. |
바꿀 수 없는 키는 다음과 같습니다.
| 고정 키 | 기능 |
|---|---|
| Ctrl+Z · Ctrl+Y · Ctrl+Shift+Z | 되돌리기 · 다시 하기 |
| Ctrl+S | 저장 |
| Ctrl+C · Ctrl+V | 복사 · 붙여넣기 |
| Del · Esc | 지우기 · 취소 |
| W A S D Q E Space | 카메라 날기(오른쪽 버튼을 누른 동안) |
- 바꾼 키는 바로 저장됩니다. 메뉴 글의 괄호 키도 바로 바뀝니다.
- 기본 키를 옮기면 옛 키를 누를 때 「다른 키로 옮겨짐」 알림이 뜹니다.
- 외부 플러그인이 등록한 키도 이 창에 「외부 플러그인」 묶음으로 나옵니다.
콘솔 명령으로도 바꿀 수 있습니다.
| 명령 | 동작 |
|---|---|
keys | 단축키 목록(키 · 이름 · id) |
keys conflicts | 충돌 목록 |
keys set <id> <키> | 그 기능의 키 바꾸기 |
keys reset <id> | 그 기능을 기본 키로 |
keys resetall | 모두 기본값 |
콘솔에서 환경설정 바꾸기
섹션 제목: “콘솔에서 환경설정 바꾸기”| 명령 | 동작 |
|---|---|
pref | 기본값에서 바꾼 설정 목록 |
pref <검색어> | 설정 찾기 |
pref <id> <값> | 값 바꾸기(예: pref autosave/interval 300) |
pref reset <id> | 기본값으로 |
id 는 <묶음>/<키> 꼴입니다(예: camera/speed_level · perf/view_distance · ui/language).