도치 에디터 사용 설명서

설치 대상 선택, 스크립트 라이브러리, 각 에디터 사용법, 문제 해결까지 한 곳에서 확인하는 한국어 매뉴얼입니다.
검색 결과가 없습니다. 다른 단어로 다시 찾아보세요.

0. 설명서 개요

도치 에디터를 처음 여는 사람부터 패키지와 JSON을 반복 제작하는 사람까지 기준으로 정리했습니다.

도치 에디터는 Minecraft 안에서 MCEF 브라우저 화면으로 열리는 CustomNPCs 작업용 편집기입니다. 에디터 본체는 화면과 파일 작업을 제공하고, 실제 콘텐츠는 Script Library에서 설치한 스크립트, HTML GUI, JSON 데이터로 구성됩니다.

지원 릴리즈

현재 릴리즈 폴더 기준으로 Forge 1.20.1, Fabric 1.21.1 jar가 있습니다.

Forge 1.20.1 Fabric 1.21.1
주요 의존 모드

기본 작업은 CustomNPCs, CNPCExtended, MCEF를 전제로 합니다. 일부 에디터는 Cobblemon, TACZ, GeckoLib 같은 추가 모드를 사용합니다.

문서 성격

영상 대본이 아니라 실제 사용 설명서입니다. 필요한 버튼과 경로를 바로 찾을 수 있도록 검색과 접기/펼치기를 넣었습니다.

가장 중요한 원칙

스크립트와 JSON은 보통 인스턴스의 minecraft/customnpcs 아래로 들어가지만, HTML GUI 파일은 활성 월드의 saves/<world>/customnpcs/scripts/ecmascript/html 아래에 들어갑니다. NPC 에디터나 HTML GUI가 잠겨 보이면 이 경로부터 확인하세요.

1. 빠른 시작

처음 설치 후 정상적으로 패키지를 설치하고 에디터를 여는 최소 흐름입니다.
모드 확인
사용 중인 로더와 버전에 맞는 도치 에디터 jar, CustomNPCs, CNPCExtended, MCEF가 mods 폴더에 들어있는지 확인합니다.
월드 접속
HTML GUI와 플레이어 스크립트 런처는 월드/플레이어 세션이 필요합니다. 타이틀 화면보다 월드 안에서 시작하는 편이 안전합니다.
에디터 열기
키 설정에 등록된 도치 에디터 열기 키를 누릅니다. 보통 F10으로 사용합니다.
설치 대상 지정
상단바의 타겟 또는 설정에서 실행 중인 Minecraft를 찾거나, 인스턴스 CustomNPCs 폴더와 월드 폴더를 직접 선택합니다.
External Saving 켜기
Script Library에서 External Saving 상태를 확인합니다. 꺼져 있으면 켠 뒤 Minecraft를 재시작합니다.
패키지 설치
메인 메뉴에서 에디터를 선택하고 라이브러리 열기를 눌러 필요한 패키지와 의존성을 설치합니다.
에디터 사용
메인 메뉴로 돌아와 잠금이 풀린 에디터를 열고 JSON을 가져오기/내보내기 하며 작업합니다.

첫 실행 체크리스트

2. 설치 준비

에디터 화면이 열리고 파일 작업이 정상 동작하기 위한 기본 조건입니다.
항목필요한 이유확인 방법
Dochi Editor에디터 화면, MCEF 브리지, 파일 작업 명령을 제공합니다.mods 폴더에 로더/버전에 맞는 jar가 있는지 확인합니다.
CustomNPCsNPC 스크립트, 플레이어 스크립트, 데이터 폴더를 사용합니다.모드 목록과 minecraft/customnpcs 폴더를 확인합니다.
CNPCExtendedHTML GUI 런타임과 확장 API를 사용합니다.HTML GUI 기반 도구가 잠겨 있으면 먼저 확인합니다.
MCEFMinecraft 안에 HTML 에디터 화면을 표시합니다.에디터 화면이 브라우저처럼 열리는지 확인합니다.
권한서버나 권한 제한 월드에서는 에디터 열기와 NPC 에디터 런처가 권한 검사를 통과해야 합니다.싱글에서는 월드 권한, 서버에서는 OP 또는 서버 설정을 확인합니다.

