commands.yml
commands.yml 配置说明
配置文件位于：
youer-config/commands.yml
概述
commands.yml 控制大部分 Youer 内置命令是否注册到服务器。其中 worlds.enable 还额外控制世界管理模块的初始化（不只是命令注册）。
工作机制
- 首次启动时，如果
commands.yml不存在，Youer 会自动创建该文件。 - 文件中的每个配置项都是
布尔值（true/false）： true→ 注册并启用对应的命令false→ 不注册该命令（游戏中无法使用）- 如果配置项缺失，Youer 会自动补写为
false并保存。因此想要启用某个命令，需要手动将对应的值改为true。 - 命令注册发生在服务器启动阶段，修改配置后需要重启服务器才能生效。
配置项
worlds.enable
| 默认值 | 说明 |
|---|---|
false | 启用世界管理模块与 /worlds 命令 |
该配置同时控制两处行为：世界管理模块的初始化（
WorldManage）以及/worlds命令的注册。设为false时两者都会被禁用。世界管理的相关配置见 WorldManage.md 与 WorldsConfig.md。
warps.enable
| 默认值 | 说明 |
|---|---|
false | 启用传送点（Warp）管理命令 /warps |
/warps 支持子命令：set（设置传送点）、del（删除）、tp（传送）、gui（打开图形界面）。
tpa.enable
| 默认值 | 说明 |
|---|---|
false | 启用传送请求相关命令 |
启用后同时注册三个命令：
| 命令 | 说明 |
|---|---|
/tpa <玩家名> | 向玩家发送传送请求 |
/tpaccept | 接受收到的传送请求 |
/tpadeny | 拒绝收到的传送请求 |
back.enable
| 默认值 | 说明 |
|---|---|
false | 启用 /back 命令（回到上次传送前 / 死亡前的位置） |
menus.enable
| 默认值 | 说明 |
|---|---|
false | 启用菜单命令 /menus [open] [name] |
hideall.enable
| 默认值 | 说明 |
|---|---|
false | 启用 /hideall 命令（隐藏/显示所有玩家，双向隐藏） |
hide.enable
| 默认值 | 说明 |
|---|---|
false | 启用 /hide 命令（隐藏/显示其他玩家，仅对自己可见） |
hat.enable
| 默认值 | 说明 |
|---|---|
false | 启用 /hat 命令（将手持物品戴在头上） |
vanish.enable
| 默认值 | 说明 |
|---|---|
false | 启用 /vanish 命令（隐身模式） |
openinv.enable
| 默认值 | 说明 |
|---|---|
false | 启用 /openinv 命令（打开其他玩家的背包） |
entitylimits.enable
| 默认值 | 说明 |
|---|---|
false | 启用 /entitylimits 命令（实体数量限制管理） |
实体限制的具体规则配置在独立的
youer-config/entitylimits.yml中，本配置只控制命令是否可用。
deepseek.enable
| 默认值 | 说明 |
|---|---|
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 是否虚标） |
完整配置示例
常见问题
Q：我把 warps.enable 改成了 true，但重启后游戏里还是用不了 /warps？
A：请确认改动没有写错层级，正确格式为：
而不是将 warps.enable 直接写在顶层。另外确认 youer-config/commands.yml（不是 youer-config/youer.yml）。
Q：配置里漏写了一个命令的配置项会怎样？
A：启动时 Youer 会自动补写为 false 并保存，该命令不会被注册。
Q：为什么 /lightfix 和 /pregen 不在配置文件里？
A：这两个命令是常驻命令，始终注册，无法通过本文件禁用。
相关配置：插件主配置见 YouerConfig.md；世界管理配置见 WorldsConfig.md 与 WorldManage.md。