SDK 更新日志
SDK 版本与编辑器版本分开编号。在同一 major 内只做添加。因此为旧版本编写的插件在新编辑器中也能照常运行。规则见分发与版本。
| SDK | 日期 | 编辑器 | 新增内容 | sdk |
|---|---|---|---|---|
| 1.3.0 | 2026-10-05 | 0.9.1 | host.Scene（读取场景 Actor — INpScene · NpSceneActor） · host.View（运行状态 · 时钟，运行中的 SetCamera · LookAt · ReleaseCamera，PlayChanged · PlayTicked — INpView） · 字段类型 NpSceneFieldKind.ActorList | ^1.3 |
| 1.2.0 | 2026-10-04 | 0.9.0 | AddSceneEvent（世界逻辑触发器 · 条件 · 动作 type — NpSceneEvent · NpSceneField · NpSceneFieldKind · NpSceneSim） | ^1.2 |
| 1.1.0 | 2026-10-02 | 0.9.0 之前 | AddShortcut（NpShortcut） · host.Settings（INpSettings） · host.Draw（INpDraw · NpVec3） | ^1.1 |
| 1.0.0 | 2026-10-02 | 0.9.0 之前 | 首个版本：INpEditorPlugin · INpEditorHost · INpWorld · AddMenuItem · AddQuickAddItem · AddCommand · AddImporter · AddExporter · AddContentTab（NpUi） · AddMode · AddActorType · AddShotScenario · AddCellGuard · AddSymmetry · WorldChanged · Committed · Message · Log | ^1.0 |
- 新增
INpEditorHost.Scene·INpEditorHost.View。 - 角度为 Minecraft 角度（yaw 0 = +Z，90 = −X · pitch 90 = 朝下）。
- 相机移动仅在运行 · 模拟期间有效。停止 ·
ReleaseCamera· 禁用插件时恢复原视角。 - 新增字段类型
ActorList（Actor id 列表，JSON 数组）。 - 同一版本中，动作
cinematic成为编辑器内置。注册相同 type 的插件会被隔离。 - 文档：场景读取与运行相机
- 新增
INpEditorHost.AddSceneEvent。注册的 type 会出现在世界逻辑表单 · 逻辑图 · 检查 · MCP 架构 · 运行预览中。 - 14 种字段类型：
Text·Number·Bool·Enum·Actor·Anim·SoundEvent·Block·Item·Particle·Effect·Vec3·Signal·Flag - 文档：添加世界逻辑 type
AddShortcut：用户可在「工具 › 快捷键…」中更改的快捷键Settings：每个插件在一个 JSON 文件中保存键 · 值Draw：在视口上叠加绘制线 · 框 · 文字（每个插件 20,000 个）- 文档：宿主 API · 注册点
尚未提供的功能
Section titled “尚未提供的功能”以下功能只有内置插件可以使用，SDK 中尚未提供。它们是下一版本的候选，是否加入 · 何时加入尚未确定。
| 功能 | 现状 |
|---|---|
| 注册 Actor 组件种类 | 仅限内置 |
| 创建 · 移动场景 Actor | host.Scene 只能读取 |
将一次 World.Edit 合并为一个 Actor | 尚未提供 |
世界逻辑字段类型：标志值 · 函数 · 方块格列表（Cells） | 仅限内置 type |
世界逻辑字段选项：显示条件 · 仅限整数 · 允许 #标签 | 仅限内置 type |
| 视口拖动（按住移动） | 模式只接收点击（OnClick） |
| 视图模式 · 着色器 | 仅限内置 |
| 选择面板区域 · 面板图标 | 固定为下方区域 · plugin 图标（用户可以移动） |
| 在世界文件（.npworld）中保存插件数据 | 仅限内置。插件使用 Settings · PluginDir 文件 |
| 界面文字多语言 | 编辑器翻译表以外的文字按原样显示 — 由插件自行处理 |
| 插件签名 · 撤销命名空间 | 无 |