设置
设置分为两种。编辑器偏好设置按本机的每个用户保存，适用于所有世界。项目设置保存在世界文件中，只适用于该世界。
| 窗口 | 打开方式 | 保存位置 |
|---|---|---|
| 编辑器偏好设置 | 编辑 › 编辑器偏好设置… (Ctrl+,) | %APPDATA%\NPEditor\settings.cfg |
| 项目设置 | 编辑 › 项目设置… | 当前世界文件（.npworld） |
| 性能设置 | 工具 › 性能设置… (视距·LOD·阴影·线程) | settings.cfg（与偏好设置「性能」为同一值） |
| 快捷键 | 工具 › 快捷键… (Ctrl+Alt+K) | %APPDATA%\NPEditor\shortcuts.json |
设置窗口的用法
Section titled “设置窗口的用法”编辑器偏好设置和项目设置是外观相同的窗口。
| 部分 | 内容 |
|---|---|
| 左上「搜索设置」 | 按名称 · 说明 · 英文关键词在所有分类中查找。 |
| 左侧分类列表 | 分类。同时显示相对默认值更改过的设置数。 |
| 右侧属性表 | 每行有名称和值编辑器。鼠标悬停在名称上时显示说明。 |
| 「恢复默认值」箭头 | 只在更改过的行上显示。点击后将该行恢复为默认值。 |
| 重启标记 | 附加在需要重启才能生效的设置上。 |
值在更改后立即生效。编辑器偏好设置会立即保存到 settings.cfg。项目设置在保存世界时写入世界文件，更改可以用撤销（Ctrl+Z）还原。
编辑器偏好设置
Section titled “编辑器偏好设置”| 设置 | 默认值 | 内容 |
|---|---|---|
| 语言 · Language | 自动 (系统语言) | 界面文字的语言。参见下文「界面语言」。重启后生效。 |
| 每个形状创建 Actor | 开 | 一次形状 · 笔刷 = 一个 Actor。关闭后放入活动文件夹 · 组中。也可在编辑菜单中开关。 |
| 也选择被遮挡的方块 | 关 | 拖动框 · 屏幕矩形选择会连同被前方方块遮挡的方块一起选中。 |
| 声音试听音量 | 0.8 | 音源预览的总音量（0~1）。与工具栏滑块相同。 |
| 设置 | 默认值 | 内容 |
|---|---|---|
| UI 缩放 | 0（自动） | 0 = 按屏幕尺寸自动。可固定为 0.75~3。重启后生效。 |
| 浮动窗口可移出编辑器 | 开 | 将浮动面板 · 工具窗口作为操作系统窗口显示。关闭后只在编辑器界面内显示。 |
| 主题强调色 | #2f7cf6 | 选中项 · 按下的按钮 · 复选框 · 进度条的颜色。 |
自 0.9.9 起：新增「浮动窗口可移出编辑器」设置。
| 分组 | 设置 | 默认值 | 范围 · 内容 |
|---|---|---|---|
| 摄像机 | 相机速度档位 | 4 | 1~8（4 = 12 方块/秒） |
| 摄像机 | 相机速度倍率 | 1.0× | 0.05~16。档位 × 倍率 = 速度 |
| 摄像机 | 鼠标灵敏度 | 1.0× | 0.1~5。右键环视的快慢 |
| 摄像机 | 移动加速 (平滑) | 0.07 秒 | 0~0.5。WASD 达到最高速度所需的时间。0 = 立即 |
| 摄像机 | 反转滚轮方向 | 关 | 反转滚轮前后移动 · 缩放以及更改飞行速度的方向。 |
| 网格·吸附 | 网格吸附 | 1 方块 | 0~64。道具 · 操纵器的移动单位。0 = 关闭 |
| 网格·吸附 | 旋转吸附 | 15° | 0~90。0 = 关闭 |
| 网格·吸附 | 显示地面网格 | 开 | 与 G 相同。 |
| 网格·吸附 | 显示区块边界 | 关 | |
| 操纵器·显示 | 操纵器大小 | 92 px | 40~240。手柄长度（乘以 UI 缩放） |
| 操纵器·显示 | Mipmap | 开 | 使远处方块的纹理更平滑。关闭后更清晰，但远处会闪烁。 |
快捷键分类中显示已注册的功能数 · 更改过的按键数 · 冲突数。用「编辑快捷键…」打开快捷键窗口。参见下文「快捷键窗口」。
| 设置 | 默认值 | 范围 · 内容 |
|---|---|---|
| 视距 | 1536 方块 | 128~4096。超出此距离的地方不绘制。 |
| 远距离 LOD | 开 | 以低细节（将 2³ · 4³ 方块作为一格）绘制远处的地形。 |
| LOD 起始距离 | 320 方块 | 64~4096。从此距离起为第 2 级，从两倍距离起为第 4 级 |
| 阴影距离 | 220 方块 | 16~2000。越短越快、越清晰。 |
| 网格构建线程 | CPU 核心数 − 2（1~6） | 0~16。0 = 仅在画面线程中（慢） |
| 性能显示 | 关 | 视口左上角的 FPS · 帧 ms · 区块 · 内存（Ctrl+F7） |
可以用分类上方的「预设」按钮一次性设置。
| 预设 | 视距 | LOD 起始 | 阴影 | 网格构建线程 |
|---|---|---|---|---|
| 低配 PC | 512 | 160 | 96 | 1~2 |
| 默认 | 1536 | 320 | 220 | 核心数 − 2（1~6） |
| 高配 | 3072 | 512 | 320 | 核心数 − 2（1~8） |
近处（约 112 方块以内）按区块绘制，更远处则合并为 64³ 区域绘制。外观相同，只是减少了绘制调用。
| 设置 | 默认值 | 范围 · 内容 |
|---|---|---|
| 自动保存 | 开 | 有更改时在后台写入自动保存文件夹。原文件保持不变。 |
| 间隔 | 120 秒 | 30~3600 |
| 保留数量 | 10 个 | 1~100。超出时从最旧的开始删除。 |
自动保存文件夹为 %APPDATA%\NPEditor\autosave\。用 文件 › 加载自动保存 打开最新的一个。
| 设置 | 默认值 | 内容 |
|---|---|---|
| 启用 AI 连接 (MCP) | 关 | 打开 127.0.0.1 桥接，让 NPEditorMcp 使用此编辑器。下次启动时也保持开启。 |
| 桥接端口 | 0（自动） | 0~65535。指定的端口无法使用时自动更换。 |
「复制配置 (用于 Claude Desktop)」按钮会将 MCP 注册 JSON 复制到剪贴板。详情请参阅 AI 连接 (MCP)。
显示已加载的插件数和警告数。用「插件管理器…」启用 · 禁用 · 重新加载外部插件。
| 值 | 界面语言 |
|---|---|
| 自动 (系统语言) | 跟随操作系统语言。不是韩语 · 日语 · 中文时为英语。 |
| 한국어 | 韩语 |
| English | 英语 |
| 日本語 | 日语 |
| 简体中文 | 简体中文 |
- 选择 编辑 › 编辑器偏好设置… › 常规 ›「语言 · Language」。
- 重启编辑器。
自 0.9.7 起：界面文字可以以韩语 · 英语 · 日语 · 中文显示。
只适用于当前世界。保存在世界文件中，更改后可以用撤销还原。
| 分类 | 设置 | 默认值 | 内容 |
|---|---|---|---|
| 地图信息 | 地图名称 | （空） | 留空则使用文件名。作为导出名称的默认值。 |
| 地图信息 | 描述 | （空） | |
| 地图信息 | 作者 | （空） | |
| 世界 | 目标版本 | 1.21.11 | 方块列表 · 导出格式所用的 Minecraft 版本。与菜单栏右侧的下拉框相同。 |
| 世界 | 默认出生点 | 0, 64, 0 | 玩家最初出现的格。用于服务器 · 导出元数据以及运行的「从出生点」。 |
| 世界 | 世界边界大小 | 0 | 一边的长度（中心 = 默认出生点）。0 = 无 |
| 视图 | 默认大气·光照画面风格 | （空） | 打开此世界时，将游戏画面（F6）设为此预设。留空则保持编辑器设置。 |
| 资源包 | 资源包名称 | （空） | 要导出的文件名（<名称>_rp_vN.zip）。留空则依次使用地图名称 → 文件名 |
| 资源包 | 资源包描述 | （空） | pack.mcmeta 的描述。可使用 § 颜色代码。 |
| 导出 | 包含标记 | 开 | 导出窗口「包含标记」在此世界中的默认值 |
| 导出 | 包含场景 (scene.json) | 开 | 将场景 Actor · 动画 · 规则放入导出内容的默认值 |
性能设置窗口
Section titled “性能设置窗口”工具 › 性能设置… 以独立窗口显示与偏好设置「性能」相同的值。上方有「低配 PC」·「默认」·「高配」预设按钮。下方显示 CPU 核心数和绘制方式的说明。
- 卡顿时请先点击「低配 PC」预设。
- 然后用 Ctrl+F7 性能显示查看 FPS 和网格化队列。
- 在大地图中远处看起来被截断时，请增大视距。
通过 工具 › 快捷键… (Ctrl+Alt+K) 打开。表格的列为「功能」·「键」·「范围」·「来源」。
| 按钮 · 操作 | 动作 |
|---|---|
| 搜索框 | 按功能 · 键 · 插件名称查找。 |
| 「更改…」或双击行 | 按下新的组合键（Ctrl · Alt · Shift + 键）。Esc = 取消 |
| 「清除」 | 移除该功能的快捷键。 |
| 「默认」 | 将该功能恢复为默认按键。 |
| 「全部恢复默认」 | 将所有快捷键恢复为默认值。 |
| 「关闭」 | 关闭窗口（Esc）。 |
| 标记 | 含义 |
|---|---|
| 红色按键 | 与其他功能按键相同且范围重叠。请更改其中之一。 |
| 黄色按键 | 默认值之间按键相同。通常是同一功能（菜单与模式）。 |
| 按键旁的蓝色图标 | 相对默认值更改过的按键。 |
| 「固定」分组 | 无法更改的按键。 |
无法更改的按键如下。
| 固定按键 | 功能 |
|---|---|
| Ctrl+Z · Ctrl+Y · Ctrl+Shift+Z | 撤销 · 重做 |
| Ctrl+S | 保存 |
| Ctrl+C · Ctrl+V | 复制 · 粘贴 |
| Del · Esc | 删除 · 取消 |
| W A S D Q E Space | 相机飞行（按住右键期间） |
- 更改的按键会立即保存。菜单文字括号中的按键也会立即改变。
- 移动默认按键后，按下旧按键时会弹出「已移至其他按键」通知。
- 外部插件注册的按键也会以「外部插件」分组显示在此窗口中。
也可以用控制台命令更改。
| 命令 | 动作 |
|---|---|
keys | 快捷键列表（键 · 名称 · id） |
keys conflicts | 冲突列表 |
keys set <id> <键> | 更改该功能的按键 |
keys reset <id> | 将该功能恢复为默认按键 |
keys resetall | 全部恢复默认值 |
在控制台中更改偏好设置
Section titled “在控制台中更改偏好设置”| 命令 | 动作 |
|---|---|
pref | 相对默认值更改过的设置列表 |
pref <搜索词> | 查找设置 |
pref <id> <值> | 更改值（例：pref autosave/interval 300） |
pref reset <id> | 恢复默认值 |
id 的形式为 <分组>/<键>（例：camera/speed_level · perf/view_distance · ui/language）。