- 版权类型
- 原创
- 插件中文名称
- WarZ物品命令
- 插件英文名称
- WarZItemCommand
- 原帖地址
- #
- 支持的核心(服务端)
- Spigot
- Paper
- Folia
- Purpur
- PufferFish
- Leaves
- 其他核心
- 语言支持
- 中文(简体)
- 适配版本(Java)
- 1.21
- 1.20
- 1.19
- 1.18
- 1.17
- 1.16
- 1.15
- 1.14
- 1.13
- 1.12
- 1.11
- 1.10
- 1.9
- 1.8
- 1.7
WarZ系列插件Wiki:点击查阅
WarZItemCommand
WarZItemCommand 是一款 轻量级、高性能 的 Spigot 插件,
用于将 控制台命令直接绑定到游戏内物品。
管理员只需将命令写入物品,
玩家 手持并右键点击 即可触发预设指令,
无需权限、无需额外交互,极其适合 末日服 / RPG / 剧情服 / 功能道具服。
用于将 控制台命令直接绑定到游戏内物品。
管理员只需将命令写入物品,
玩家 手持并右键点击 即可触发预设指令,
无需权限、无需额外交互,极其适合 末日服 / RPG / 剧情服 / 功能道具服。
目录
功能特性
安装指南
命令与权限
使用教程
技术细节
常见问题(FAQ)
联系与支持
功能特性
全版本兼容
- 支持 Spigot / Paper 1.7.x - 1.21+
- 原生适配 Folia 多线程服务端
- 一份插件,覆盖几乎所有主流服务器环境
轻量化 & 高性能
- 1.14+:使用
PersistentDataContainer (PDC)原生数据存储 - 1.7–1.13:使用 NMS + NBTTagCompound 反射方案
无需 ProtocolLib / NBTAPI 等前置
不监听高频事件,不影响 TPS
无损物品绑定
- 命令数据 隐藏存储在 NBT
- 不修改物品名 / Lore / 材质
- 玩家完全无法感知,保持原版外观
Folia 原生优化
- 自动切换:
GlobalRegionSchedulerAsyncScheduler
- 确保线程安全,避免并发与主线程阻塞问题
控制台级权限执行
- 所有命令 以 Console 身份执行
- 可直接执行:
- 管理指令
- 经济指令
- 权限指令
- 世界控制指令
内置占位符
%player%→ 玩家名%uuid%→ 玩家 UUID- 可灵活适配任意指令场景
安装指南
安装步骤
- 下载插件:
WarZItemCommand-1.0.0.jar - 放入目录:
/plugins - 重启服务器
- 插件自动加载(无需额外配置)
兼容性说明
Spigot / Paper 1.7 - 1.12.2
Spigot / Paper 1.13 - 1.21+
Folia 多线程服务端
命令与权限
命令列表
命令 | 描述 | 权限 |
|---|---|---|
/wic help | 查看插件帮助 | warzitemcommand.use |
/wic add <命令> | 将命令绑定到手持物品 | warzitemcommand.use |
/wic remove | 移除物品上的绑定命令 | warzitemcommand.use |
权限说明
- 核心权限:
warzitemcommand.use - 建议 仅分配给 OP / 管理员
玩家使用物品触发命令不需要任何权限
使用教程
示例:制作「右键回城」物品
① 手持物品
例如:纸、羽毛、指南针等
② 绑定命令
代码:
/wic add tp %player% 0 100 0
③ 使用效果
- 玩家右键物品
- 控制台执行:
代码:tp 玩家名 0 100 0 - 实现精准传送
占位符说明
占位符 | 说明 | 示例 |
|---|---|---|
%player% | 玩家名称 | Crazy_Jky |
%uuid% | 玩家 UUID | a1b2c3d4-xxxx |
常见场景示例
经济奖励
代码:/wic add eco give %player% 100
全服公告
代码:/wic add say 玩家 %player% 使用了神秘道具!
技术细节
- NBT 键名:
wic_command - 存储机制
- 1.14+:PDC API
- 1.7–1.13:NMS + NBTTagCompound
- Folia 适配
- 自动检测 Folia 环境
- 使用官方多线程调度 API
- 无主线程阻塞风险
常见问题(FAQ)
Q1:右键物品没反应?
- 确认物品正确
- 测试命令是否能在控制台执行
- 检查服务器版本
- Folia 下确认插件无报错
Q2:普通玩家能用吗?
Q3:支持一个物品多个命令吗?
/wic add 会覆盖已有绑定
联系与支持
- 作者:Crazy_Jky
- 插件技术交流群:398893720
- 末日类服务器交流群:1063544727
- 定制 / 商务 QQ:1285988665
- 支持作者:爱发电