⌨️ 命令与权限
CraftCosmetics 注册了两个等效的命令根节点:
/craftcosmetics
/ccos
下文使用 /ccos 表示命令根节点;替换为 /craftcosmetics 后功能相同。
时装命令
equip
/ccos equip <玩家> <类型> <时装 ID>
/ccos equip <玩家> <类型> <时装 ID> -s
/ccos equip <玩家> <类型> <时装 ID> --silent
权限:craftcosmetics.command.equip
为在线玩家装备指定类型的时装。-s 和 --silent 会静默执行,不发送装备成功提示。
可用类型:hat、backpack、cane、balloon。
unequip
/ccos unequip <玩家> <槽位>
权限:craftcosmetics.command.unequip
卸下指定槽位的时装。槽位可填写 hat、backpack、cane、balloon 或 all。
菜单命令
menu
/ccos menu
/ccos menu <菜单>
/ccos menu <菜单> <玩家>
打开时装菜单。省略菜单时默认打开 hat 菜单;指定玩家时,目标玩家必须在线。
权限:
- 打开自己的菜单:
craftcosmetics.command.menu - 为其他玩家打开菜单:
craftcosmetics.command.menu.others
可用菜单 ID:hat、backpack、cane、balloon。
backpack
/ccos backpack
权限:craftcosmetics.command.backpack
打开当前已装备背包的存储容器。只有时装配置中启用了 storage.enabled: true 的背包才能打开存储。
可见性命令
hide
/ccos hide <true|false>
权限:craftcosmetics.command.hide
设置其他玩家是否可以看到自己的时装:
true:隐藏自己的时装。false:显示自己的时装。
衣柜命令
wardrobe
/ccos wardrobe <衣柜 ID>
/ccos wardrobe <衣柜 ID> info
/ccos wardrobe <衣柜 ID> enable
/ccos wardrobe <衣柜 ID> disable
/ccos wardrobe <衣柜 ID> set npc
/ccos wardrobe <衣柜 ID> set viewer
/ccos wardrobe <衣柜 ID> set leave
权限:craftcosmetics.command.wardrobe
- 不带子命令:进入指定衣柜。
info:查看衣柜状态、权限和位置。enable:启用衣柜。disable:禁用衣柜。set npc:保存当前玩家位置为假人位置。set viewer:保存当前玩家位置为预览位置。set leave:保存当前玩家位置为离开位置。
set 子命令只能由玩家执行。进入具体衣柜还需要满足该衣柜配置中的 permission,默认衣柜通常使用 craftcosmetics.wardrobe.default。
管理命令
reload
/ccos reload
权限:craftcosmetics.command.reload
重载主配置、语言文件、时装定义、菜单和衣柜配置。
命令参数
| 参数 | 说明 |
|---|---|
<玩家> | 在线玩家名称 |
<类型> | hat、backpack、cane 或 balloon |
<时装 ID> | cosmetics 配置中的时装标识符 |
<槽位> | hat、backpack、cane、balloon 或 all |
<菜单> | hat、backpack、cane 或 balloon |
<衣柜 ID> | wardrobes 目录中的衣柜标识符 |
<hidden> | true 或 false |
关于
list资源目录中的 commands.yml 保留了 list 配置段,但当前源码命令注册器未注册 /ccos list,因此该命令当前不可用。