릴리즈 파일 선택

Forge 1.20.1 환경은 dochi_editor-forge-1.20.1-0.1.0.jar, Fabric 1.21.1 환경은 dochi_editor-fabric-1.21.1-0.1.0.jar를 사용합니다. CustomNPCs 패키지의 설치 경로 규칙은 로더가 달라도 거의 같습니다.

3. 폴더와 경로 규칙

대부분의 잠김/설치 실패는 경로가 잘못 잡혔을 때 발생합니다.
스크립트
minecraft/customnpcs/scripts/ecmascript
CustomNPCs JavaScript 파일이 들어가는 기본 위치입니다.
플레이어 스크립트 등록
minecraft/customnpcs/scripts/player_scripts.json
NPC 에디터 런처 같은 플레이어 스크립트가 등록됩니다.
HTML GUI
minecraft/saves/<world>/customnpcs/scripts/ecmascript/html
CNPCExtended HTML GUI 파일은 월드별로 설치됩니다.
대화 JSON
minecraft/customnpcs/dc_data/dc_dialogues
Dialogue Editor가 내보내는 대화 노드/세트 데이터입니다.
GUI JSON
minecraft/customnpcs/dc_data/dc_gui
GUI Maker가 내보내는 대화/상점 GUI 레이아웃입니다.
상점 JSON
minecraft/customnpcs/dc_data/dc_shops
NPC Shop 에디터가 내보내는 상점 데이터입니다.
포켓몬 파티 JSON
minecraft/customnpcs/dc_data/dc_trainers/pokemonparty
Pokemon Editor가 내보내는 트레이너 파티 스펙입니다.
몹 설정 JSON
minecraft/customnpcs/dc_mob/soulmob, minecraft/customnpcs/dc_mob/taczmob
Soulslike Mob, TACZ Mob 개발용/예정 설정입니다. 두 에디터는 아직 정식 준비 전입니다.
에디터 웹 캐시
minecraft/config/dochi_editor/web
도치 에디터 내부 UI 캐시입니다. 일반 패키지 설치 대상이 아닙니다.

HTML 파일 위치 주의

HTML GUI를 인스턴스 루트 쪽에 넣으면 에디터 카드가 계속 잠길 수 있습니다. HTML이 필요한 패키지는 반드시 작업할 월드를 연 상태에서 설치하고, Files 상세에서 대상 경로가 월드 폴더인지 확인하세요.

4. 에디터 열기와 닫기

도치 에디터 화면은 Minecraft 안에서 전체 화면 브라우저처럼 동작합니다.
동작설명확인할 것
열기키 설정에 등록된 도치 에디터 열기 키를 누릅니다. 보통 F10을 사용합니다.키 충돌이 있으면 Minecraft 키 설정에서 다시 지정합니다.
사용화면은 MCEF 기반 HTML 앱입니다. 클릭, 입력, 스크롤, 파일 선택이 일반 웹앱처럼 동작합니다.일부 파일 작업은 활성 Minecraft 인스턴스와 연결됩니다.
닫기상단바의 닫기를 누르면 확인 창이 뜨고 게임 화면으로 돌아갑니다.저장/내보내기를 끝낸 뒤 닫는 습관을 들입니다.

5. 상단바와 설치 대상

상단바는 모든 에디터에서 공통으로 쓰는 이동, 대상 선택, UI 설정 영역입니다.

공통 버튼

버튼역할팁
홈메인 메뉴로 돌아갑니다.작업 화면에서 길을 잃었을 때 안전한 시작점입니다.
설정 / 타겟현재 설치 대상과 런타임 폴더를 확인합니다.패키지 설치 전에 반드시 확인합니다.
UI언어, 테마, 글꼴, UI 배율, 오디오 설정을 바꿉니다.파일 경로에는 영향을 주지 않습니다.
닫기에디터 화면을 닫고 게임으로 돌아갑니다.확인 창에서 예/아니오를 선택합니다.

