请找到对应的症状，按解决方法一栏操作。如果仍无法解决，请通过下文「查看日志」确认记录。
| 症状 | 原因 | 解决方法 |
|---|
| 安装无法完成，或出现无法替换文件的错误 | 编辑器正在运行。 | 关闭编辑器后重新运行安装程序。 |
| 启动后只显示登录界面 | 这是要求登录的部分公开安装包。 | 使用受邀账户登录。如果没有账户或忘记密码，请联系邀请人。 |
| 「登录验证失败」 | 无法连接到服务器。 | 检查网络连接。只要登录过一次，7 天内无需网络也能打开。 |
| 使用中编辑器被锁定 | 在每 6 小时一次的账户验证中账户被封禁。 | 锁定前会自动保存。请联系邀请人。 |
| AI 连接（MCP）服务器立即退出 | 在要求登录的安装包中没有编辑器登录信息。 | 先在编辑器中登录。参见 AI 连接 (MCP)。 |
| 症状 | 原因 | 解决方法 |
|---|
| 「找不到 Minecraft <版本> 客户端 jar」 | 启动器文件夹中没有该版本的 jar。 | 用启动器运行一次该版本。然后点击 文件 › 重新查找启动器文件夹 (版本列表)。或通过 文件 › 加载 jar… 直接选择 jar。 |
| 方块显示为没有纹理的颜色方块 | 未能读取 jar，或当前 jar 中没有该方块。 | 先按上面的 jar 问题处理。查看状态通知中的「此 jar 中没有的方块 N 种」列表。 |
| 换成其他版本的 jar 后部分方块显示异常 | 是该版本中不存在的新方块，或是改了名的方块。 | 自 0.9.10 起，仅改名的方块（sign ↔ oak_sign · grass_path ↔ dirt_path · grass ↔ short_grass · chain ↔ iron_chain）会按该 jar 中的名称绘制。该版本中不存在的方块会以本机更新版本 jar 中的贴图显示并弹出通知。如果没有更新的 jar，则显示为颜色方块。目标版本的游戏中没有这些方块，请替换掉。 |
| 「没有方块列表 (服务器报告)」 | 没有该版本的方块列表缓存。 | 通过 文件 › 用服务器 jar 生成方块列表… (目标版本) 选择服务器 jar。每个版本一次，需要几十秒。 |
| 「找不到 java」 | 没有用于生成方块列表的 Java。 | 安装 Java 并设置 JAVA_HOME 或将其加入 PATH。能运行服务器的 Java 即可。 |
| 目标版本列表中没有新安装的版本 | 只在启动时查找一次。 | 点击 文件 › 重新查找启动器文件夹 (版本列表)。模组加载器（Forge · Fabric 等）文件夹不会出现在列表中。 |
详情请参阅 Minecraft 版本。
| 症状 | 原因 | 解决方法 |
|---|
| 所有快捷键都不起作用 | 光标位于控制台 · 搜索框等文字输入框中。 | 在视口中点击一次。在文字输入框中 Ctrl+S 等部分按键仍然有效（参见 快捷键）。 |
| 快捷键不起作用并弹出「已移至其他按键」通知 | 在快捷键窗口中更改了该功能的按键。 | 在 工具 › 快捷键… 中查看当前按键，或点击「默认」。 |
| 世界编辑按键不起作用 | 绘制标签页正在显示。 | 用 Ctrl+Tab 返回世界标签页。 |
| 运行中编辑按键不起作用 | 运行期间编辑快捷键被屏蔽。 | 按 Esc 结束运行。 |
| W · E · R 操纵器不出现 | 没有选中任何对象。 | 用 Q 选择选择工具，选中区域 · 道具 · Actor 后再按。 |
| 大型操作期间无法进行其他编辑 · 保存 | 超过 20 万格的操作会分多帧应用。进行期间其他编辑和保存会被屏蔽。 | 等待状态栏进度完成，或用 Esc · 状态栏的取消按钮取消。取消后已应用的部分也会还原。 |
| 指向天空放置时方块出现在相机前方 | 没有方块的地方会放在地面（y = 0），若地面也看不到，则放在相机前方 6 格的空中。 | 指向地面或方块面再放置。 |
| 拖动框的高度无法向下延伸 | 这是 0.9.9 及更早版本的行为。 | 更新到 0.9.10 或更高版本。 |
| 无法再撤销 | 撤销历史最多 200 步。执行 编辑 › 清除历史记录 后历史会被清空。 | 在 窗口 › 历史 面板中查看剩余步骤。重要节点请用快速快照（Ctrl+Alt+S）保留。 |
| 点击天花板 · 空中平台下方，树却种在上面 | 这是 0.9.10 及更早版本的行为。 | 自 0.9.11 起会种在点击的那一层（天花板下方的地面）。 |
| 症状 | 原因 | 解决方法 |
|---|
| 导入的 OBJ · FBX · glTF 模型在资源包中缺失 | 以「原始形状」（三角形）导入，无法成为 Minecraft 模型。 | 在内容浏览器中右键单击模型 ›「更改导入方式…」，选择「显示」或「转换为方块」。自 0.9.9 起，生成资源包时会自动转换为显示并发出警告。 |
| 无法在 UV 编辑器中修改 OBJ · FBX · glTF | UV 编辑仅支持 .bbmodel · .npmodel · 自定义方块。 | 需要修改 UV 的模型请以 .bbmodel 导入。 |
详情请参阅 导入自定义模型 · 资源包与 HUD。
| 症状 | 原因 | 解决方法 |
|---|
| 大地图中卡慢 · 卡顿 | 视距 · 阴影距离相对于电脑配置过大。 | 在 工具 › 性能设置… 中点击「低配 PC」预设。用 Ctrl+F7 性能显示查看 FPS 和网格化队列。 |
| 打开后一段时间内远处显示为空 | 正在生成区块网格。 | 等待状态栏「网格化」数量变为 0。增加网格构建线程可以加快速度。 |
| F6 游戏画面显示为旧的近似画面 | 当前环境无法使用 Forward+ 渲染器。 | 将显卡驱动更新到最新版本。 |
| F7 路径追踪无法使用 | 当前环境无法使用计算着色器。 | 将显卡驱动更新到最新版本。 |
| 从远处观看整个地图时，F6 中的地形消失为天空色 | 这是游戏视距末端的雾。 | 在视口栏「大气·光照」面板的「游戏画面 (F6) 视图」中增大「视距 (区块)」，或开启「俯瞰模式 (仅编辑器)」（自 0.9.1 起，默认开启）。 |
| F6 中看不到网格 | 游戏画面中会隐藏网格。 | 按 G。 |
| 浮动窗口移到编辑器外不方便 | 自 0.9.9 起以操作系统窗口显示。 | 关闭 偏好设置 › 外观 ›「浮动窗口可移出编辑器」。 |
| 面板布局混乱 | — | 点击 窗口 › 重置布局。 |
| 更改了语言但界面不变 | 语言需要重启后才会更改。 | 重新启动编辑器。 |
| 症状 | 原因 | 解决方法 |
|---|
| 未保存就关闭了 | — | 重新启动后点击 文件 › 加载自动保存。打开后用「另存为」保存。 |
| 保存过程中电脑关机 | — | 重新打开该世界。会从残留的 .tmp · .bak 恢复，并在通知中显示「已恢复」。 |
| 「无法读取注册表，将以空注册表启动」 | 无法读取项目文件夹中的 assets\registry.json。 | 确认该文件没有被删除或被其他程序修改。 |
| 保存为 Minecraft 世界的世界不在单人游戏列表中 | 没有放入 saves 文件夹。 | 将生成的 <名称>_world 文件夹复制到 %APPDATA%\.minecraft\saves\（或所用启动器的 saves 文件夹）。 |
| 区域触发器在单人游戏世界中不运行 | 世界逻辑由服务器插件 NP Scene 执行。 | 在导出窗口（Ctrl+Shift+E）中生成服务器用文件。参见 导出与导入。 |
| 症状 | 原因 | 解决方法 |
|---|
| 插件被禁用并显示错误 | 插件抛出异常时，只关闭该插件，编辑器继续运行（隔离）。 | 在 工具 › 插件管理器… 中查看错误内容并重新加载。警告汇总在 帮助 › 插件列表 中。 |
| 插件不在列表中 | 插件不在插件文件夹中。 | 放入通过 工具 › 打开插件文件夹 打开的文件夹（%APPDATA%\NPEditor\plugins\）。 |
插件制作方面的问题请参阅 概述 和 SDK 故障排除文档。
| 位置 | 内容 |
|---|
| 输出日志面板 | 编辑器 · 插件输出的所有通知和错误。即下方区域的「输出日志」标签页。 |
| 日志文件 | 运行记录文件保存在 %APPDATA%\NPEditor\logs\ 中。 |
| 帮助 › 插件列表 | 已加载的插件和注册警告 |
| 帮助 › 关于 / 许可证 | 编辑器版本（咨询时请一并告知） |