⌨️ 命令与权限
CraftSkin 注册了三个等效的命令根节点:
/cskin
/cs
/craftskin
下文使用 /cskin 表示命令根节点;替换为 /cs 或 /craftskin 后功能相同。
皮肤代币命令
token give
/cskin token give <玩家> <皮肤> [数量] [-s|--silent]
权限:craftskin.command.token.give
为指定玩家给予皮肤代币。<玩家> 使用在线玩家选择器,<皮肤> 为 skins 配置中的皮肤 ID,<数量> 默认为 1,最小值为 1。
-s 或 --silent 会静默执行,不发送成功提示。
token get
/cskin token get <皮肤> [数量] [-s|--silent]
权限:craftskin.command.token.get
为执行命令的玩家获取皮肤代币。该命令只能由玩家执行,数量默认为 1。
token remove
/cskin token remove [玩家] [数量] [-s|--silent]
权限:craftskin.command.token.remove
给予皮肤拆除代币。省略 <玩家> 时,默认给予执行命令的玩家;控制台执行时必须指定玩家。数量默认为 1。
换肤命令
apply
/cskin apply <皮肤> [玩家]
权限:craftskin.command.apply
将指定皮肤应用到目标玩家的主手物品。省略 <玩家> 时,默认应用到执行命令的玩家;控制台执行时必须指定玩家。
目标物品必须满足当前皮肤或全局 target-items 规则,并且默认不能已有 item_model。
预览菜单命令
preview
/cskin preview [菜单]
权限:craftskin.command.preview
打开皮肤预览菜单。省略菜单时打开全部皮肤菜单。
可用菜单 ID:
| 菜单 | 完整 ID |
|---|---|
| 全部皮肤 | all / skin_all |
| 我的收藏 | favorite / skin_favorite |
| 斧头皮肤 | axe / skin_axe |
| 弓皮肤 | bow / skin_bow |
| 锄皮肤 | hoe / skin_hoe |
| 镐皮肤 | pickaxe / skin_pickaxe |
| 锹皮肤 | shovel / skin_shovel |
| 剑皮肤 | sword / skin_sword |
预览菜单交互
- 普通玩家左键点击皮肤:显示该皮肤的物品预览。
- 拥有
craftskin.admin的玩家左键点击皮肤:获取1个皮肤代币。 - 拥有
craftskin.admin的玩家 Shift+左键点击皮肤:获取64个皮肤代币。 - 右键点击皮肤:收藏或取消收藏。
- Shift+右键点击皮肤:显示该皮肤的物品预览。
管理命令
reload
/cskin reload
权限:craftskin.command.reload
重新加载主配置、语言文件、皮肤配置和预览菜单配置。
命令配置
命令的启用状态、权限节点和命令别名位于插件数据目录的 commands.yml。该文件中的命令结构说明要求重启后生效;修改后建议重启服务器。
| 配置 ID | 默认权限 |
|---|---|
token_give | craftskin.command.token.give |
token_get | craftskin.command.token.get |
token_remove | craftskin.command.token.remove |
apply | craftskin.command.apply |
reload | craftskin.command.reload |
preview | craftskin.command.preview |
其他权限
| 权限 | 作用 |
|---|---|
craftskin.admin | 在预览菜单中获取皮肤代币,并使用管理员交互行为 |