설치 대상 패널

컨트롤사용 상황결과
실행 중인 마인크래프트 찾기현재 실행 중인 인스턴스를 자동 감지하고 싶을 때감지된 루트/모드/월드 폴더 후보를 보여줍니다.
인스턴스 CustomNPCs 선택스크립트와 JSON을 설치할 minecraft/customnpcs를 직접 지정할 때대부분의 데이터 설치 기준점이 됩니다.
월드 폴더 선택HTML GUI 설치 대상이 필요한 경우활성 월드의 saves/<world>를 기준으로 사용합니다.
검사선택한 폴더가 올바른지 확인할 때mods, customnpcs, 저장 가능 여부를 점검합니다.
프리셋 저장여러 인스턴스/월드를 번갈아 사용할 때현재 대상 경로를 이름 붙여 저장합니다.
프리셋 사용저장한 대상 경로를 다시 적용할 때폴더를 다시 고르지 않고 전환합니다.

7. Script Library

스크립트, JSON, HTML GUI 패키지를 설치하고 업데이트하는 패키지 관리자입니다.

설치 흐름

Refresh
패키지 매니페스트를 다시 불러옵니다. 버전이 오래 보이면 먼저 누릅니다.
External Saving 확인
CustomNpcs.cfg의 EnableExternalSaving=true가 필요합니다. 변경 후에는 재시작이 필요할 수 있습니다.
패키지 선택
왼쪽 목록에서 패키지를 고르고, 오른쪽에서 설명/플레이어 설치 버전/최신 버전을 확인합니다.
버전 선택
보통 최신 버전을 설치합니다. 서버가 구버전 스크립트에 맞춰져 있다면 해당 버전을 선택합니다.
Dependencies 확인
필수 모드, 스크립트, HTML, JSON 대상이 표시됩니다. 빠진 의존성은 먼저 설치합니다.
Files 확인
어떤 파일이 어디에 설치되는지 확인합니다. HTML 파일은 월드 경로인지 반드시 봅니다.
Install
기존 파일이 있으면 덮어쓰기 창이 뜹니다. 변경된 파일만 골라 설치할 수 있습니다.
Library 주요 버튼
버튼/필드역할
RefreshGitHub 패키지 인덱스와 캐시를 새로고침합니다.
External SavingCustomNPCs 외부 저장 설정을 확인하거나 켭니다.
필터전체, 특정 에디터, 패키지 종류별로 목록을 줄입니다.
검색패키지명, 버전, 설명, 에디터 이름을 검색합니다.
Install선택한 버전의 파일과 의존성을 대상 폴더에 씁니다.
Overwrite Prompt기존 파일이 있을 때 덮어쓸 파일을 직접 고릅니다.

부분 설치 주의

덮어쓰기 창에서 일부 파일을 건너뛰면 “부분 설치” 상태가 될 수 있습니다. 의도한 서버 커스텀 파일을 보존하는 데는 유용하지만, 에디터가 요구하는 런타임 파일과 버전이 어긋나면 오류가 생길 수 있습니다.

8. NPC Editor 런처

NPC Editor 카드는 HTML 페이지를 여는 대신 CustomNPCs 플레이어 스크립트를 실행합니다.
체크필요 상태문제 발생 시
CustomNPCs설치됨모드 목록과 버전을 확인합니다.
CNPCExtended설치됨HTML GUI 런타임이 필요한 패키지를 다시 확인합니다.
dc_lib/dc_npc_editor.js인스턴스 스크립트 폴더에 설치됨Script Library에서 NPC Editor 관련 패키지를 설치합니다.
player_scripts.jsonNPC 에디터 스크립트 등록 포함패키지 설치 로그와 파일 내용을 확인합니다.
dc_npc_editor.html활성 월드 HTML 폴더에 설치됨작업 월드를 연 상태로 HTML 패키지를 다시 설치합니다.
플레이어 세션월드 안에 접속 중타이틀 화면이 아니라 월드 안에서 실행합니다.
권한OP 또는 필요한 권한 있음서버 권한 설정을 확인합니다.

