「추가」에 돌벽돌 계단 탑 프리셋을 더하는 예제 · id hello_tool · SDK ^1.1 · 최신판 1.1.0
관리자 창 이름은 「계단 탑 (예제)」입니다. 등록점 여러 개를 한 플러그인에서 쓰는 법을 보여 줍니다.
| 보여 주는 것 | 코드 |
|---|
| 빠른 추가 + 되돌리기 1단계 | AddQuickAddItem · World.Edit |
| 설정 패널 | AddContentTab · NpUi |
| 콘솔 명령 | AddCommand |
| 단축키 | AddShortcut |
| 3D 겹쳐 그리기 | host.Draw |
| 설정 저장 | host.Settings |
| 새 월드에서 상태 비우기 | WorldChanged |
| 항목 | 값 |
|---|
| 에디터 | 0.9.0 이상 |
| SDK | 1.1 이상(^1.1) |
| 의존 플러그인 | 없음 |
| 소스 | NP Editor 소스의 samples/plugins/hello_tool/ (Plugin.cs · HelloTool.csproj · plugin.json) |
- 빌드합니다.
dotnet build samples/plugins/hello_tool/HelloTool.csproj -c Release
NP.Editor.Sdk.dll 을 참조하도록 바꿉니다.
- 빌드 출력의
HelloTool.dll 과 plugin.json 을 %APPDATA%\NPEditor\plugins\hello_tool\ 에 복사합니다(도구 › 플러그인 폴더 열기). NP.Editor.Sdk.dll 은 넣지 않습니다.
- 도구 › 플러그인 관리자… 에서 「다시 훑기」를 누릅니다. 처음이면 경고에서 「믿을 수 있음 — 불러오기」를 누릅니다.
- 「계단 탑 (예제)」가 「켜짐」이면 됩니다.
- 바닥 블록 위에 마우스를 둡니다.
- 메인 툴바 「추가」를 열고 「탑」을 검색합니다.
- 분류 「프리셋」의 「계단 탑」을 누릅니다. 마우스 아래 칸을 모서리로 5×5 탑이 생깁니다.
- Ctrl+Alt+H 를 누릅니다. 탑 둘레에 파란 상자와 「계단 탑 #1」 이름표가 나옵니다.
- Ctrl+Z 한 번으로 탑 전체가 사라집니다.
| 종류 | 이름 | 설명 |
|---|
| 빠른 추가 | 「추가」 › 프리셋 › 계단 탑 | ctx.Place 를 가장 작은 x · z 모서리로 탑을 짓습니다. 검색 낱말: tower stair 탑 계단 나선 |
| 패널 | 계단 탑 | 높이 · 벽 블록 · 계단 나무 설정, 지은 수, 「선택 가운데에 짓기」 단추. 창 메뉴에서 엽니다. |
| 명령 | tower [높이] | (0, 1, 0) 에 탑을 짓습니다. 높이는 4~64 로 맞춥니다. 결과: 계단 탑 높이 12 — <칸 수>칸 |
| 단축키 | 계단 탑: 탑 표시 켜기/끄기 (Ctrl+Alt+H) | 이 월드에서 지은 탑마다 둘레 상자 + 이름표를 그리거나 지웁니다. |
| 단축키 | 계단 탑: 마지막 자리 옆에 또 짓기 (Ctrl+Alt+J) | 마지막 탑에서 x 로 7칸 옆에 짓습니다. 지은 탑이 없으면 (0, 1, 0) 입니다. |
| 이벤트 | WorldChanged | 새 월드 · 열기에서 지은 탑 목록과 그림을 비웁니다. |
| 부분 | 내용 |
|---|
| 벽 | 5×5 둘레, 높이 = 설정 「높이」, 블록 = 설정 「벽 블록」 |
| 문 | 가장 작은 z 쪽 벽 가운데, 아래 2칸 |
| 창 | 4층마다(y % 4 == 2) 네 벽 가운데 한 칸 |
| 가운데 기둥 | (2, 2) 칸, 벽 블록 |
| 계단 | 기둥 둘레 8칸을 돌며 한 층에 한 칸씩 오르는 나선. minecraft:<계단 나무>_stairs |
| 지붕 | 돌벽돌 반 블록 + 흉벽, 계단 끝 위에 나가는 구멍 |
탑 하나는 World.Edit 한 번(되돌리기 라벨 계단 탑 ×<높이>)입니다.
| 줄 | 종류 | 하는 일 |
|---|
| 높이 | 숫자 4~64 | 탑 높이. 바꾸면 바로 저장 |
| 벽 블록 | 글 | 벽 · 기둥 블록 상태 글. 바꾸면 바로 저장 |
| 계단 나무 | 글 | 계단 나무 이름(oak · spruce · birch …). 바꾸면 바로 저장 |
| 만든 탑 … | 살아 있는 글 | 이 월드에서 지은 수 · 지금까지 지은 수 · 월드 블록 수 |
| 선택 가운데에 짓기 | 단추 | 선택 상자 가운데 · 바닥 높이에 짓습니다. 선택이 없으면 알림만 |
host.Settings 에 저장합니다. 파일은 %APPDATA%\NPEditor\plugin_settings\hello_tool.json 입니다.
| 키 | 형식 | 기본값 | 설명 |
|---|
height | 정수 | 12 | 탑 높이(패널 「높이」) |
wall | 글 | minecraft:stone_bricks | 벽 블록(패널 「벽 블록」) |
stair_wood | 글 | oak | 계단 나무(패널 「계단 나무」) |
towers | 정수 | 0 | 지금까지 지은 탑 수(모든 월드 합계) |
- 벽 블록 · 계단 나무 글은 검사하지 않습니다. 틀리면 텍스처 없는 블록이 놓입니다.
tower <높이> 로 바꾼 높이는 이번 실행에만 쓰고 저장하지 않습니다. 패널의 높이 칸도 바뀌지 않습니다.- 탑 표시(Ctrl+Alt+H)는 이 월드에서 플러그인으로 지은 탑만 그립니다. 되돌리기로 지운 탑의 상자는 남습니다.
- 패널의 숫자 · 글 칸 처음 값은 플러그인을 켤 때의 설정입니다.
- 빠른 추가 아이콘은 옛 그림 문자(
▤)로 등록되어 에디터가 프리팹 아이콘으로 바꿔 보여 줍니다. 새 플러그인은 Icon: "prefab" 처럼 아이콘 이름을 씁니다.
- 패널 이름도 그림 문자(
▤ 계단 탑)로 등록되어 화면에는 「계단 탑」으로 보입니다.
| 판 | 날짜 | 내용 |
|---|
| 1.1.0 | 2026-10-02 | SDK 1.1: 설정 저장(높이 · 벽 · 계단 나무 · 지은 수) · 단축키 Ctrl+Alt+H / J · 탑 둘레 3D 그리기 |
| 1.0.0 | 2026-10-02 | 첫 판: 빠른 추가 「계단 탑」 · 설정 패널 · 명령 tower |