安装与首次启动
NP Editor 以一个 Windows 安装程序发布。无需管理员权限，只安装到当前用户账户。界面上显示的名称为「Noplatea Editor」，简称 NP Editor。
| 项目 | 内容 |
|---|---|
| 操作系统 | Windows 64 位 |
| .NET | 无需另行安装。已包含在安装程序中。 |
| Minecraft | 本机必须有通过启动器安装的原版客户端。方块纹理和模型从该 jar 读取。 |
| 图形 | 游戏画面（F6）· 路径追踪（F7）视图模式需要 Forward+ 渲染器和计算着色器。 |
| Java（可选） | 仅在使用「用服务器 jar 生成方块列表」时需要。能运行服务器的 Java 即可。 |
Minecraft jar 不会复制到编辑器文件夹或保存文件中。运行时直接从本机的 jar 读取，仅在内存中使用。
- 获取安装程序
NPEditor_Setup_<版本>.exe（例：NPEditor_Setup_0.9.11.exe）。 - 如果编辑器正在运行，请先关闭。
- 运行安装程序。安装界面为韩语。
- 在选择安装位置的界面中指定文件夹。默认值为
%LOCALAPPDATA%\Programs\NP Editor。 - 安装完成后，保持最后一个界面上的「运行 Noplatea Editor」处于勾选状态并关闭。编辑器会立即启动。
安装程序会创建以下快捷方式。
| 位置 | 快捷方式 |
|---|---|
| 开始菜单 › Noplatea Editor | Noplatea Editor · Noplatea Editor 제거 |
| 桌面 | Noplatea Editor |
安装文件夹内容
Section titled “安装文件夹内容”| 路径 | 内容 |
|---|---|
NPEditor.exe · NPEditor.pck | 编辑器主体 |
data_NPEditor_windows_x86_64\ | .NET 运行时与编辑器库 |
mcp\NPEditorMcp.exe | AI 连接（MCP）服务器。参见 AI 连接 (MCP) |
skills\np-editor-builder\ | AI 连接用的工作说明书 |
samples\ | 示例世界 castle.npworld · elder_sanctuary.npworld |
licenses\ | 许可声明 |
Uninstall.exe | 卸载程序 |
可以在命令行中不显示界面进行安装。
| 目的 | 命令 |
|---|---|
| 静默安装 | NPEditor_Setup_<版本>.exe /S |
| 指定文件夹静默安装 | NPEditor_Setup_<版本>.exe /S /D=<安装文件夹>（/D= 写在最后） |
| 静默卸载 | "<安装文件夹>\Uninstall.exe" /S |
- 点击开始菜单或桌面上的「Noplatea Editor」。
- 会短暂显示启动画面（NP 立方体和「正在加载… · Loading…」）。
- 出现登录界面时进行登录（见下文「登录」）。
- 编辑器以空世界（「无标题」）打开。模式为方块笔刷。
- 自动查找目标版本的客户端 jar 并读取方块纹理。
编辑器不会自动重新打开上次打开的世界。请通过 文件 › 打开…（Ctrl+O）打开世界。示例世界位于安装文件夹的 samples\ 中。
自 0.9.9 起：启动时显示 NP Editor 启动画面，而不是 Godot 徽标。
部分公开测试版安装包需要使用受邀账户登录才能打开编辑器。不需要登录的安装包不会显示此界面。
| 项目 | 内容 |
|---|---|
| 登录界面 | 包含「邮箱」·「密码」输入框和「登录」·「退出」按钮。 |
| 创建账户 | 无法在界面上注册。由邀请人为你创建账户。 |
| 下次启动 | 登录一次后，之后会直接打开。 |
| 离线使用 | 自最后一次验证起 7 天内可在无网络的情况下使用。 |
| 服务器验证 | 运行期间每 6 小时验证一次账户。 |
| 账户菜单 | 帮助 › 账户: 更改密码 · 帮助 › 账户: 退出登录 |
| 登录信息文件 | %APPDATA%\NPEditor\account.json |
自 0.9.3 起：新增登录功能。AI 连接（MCP）服务器也需要编辑器中已登录的账户才能启动。
自动查找 Minecraft jar
Section titled “自动查找 Minecraft jar”编辑器启动时会在本机的启动器文件夹中查找原版客户端 jar。同一版本存在于多处时，使用表中靠上的启动器。
| 顺序 | 启动器 | 查找的文件夹 |
|---|---|---|
| 1 | CurseForge | %USERPROFILE%\curseforge\minecraft\Install\versions |
| 2 | 官方启动器 | %APPDATA%\.minecraft\versions |
| 3 | Prism Launcher | %APPDATA%\PrismLauncher\libraries\com\mojang\minecraft |
| 4 | MultiMC | %APPDATA%\MultiMC\libraries\com\mojang\minecraft |
| 5 | TLauncher | %APPDATA%\.tlauncher\legacy\Minecraft\game\versions |
| 6 | Modrinth App | %APPDATA%\ModrinthApp\meta\versions · %APPDATA%\com.modrinth.theseus\meta\versions |
| 7 | 官方启动器（主目录） | %USERPROFILE%\.minecraft\versions |
| 8 | 手动选择的 jar | 通过 文件 › 加载 jar… 选择的文件 |
- 只使用原版版本文件夹。Forge · NeoForge · Fabric · Quilt · OptiFine 等模组加载器文件夹会被跳过。
- 找不到 jar 时会弹出「找不到 Minecraft <版本> 客户端 jar」通知。请用启动器运行一次该版本后重新启动编辑器，或通过 文件 › 加载 jar… 直接选择 jar。
- 如果用启动器安装了新版本，请点击 文件 › 重新查找启动器文件夹 (版本列表)。
选择目标版本
Section titled “选择目标版本”在菜单栏最右侧的「目标版本」下拉框中选择制作地图所用的 Minecraft 版本。默认值为 1.21.11。
| 项目 | 内容 |
|---|---|
| 列表 | 在本机找到的原版版本。每行显示「版本 · 启动器名称」，没有 jar 时附加「无 jar」。 |
| 「有列表」 | 表示该版本的方块列表（服务器报告）已生成。 |
| 选择后 | 使用该版本的 jar 替换纹理，方块列表 · 导出检查也以该版本为准。 |
| 保存 | 与项目设置中的「目标版本」为同一值。保存在世界文件中。 |
如果没有方块列表（服务器报告），请通过 文件 › 用服务器 jar 生成方块列表… (目标版本) 生成。选择服务器 jar 后会用 Java 生成数据报告。需要几十秒，每个版本只需执行一次。详情请参阅 Minecraft 版本。
保存与自动保存
Section titled “保存与自动保存”| 项目 | 内容 |
|---|---|
| 世界文件 | .npworld。文件 › 保存（Ctrl+S）· 文件 › 另存为…（Ctrl+Shift+S） |
| 项目文件夹 | 世界文件所在的文件夹。自定义方块 · 模型注册表（assets\）、导出结果（export\）、截图（shots\）会生成在这里。 |
| 安全保存 | 先写入临时文件再进行替换。之前的文件保留为 .bak。 |
| 恢复 | 如果保存过程中程序关闭，下次打开该世界时会从残留的 .tmp · .bak 恢复。 |
| 自动保存 | 有更改时每 120 秒在后台保存。不会改动原文件。 |
| 自动保存位置 | %APPDATA%\NPEditor\autosave\<名称>_<路径哈希>.npworld（无标题世界为 untitled.npworld） |
| 保留数量 | 超过 10 个时从最旧的开始删除。 |
| 加载自动保存 | 文件 › 加载自动保存 = 打开最新的自动保存文件。打开后请用「另存为」保存。 |
| 关闭时 | 有未保存的更改时，会询问「保存并退出」·「不保存并退出」·「取消」。即使不保存就退出，也会保留在自动保存文件中。 |
自动保存间隔和保留数量可在 设置 的「自动保存」中更改。
更新到新版本
Section titled “更新到新版本”- 关闭编辑器。
- 运行新的安装程序。
- 上次的安装文件夹会作为默认值显示。直接安装即可。
- 程序文件（
data_NPEditor_windows_x86_64\·mcp\·skills\np-editor-builder\·licenses\）会被删除并重新放入。 samples\只覆盖同名文件。- 制作的世界、设置、快捷键、预制件、插件（用户数据文件夹）都会保留。
- 当前版本可在 帮助 › 关于 / 许可证 中查看。
- 在 Windows 设置的应用列表中卸载「Noplatea Editor」，或点击开始菜单中的「Noplatea Editor 제거」（卸载）。
- 卸载程序会删除快捷方式、程序文件、
samples\和注册表项。 - 如果安装文件夹中还留有你手动放入的文件，则不会删除该文件夹，并会列出这些文件。
卸载后，下方的用户数据文件夹和你自己保存的世界文件仍会保留。如需全部删除，请手动删除这些文件夹。
用户数据文件夹
Section titled “用户数据文件夹”| 文件夹 · 文件 | 内容 |
|---|---|
%APPDATA%\NPEditor\settings.cfg | 编辑器偏好设置 · 停靠布局 · 视图设置 |
%APPDATA%\NPEditor\shortcuts.json | 更改过的快捷键 |
%APPDATA%\NPEditor\autosave\ | 自动保存文件 |
%APPDATA%\NPEditor\prefabs\ | 预制件 |
%APPDATA%\NPEditor\project\ | 尚未保存的世界的项目文件夹 |
%APPDATA%\NPEditor\plugins\ | 外部插件文件夹 |
%APPDATA%\NPEditor\plugins_state.json · plugin_settings\ | 插件启用/禁用状态 · 各插件的设置 |
%APPDATA%\NPEditor\account.json | 登录信息（使用登录的安装包） |
%APPDATA%\NPEditor\mcp\ | AI 连接桥接的连接信息 |
%APPDATA%\NPEditor\logs\ | 运行记录（日志文件） |
%LOCALAPPDATA%\NPEditor\versions\<版本>\ | 各版本的方块列表（服务器报告）缓存 |
%LOCALAPPDATA%\NPEditor\texture_index\ · block_colors\ | 纹理索引 · 方块颜色缓存（不保存图像） |
文档\NPEditor\looks\ · 文档\NPEditor\shaderpacks\ | 保存的大气·光照画面风格 · 生成的光影包 |
缓存文件夹（%LOCALAPPDATA%\NPEditor\）可以删除。下次需要时会重新生成。