열기를 누르면 에디터 화면이 닫히고 현재 플레이어 연결로 NPC 에디터 실행 요청이 전송됩니다. 잠겨 있으면 메인 메뉴의 Launcher Status를 먼저 읽는 것이 가장 빠릅니다.

9. Dialogue Editor

NPC 대화 흐름, 선택지, 조건, 액션, GUI 연결을 만드는 에디터입니다.
영역역할사용 팁
Dialogue Sets대화 노드를 세트 단위로 묶습니다.+ 세트 추가 후 세트 안에 노드를 추가합니다.
Current Node Info노드 타입, 세트 이름, 노드 종류를 관리합니다.시작 노드는 라우트, 일반 노드는 선택지 중심으로 구성합니다.
TextNPC 대화 텍스트와 텍스트 FX를 편집합니다.긴 문장은 큰 화면으로 편집하면 편합니다.
Default GUI대화가 사용할 GUI JSON을 지정합니다.기본 GUI 또는 Search GUI로 만든 GUI를 연결합니다.
Routes시작 노드의 자동 이동/조건/액션을 설정합니다.조건에 따라 다른 노드나 상점으로 보낼 수 있습니다.
Choices플레이어 선택지, 조건, 액션, FX를 설정합니다.선택지 액션은 goto, close, shop, command, stored data 등을 조합합니다.
Overview현재 노드와 선택지 결과를 읽기 쉽게 확인합니다.대화 내용 검수에 좋습니다.
Blueprint노드와 선택지 연결을 시각적으로 확인합니다.Undo/Redo와 Zoom을 이용해 큰 대화 그래프를 점검합니다.
Dialogue Editor 작업 순서
  1. 세트를 만들고 첫 노드를 추가합니다.
  2. 노드 타입을 정하고 대화 텍스트를 입력합니다.
  3. 필요한 선택지를 추가하고 각 선택지의 액션을 지정합니다.
  4. GUI Maker에서 만든 GUI가 있으면 Default GUI를 custom으로 바꾸고 JSON을 연결합니다.
  5. Overview와 Blueprint에서 끊어진 노드나 잘못된 이동을 확인합니다.
  6. Export로 dc_data/dc_dialogues 아래에 저장합니다.

가져오기 형식

대화 노드 JSON은 선택지 배열 이름으로 choice를 사용합니다. choices 형식의 오래된 파일은 가져오기에서 거부될 수 있으니 변환 후 사용하세요.

10. GUI Maker

대화와 상점에서 사용할 GUI 레이아웃 JSON을 시각적으로 만드는 도구입니다.
기능설명주의
GUI TypeDialogue GUI와 Shop GUI를 선택합니다. Quest GUI는 이후 확장용입니다.상점에 연결할 GUI는 Shop GUI 타입이어야 합니다.
CanvasGUI 이름, 배경 이미지, 런타임 경로, 배경/오버레이 색과 투명도를 설정합니다.미리보기 이미지 경로와 런타임 에셋 경로는 따로 저장됩니다.
Add BoxDialogue, Image, Entity, Choice, Page Nav, Shop Title, Item Slots 등 구성요소를 추가합니다.GUI Type에 따라 보이는 컴포넌트가 달라집니다.
Stage실제 배치 화면입니다. 요소를 선택, 이동, 정렬, 크기 조절합니다.레이어 번호가 높을수록 앞에 보입니다.
Inspector선택한 요소의 위치, 크기, 색, 텍스트, 애니메이션, 경로를 편집합니다.여러 요소를 선택하면 일부 세부 편집이 비활성화될 수 있습니다.
Cropper이미지를 잘라 배경이나 버튼 텍스처로 사용합니다.드래그로 선택하고 휠로 확대합니다. Shift는 비율 유지에 사용됩니다.
Import / ExportGUI JSON을 불러오거나 저장합니다.내보낸 파일은 보통 dc_data/dc_gui 아래에 둡니다.

