- 版权类型
- 原创
- 插件中文名称
- 指令物品
- 插件英文名称
- CommandItem
- 原帖地址
- #
- 支持的核心（服务端）
- Spigot
- Paper
- Leaves
- 其他核心
- 语言支持
- 中文（简体）
- 前置组件
- 依赖PlaceholderAPI
软依赖 Vault
- 适配版本（Java）
- 1.20
CommandItem 指令物品插件
CommandItem 是一款高度可配置的指令物品插件。管理员在配置文件中为物品设置好效果后，玩家手持物品左键或右键点击，即可触发执行服务器指令 —— 支持以控制台权限执行，也可以让玩家自己执行。
插件内置四大实用机制，可自由组合：冷却限制，防止物品被连续滥用；使用后消失，适合卷轴、符咒等一次性消耗品；次数限制，每把物品可用几次、还剩几次一目了然；引导时间，使用前需要原地读条，读条期间一旦移动、死亡或切换物品就会打断，打断不消耗次数，适合制作施法、回城等仪式感玩法。
物品的外观完全自定义：材质、名字、描述文字、附魔光泽都可以在配置里调整，还可配合资源包使用自定义模型。所有效果只需编辑一个配置文件，执行 /citem reload 即可生效，无需重启服务器。
| 命令 | 说明 | 权限 |
|---|---|---|
| /citem give <玩家> <物品ID> [次数]` | 发放指令物品（次数缺省用配置的 max_uses，-1 为无限） | citem.admin |
| /citem list` | 查看已配置的所有物品 | citem.admin |
| /citem reload` | 重载配置文件 | citem.admin |
| 手持物品左/右键触发 | 使用指令物品 | citem.use（默认所有玩家） |
> citem.admin` 默认仅 OP 拥有。玩家使用物品不需要任何额外权限（默认 true），如需限制可修改 citem.use。
另加：指令占位符
CommandItem 是一款高度可配置的指令物品插件。管理员在配置文件中为物品设置好效果后，玩家手持物品左键或右键点击，即可触发执行服务器指令 —— 支持以控制台权限执行，也可以让玩家自己执行。
插件内置四大实用机制，可自由组合：冷却限制，防止物品被连续滥用；使用后消失，适合卷轴、符咒等一次性消耗品；次数限制，每把物品可用几次、还剩几次一目了然；引导时间，使用前需要原地读条，读条期间一旦移动、死亡或切换物品就会打断，打断不消耗次数，适合制作施法、回城等仪式感玩法。
物品的外观完全自定义：材质、名字、描述文字、附魔光泽都可以在配置里调整，还可配合资源包使用自定义模型。所有效果只需编辑一个配置文件，执行 /citem reload 即可生效，无需重启服务器。
| 命令 | 说明 | 权限 |
|---|---|---|
| /citem give <玩家> <物品ID> [次数]` | 发放指令物品（次数缺省用配置的 max_uses，-1 为无限） | citem.admin |
| /citem list` | 查看已配置的所有物品 | citem.admin |
| /citem reload` | 重载配置文件 | citem.admin |
| 手持物品左/右键触发 | 使用指令物品 | citem.use（默认所有玩家） |
> citem.admin` 默认仅 OP 拥有。玩家使用物品不需要任何额外权限（默认 true），如需限制可修改 citem.use。
| 需求 | 实现 |
|---|---|
| 触发方式 | trigger 配置 LEFT（左键）/ RIGHT（右键）/ BOTH，仅主手触发 |
| 执行指令 | commands 列表，console: 前缀走控制台（最高权限）、player: 前缀以玩家身份执行，无前缀默认控制台 |
| 冷却限制 | cooldown: 秒数，0 为无冷却，同种物品共用冷却 |
| 使用后消失 | consume: true，堆叠时每次消耗 1 个 |
| 次数限制 | max_uses: N，-1 为无限；次数写入物品 NBT，Lore 用 {uses} 占位符实时显示剩余次数 |
| 三项独立 / 组合 | 四类限制互不冲突，可任意搭配 |
| 引导时间 | channeling: 秒数（支持小数），引导期间移动 / 死亡 / 退出 / 切换主副手都会打断，打断不扣次数、不触发冷却 |
| 自定义外观 | material / name / lore（支持 & 颜色码）/ glow 附魔光泽 / custom_model_data 资源包模型 |
{player} {world} {x} {y} {z} {item} {uses} {max_uses}；/citem give 支持补发指定次数；物品用 NBT 标签识别，玩家改名不会被绕过，也不会与普通物品混淆。使用方式
- 把
CommandItem-1.0.0.jar丢进服务端plugins文件夹 - 重启服务端生成配置，编辑
plugins/CommandItem/config.yml（自带 3 个示例：治疗之星 / 回城卷轴 / 金币袋） - 执行
/citem reload生效，/citem give 玩家名 物品ID发放 - 玩家手持物品按配置的左 / 右键即可使用
