跳转到内容

示例: hello_tool

在「添加」中加入石砖楼梯塔预设的示例 · id hello_tool · SDK ^1.1 · 最新版本 1.1.0

管理器窗口中的名称为「계단 탑 (예제)」。演示如何在一个插件中使用多个注册点。

演示内容	代码
快速添加 + 一步撤销	`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
```
示例 csproj 引用源码中的 SDK 项目。若移到源码之外构建，请像快速开始那样改为引用安装文件夹中的 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`

相关文档