좋은 GUI 제작 습관

대화용 GUI는 먼저 Standard Dialogue 프리셋으로 구조를 만든 뒤 필요한 이미지와 선택지 배치를 바꾸면 빠릅니다. 상점용 GUI는 NPC Shop의 Pick GUI로 연결할 수 있도록 Shop GUI 타입으로 내보내세요.

11. NPC Shop

상점 JSON, 접근 조건, GUI 연결, 상품 목록과 재고 규칙을 편집합니다.
탭설정 항목설명
IdentityShop ID, Shop Name, File Name상점의 고유 ID와 저장 파일 이름을 정합니다.
CurrencyItem, StoredData, CobbleDollar상점 기본 화폐를 정합니다. 상품마다 오버라이드도 가능합니다.
Restock재입고 사용 여부, 틱 간격기본 재고와 NPC별 현재 재고 처리에 영향을 줍니다.
Access & GUIGUI Source, GUI JSON Path, Access Guard상점 GUI 연결과 접근 조건을 설정합니다.
Product카테고리, 상품, 가격, 재고, 아이템 ID/NBT실제 판매 목록을 작성합니다.

상품 편집 체크포인트

  • 상품 ID는 중복될 수 없습니다. 이름을 바꾸면 ID도 같이 정리되는지 확인하세요.
  • 아이템 타입이 ID이면 minecraft:stone 같은 아이템 ID가 필요합니다.
  • 아이템 타입이 NBT이면 전체 아이템 NBT가 비어 있으면 안 됩니다.
  • Base Stock이 -1이면 무한 재고입니다.
  • 카테고리를 삭제하면 포함 상품은 남은 첫 카테고리로 이동합니다.

12. Pokemon Editor

Cobblemon 트레이너 파티 스펙 JSON을 편집합니다.
영역설명
Trainer트레이너 이름과 파티 전체 정보를 설정합니다.
AIAI 타입과 선택 여백 같은 전투 판단 값을 설정합니다.
Pokemon포켓몬 선택, 레벨, 지닌 도구, 볼, 타입을 설정합니다.
Nature / Ability / Moves성격, 특성, 최대 4개 기술을 검색 오버레이로 선택합니다.
Stats / IVs / EVs개별 능력치, 개체값, 노력치를 숫자로 편집합니다.
Preview현재 파티 구성을 카드 형태로 확인합니다.
JSON EditorJSON을 직접 가져오기/내보내기/적용합니다.

선택 오버레이

포켓몬, 특성, 성격, 기술 선택 화면은 검색과 페이지 이동을 지원합니다. 포켓몬 데이터나 이미지는 외부 데이터베이스에서 불러올 수 있으므로 네트워크가 막힌 환경에서는 일부 미리보기가 늦거나 비어 보일 수 있습니다.

13. Trainer Editor

