commands.yml

概述

commands.yml 控制大部分 Youer 内置命令是否注册到服务器。其中 worlds.enable 还额外控制世界管理模块的初始化（不只是命令注册）。

bash

工作机制

首次启动时，如果 commands.yml 不存在，Youer 会自动创建该文件。
文件中的每个配置项都是 布尔值（true / false）：
true → 注册并启用对应的命令
false → 不注册该命令（游戏中无法使用）
如果配置项缺失，Youer 会自动补写为 false 并保存。因此想要启用某个命令，需要手动将对应的值改为 true。
命令注册发生在服务器启动阶段，修改配置后需要重启服务器才能生效。

配置项

`worlds.enable`

yaml

默认值	说明
`false`	启用世界管理模块与 `/worlds` 命令

该配置同时控制两处行为：世界管理模块的初始化（WorldManage）以及 /worlds 命令的注册。设为 false 时两者都会被禁用。

世界管理的相关配置见 WorldManage.md 与 WorldsConfig.md。

`warps.enable`

yaml

默认值	说明
`false`	启用传送点（Warp）管理命令 `/warps`

/warps 支持子命令：set（设置传送点）、del（删除）、tp（传送）、gui（打开图形界面）。

`tpa.enable`

yaml

默认值	说明
`false`	启用传送请求相关命令

启用后同时注册三个命令：

命令	说明
`/tpa <玩家名>`	向玩家发送传送请求
`/tpaccept`	接受收到的传送请求
`/tpadeny`	拒绝收到的传送请求

`back.enable`

yaml

默认值	说明
`false`	启用 `/back` 命令（回到上次传送前 / 死亡前的位置）

`menus.enable`

yaml

默认值	说明
`false`	启用菜单命令 `/menus [open] [name]`

`hideall.enable`

yaml

默认值	说明
`false`	启用 `/hideall` 命令（隐藏/显示所有玩家，双向隐藏）

`hide.enable`

yaml

默认值	说明
`false`	启用 `/hide` 命令（隐藏/显示其他玩家，仅对自己可见）

`hat.enable`

yaml

默认值	说明
`false`	启用 `/hat` 命令（将手持物品戴在头上）

`vanish.enable`

yaml

默认值	说明
`false`	启用 `/vanish` 命令（隐身模式）

`openinv.enable`

yaml

默认值	说明
`false`	启用 `/openinv` 命令（打开其他玩家的背包）

`entitylimits.enable`

yaml

默认值	说明
`false`	启用 `/entitylimits` 命令（实体数量限制管理）

实体限制的具体规则配置在独立的 youer-config/entitylimits.yml 中，本配置只控制命令是否可用。

`deepseek.enable`

yaml

默认值	说明
`false`	启用 `/deepseek` 命令（与 AI 聊天）

注意：此配置只控制 /deepseek 命令的注册。AI 功能本身（API 地址、密钥、模型、角色设定等）由 youer-config/youer.yml 中的 deepseek 配置段控制，详见 YouerConfig.md。

始终启用的命令

以下命令不受 commands.yml 控制，始终注册：

命令	说明
`/lightfix [world\|corrupt]`	光照修复（修复区块光照数据异常）
`/pregen <start\|status\|pause\|resume\|stop\|cancel>`	区块预生成（用于验证区块/世界优化类 Mod 是否虚标）
`/plugin [load\|reload\|unload] <插件名>`	插件热管理（加载/重载/卸载插件）
`/logfilter [list\|reload\|on\|off]`	控制台日志过滤规则管理
`/enchantlimit [add\|list\|remove]`	附魔最大等级限制
`/entitydamage [add\|list\|remove]`	实体最终伤害消弱

完整配置示例

yaml

常见问题

Q：我把 warps.enable 改成了 true，但重启后游戏里还是用不了 /warps？

A：请确认改动没有写错层级，正确格式为：

yaml

而不是将 warps.enable 直接写在顶层。另外确认 youer-config/commands.yml（不是 youer-config/youer.yml）。

Q：配置里漏写了一个命令的配置项会怎样？

A：启动时 Youer 会自动补写为 false 并保存，该命令不会被注册。

Q：为什么 /lightfix 和 /pregen 不在配置文件里？

A：这两个命令是常驻命令，始终注册，无法通过本文件禁用。

相关配置：插件主配置见 YouerConfig.md；世界管理配置见 WorldsConfig.md 与 WorldManage.md。