트레이너 NPC의 감지, 배틀 라운드, 조건, 보상, 연출 흐름을 설정합니다.
카테고리핵심 설정설명
Basic표시 영역, 손 아이템/볼, 이동 속도, 체력, 감지 방식, 위치 재배치, 대시, 배틀 느낌표NPC 기본 동작과 배틀 시작 전 감지 조건을 정합니다.
Battle리매치, 라운드, 트레이너 스펙 JSON, 배틀 포맷, 아이템 제한, 시작 지연, 배틀 대화, 배틀 전 시퀀스실제 배틀 라운드와 시작 연출을 구성합니다.
Condition조건 모드, StoredData, 태그, 아이템, FTB, Cobblemon, CobbleDollar 조건배틀 진행 가능 여부나 분기 조건을 설정합니다.
After보상, 보상 모드, 배틀 후 시퀀스전투 종료 후 지급과 연출을 설정합니다.
Data Tools복사/붙여넣기, 기존 JSON에서 추출라운드별 설정을 재사용할 때 사용합니다.
Flow Guide런타임 해석 순서 설명현재 설정이 엔진에서 어떤 순서로 처리되는지 확인합니다.
추천 제작 순서
  1. 프리셋을 하나 적용해 기본 구조를 만듭니다.
  2. Basic에서 감지 방식과 기본 스탯을 조정합니다.
  3. Pokemon Editor에서 만든 트레이너 스펙 JSON을 Battle 라운드에 연결합니다.
  4. 배틀 전 시퀀스와 배틀 대화가 필요하면 Dialogue/GUI와 연결합니다.
  5. Condition에서 입장 조건을 넣고 After에서 보상과 종료 시퀀스를 넣습니다.
  6. Export로 트레이너 설정 JSON을 저장합니다.

14. Soulslike Mob Editor

아직 개발 중인 기능입니다. 현재 내용은 예정 구조와 개발 참고용입니다.

개발 중

Soulslike Mob Editor는 아직 정식 제작용으로 준비되지 않았습니다. 이 섹션의 표와 설명은 구현 방향을 남겨둔 것이며, 실제 서버/배포 월드 작업에는 사용하지 않는 것을 권장합니다.

단계주요 내용
Project프로젝트 이름, 기본 체력/속도, 애니메이션 이름, 공격 간격, AI 틱 같은 기본값을 설정합니다.
Pattern패턴 이름, 모드, 트리거, 지속시간, 거리, 가중치, 태그, 조건을 설정합니다.
Events이벤트 시간, 타입, 데미지, 범위, 아크, 오프셋, 히트박스 스텝을 편집합니다.
Effects모션, 방패 파괴/쿨다운, 사운드, 포션 효과, 파티클을 설정합니다.
Model PreviewGLB/GLTF 모델을 불러와 히트박스와 함께 회전/확대/오프셋을 확인합니다.
Import / Exportdc_mob/soulmob 기준으로 JSON을 열고 저장합니다.

히트박스 프리뷰는 실제 런타임 충돌을 이해하기 위한 제작 보조 화면입니다. 데미지, 반경, 오프셋, 아크 값을 바꿀 때마다 프리뷰를 보며 공격 범위가 의도와 맞는지 확인하세요.

15. TACZ Mob Editor

아직 개발 중인 기능입니다. TACZ 몹 제작 기능은 정식 사용 준비 전입니다.

개발 중

TACZ Mob Editor는 아직 정식 제작용으로 준비되지 않았습니다. TACZ 데이터 스캔과 전투 프로필 편집 흐름은 개발 중인 구조이므로, 현재 설명은 기능 계획과 테스트 참고용으로 봐주세요.

영역설명
Profile프로필 이름, 감지/교전 거리, 근접 전환 거리, 높이 제한, 기본/원거리/근접 속도를 설정합니다.
Weapon총기 카테고리 아이템, 총 모델, 탄약, 탄환 아이템, 발사 속도, 딜레이, 연사 수, 데미지를 설정합니다.
Load Gun Info현재 Minecraft 대상의 TACZ 폴더를 스캔해 총기/탄약/부착물 데이터를 불러옵니다.
Attachments조준경, 총구, 스톡, 그립, 확장 탄창, 레이저를 선택합니다.
Accuracy Graph거리별 명중률, 이동 사격 페널티, 연사 후반 명중률 저하를 그래프로 조정합니다.
Melee / Dash근접 무기, 근접 데미지, 피격 대시, 대시 확률과 파워를 설정합니다.
Grenade퓨즈, 투척 파워, 각도, 사용 거리, 탐색 거리, 쿨다운, 투척 아이템 ID를 설정합니다.
Evaluation현재 빌드의 안정성, 압박, 근접 대응, 위험 요인을 요약합니다.

TACZ 데이터 스캔

총기 목록과 부착물 목록은 현재 설치 대상의 TACZ 데이터에 의존합니다. Load Gun Info가 실패하면 설치 대상이 올바른 Minecraft 인스턴스인지, TACZ와 gun pack이 실제로 들어있는지 확인하세요.

16. JSON 가져오기/내보내기

대부분의 에디터는 JSON을 만들고 수정하는 방식으로 최종 콘텐츠를 저장합니다.
동작설명권장 습관
Import기존 JSON을 불러와 현재 에디터 상태로 변환합니다.가져오기 전에 원본 파일을 백업해 둡니다.
Export현재 상태를 런타임이 읽을 JSON으로 저장합니다.큰 변경 후에는 바로 Export해서 임시 상태 손실을 막습니다.
JSON Editor일부 에디터는 JSON 텍스트를 직접 편집할 수 있습니다.문법 오류가 있으면 적용/내보내기가 막힙니다.
파일명대부분 ID 또는 프로젝트 이름 기반으로 파일명을 만듭니다.공백보다 소문자, 숫자, 밑줄 중심의 파일명이 안전합니다.

백업 기준

Script Library 설치 전, 큰 JSON 구조 변경 전, 여러 파일 덮어쓰기 전에는 해당 폴더를 복사해 두는 것이 좋습니다. 덮어쓰기 창에서 일부 파일을 보존할 수 있지만, 수동 백업이 가장 확실합니다.

17. 문제 해결

잠김, 설치 실패, 경로 오류, 데이터 오류를 빠르게 좁히는 표입니다.
증상가능한 원인해결
에디터 카드가 잠김의존 모드, 스크립트, HTML, 권한, 월드 세션 중 하나가 부족합니다.메인 메뉴의 의존 모드와 Launcher Status를 읽고, Script Library에서 필요한 패키지를 설치합니다.
Script Library 설치 실패설치 대상 미설정, 월드 폴더 없음, 네트워크/패키지 오류, 쓰기 권한 문제입니다.대상 검사, Files 경로 확인, Refresh 후 재시도합니다.
External Saving이 꺼져 있음CustomNpcs.cfg의 EnableExternalSaving=false 상태입니다.External Saving 버튼으로 켠 뒤 Minecraft를 재시작합니다.
HTML 설치 후에도 도구가 잠김HTML이 월드 폴더가 아닌 인스턴스 폴더에 들어갔거나 다른 월드에 설치되었습니다.작업할 월드를 열고 HTML 패키지를 다시 설치합니다.
NPC Editor가 열리지 않음플레이어 스크립트 미등록, HTML 누락, 권한 부족, 월드 세션 없음입니다.dc_lib/dc_npc_editor.js, player_scripts.json, dc_npc_editor.html, 권한을 확인합니다.
패키지 버전이 오래 보임패키지 인덱스 캐시가 남아 있습니다.Script Library에서 Refresh를 누릅니다.
이미지나 큰 파일 설치 실패구버전 jar, 캐시 문제, 파일 쓰기 실패일 수 있습니다.최신 jar로 교체하고 Minecraft를 재시작한 뒤 다시 설치합니다.
Pokemon 목록/이미지가 비어 있음외부 데이터베이스 접근이 막혔거나 응답이 느립니다.네트워크 상태를 확인하고, 필요한 값은 JSON에 직접 입력합니다.
Shop Export가 막힘상점 ID, 상품 ID, 아이템 ID/NBT, 화폐 값 등 필수값이 비어 있습니다.상단 오류 메시지와 Product Detail을 확인해 빈 값을 채웁니다.
GUI가 런타임에서 다르게 보임미리보기 이미지 경로와 런타임 에셋 경로가 다르거나 폰트/텍스처가 설치되지 않았습니다.GUI Maker의 Runtime Path와 실제 리소스팩/에셋 위치를 맞춥니다.

Manual feedback

Leave questions, corrections, or suggestions through GitHub Discussions.