[娱乐|RPG|管理|其他]ItemCommand —— 给物品绑定自定义动作吧不只是命令~[全版本] - 服务端插件

502mc

本帖最后由 502mc 于 2023-1-1 16:05 编辑

插件介绍

这是一款功能齐全的物品动作插件，可以给任意物品绑定自定义动作。

可以用来实现例如称号兑换券、回城卷轴、金票银票等各种RPG物品、
每日礼包、每周礼包、~~每年礼包~~各种礼包等等··· 尽情发挥你的想象。

几乎所有值都能使用变量，插件默认提供{player}变量代表当前玩家，只需安装PAPI即可使用海量变量。

功能介绍

可根据物品显示名/Lore/类型来匹配物品

可自定义物品使用的条件，例如要达到XX级才可以使用、生命值低于XX时可以使用

可选择物品的使用方式：左键/右键点击使用、手持时使用、物品栏内左键/右键点击使用

可以自定义使用物品后执行的动作，例如玩家执行命令、后台执行命令、发送全服公告、发送聊天消息
播放指定音效、发送Title、发送ActionBar、切换BC子服等等···(详见物品配置文件)
下面列出各个版本可用的音效：
1.5 1.6.2 1.7.10 1.8.8 1.9.4 1.10.2 1.11.2 1.12.2 1.13.2 1.14.4 1.15.2 1.16.5 1.17 最新版

可以设置使用物品花费的金钱/点券/经验

可以设置使用物品需要的权限

可以设置需要消耗多少个物品才能使用

可以设置使用物品的冷却时间(每个物品单独计算)

在物品配置文件中详细讲解了插件功能，此处不再赘述，请看下面的物品配置文件
(不要看着字多就认为复杂··· 主要都是注释，用不到的功能完全可以忽略，一点也不复杂，真的！)
另外配置文件中的音效和命令都是根据高版本写的，
所以在低版本中会提示音效不存在和命令执行错误是正常情况，修改成低版本对应的音效和命令即可

插件截图

命令/权限

命令列表：

/ItemCommand add —— 将手中的物品根据命令提供的参数添加到物品配置文件

/ItemCommand give —— 将物品配置文件中定义的物品给予指定玩家
详细用法: /ItemCommand give <玩家> <物品ID> <物品数量> [物品类型]
(物品类型参数仅在指定ID的物品配置中未指定物品类型时需要, 默认为石头)
<> = 必填参数 [] = 可选参数

/ItemCommand list —— 查看已加载物品

/ItemCommand reload —— 查看插件版本

/ItemCommand type —— 查看物品类型

/ItemCommand version —— 重载插件配置

以上/ItemCommand 可以缩写为/ic

所有命令不区分大小写、所有命令支持TAB补全

权限列表：

itemcommand.admin —— 可使用/ItemCommand命令，默认OP拥有

itemcommand.cooldown.bypass —— 使用物品无视冷却时间，默认OP拥有

itemcommand.price.free —— 使用物品无需花费金钱，默认OP拥有

itemcommand.points.free —— 使用物品无需花费点券，默认OP拥有

itemcommand.levels.free —— 使用物品无需花费经验等级，默认OP拥有

配置文件

物品配置文件

#物品ID 用英文单引号括起来内容随意不要重复不要包含 . 和空格
'001':
#匹配物品显示名可选支持变量没有此项则不限物品显示名
name: '§6示例物品'
#匹配物品Lore 可选支持变量没有此项则不限物品Lore
lore:
- '§3示例Lore'
#是否精确匹配物品Lore 可选没有此项默认为true 表示需要Lore完全一致 false表示不管实际物品有多少行Lore, 只要含有配置里存在的行即可
#例如在配置中设置:
#lore:
# - 'AA'
# - 'CC'
#实际物品:
# - 'AA'
# - 'BB'
# - 'CC'
#如果使用精确匹配(true) 会认为这个物品不符合条件因为不完全一致
#如果使用包含匹配(false) 会认为这个物品符合条件因为包含AA和CC
lore-exact: true
#匹配物品类型可选没有此项则不限物品类型 (虽然name,lore,type都是可选的,但至少要提供一个)
#如果你不知道某个物品的类型是什么可以使用 /ic type 命令查看手持物品的类型
type: 'PAPER'
#使用物品需要满足的条件一行一个条件可选支持变量格式为类型:表达式,不满足条件时显示的消息(不想显示消息的话只写,即可)
#类型有三种: s = 字符串比较、 d = 数值比较、直接逻辑值(不指定类型就会被认为是直接逻辑值)
#字符串比较可使用的运算符 =(等于) !=(不等于) ==(忽略大小写等于) !==(忽略大小写不等于) >(大于) >=(大于等于) <(小于) <=(小于等于)
#数值比较可使用的运算符 =(等于) !=(不等于) >(大于) >=(大于等于) <(小于) <=(小于等于)
#直接逻辑值可使用的运算符 !(逻辑取反单目运算符) 什么是直接逻辑值? 可用的逻辑值有true false yes(等于true) no(等于false) 其他字符串=false
#什么是满足条件? 表达式执行后产生的结果如果为true 则满足条件如果为false 则不满足条件
condition:
#运算符两边必须有空格, !(单目运算符)除外
#字符串比较示例
- 's:{player} != notch, §c你的名字是notch 不能使用此物品!'
- 's:{player} != NOTCH, §c你的名字是NOTCH 不能使用此物品!'
- 's:{player} !== notch, §c别以为换了大小写我就不认识你了你还是不能使用此物品!'
#数值比较示例(因为用到了PAPI变量, 所以需要安装PAPI并启用Player扩展才能正常执行)
- 'd:%player_level% >= 30, §6等级达到30级才能使用此物品!'
#直接逻辑值示例(因为用到了PAPI变量, 所以需要安装PAPI并启用Player扩展才能正常执行)
# %player_is_flying% 会返回yes(飞行)或no(未飞行) 由于使用了!运算符进行取反所以飞行时不能使用去掉!就是飞行时才能使用了
- '!%player_is_flying%, §e由于你正在飞行不能使用此物品。'
#触发方式可同时选择多种触发方式一行一种可选默认为right
#支持的触发方式有: left(左键点击), right(右键点击), held(手持时), inv_left(物品栏内左键点击), inv_right(物品栏内右键点击)
trigger:
- 'left'
- 'right'
#物品使用后执行的动作一行一个动作支持变量可选没有此项则不执行任何动作
#可选的动作有: cmd, op, console, tell, chat, sound, sound-all, broadcast, give-money, give-points,
# title, title-all, action-bar, action-bar-all, server 不指定默认为cmd
#格式为动作: 值 (动作后面需要紧跟一个英文冒号否则无法识别出正确动作会默认为整行都是cmd动作的值)
action:
#cmd = 让使用物品的玩家执行命令命令不需要加 /
- 'cmd: help'
#op = 让使用物品的玩家以op身份执行命令同样不需要加 /
- 'op: list'
#console = 让控制台执行命令
- 'console: say hi {player}'
#tell = 给使用物品的玩家发送消息
- 'tell: hi {player}'
#chat = 让使用物品的玩家发送聊天消息
- 'chat: 我使用了§6示例物品'
#sound = 给使用物品的玩家播放指定音效
- 'sound: ENTITY_EXPERIENCE_ORB_PICKUP'
#sound-all = 给全服玩家播放指定音效
- 'sound-all: ENTITY_EXPERIENCE_ORB_PICKUP'
#broadcast = 给全服玩家发送消息(公告)
- 'broadcast: {player}使用了§6示例物品'
#give-money = 给予使用物品的玩家指定数量的钱只能为正整数使用此功能需要安装Vault以及支持Vault的经济插件
- 'give-money: 10'
#give-points = 给予使用物品的玩家指定数量的点券只能为正整数使用此功能需要安装PlayerPoints插件
- 'give-points: 10'
#title = 给使用物品的玩家发送Title消息格式标题,副标题,显示时间(秒) 注意逗号为英文逗号 1.10及以下版本会无视显示时间 1.8以下版本不支持此动作
- 'title: HiHiHi,没人看得到我因为会被覆盖,10'
#title-all = 给全服玩家发送Title消息格式同上注意新的Title会覆盖没显示完的Title 所以这条Title会覆盖掉上面那一条
- 'title-all: Hi,{player}使用了§6示例物品,10'
#action-bar = 给使用物品的玩家发送ActionBar消息 1.8及以下版本不支持此动作并且使用此动作需要使用Spigot或其衍生服务端如Paper
- 'action-bar: hi 没人看得到我'
#action-bar-all = 给全服玩家发送ActionBar消息注意新的ActionBar会覆盖没显示完的ActionBar 所以这条ActionBar会覆盖掉上面那一条
- 'action-bar-all: {player}使用了§6示例物品'
#server = 让使用物品的玩家切换到指定的BC子服如果你不知道这是什么那么你不需要此功能
- 'server: login'
#使用物品需要花费的钱可选支持变量不能为负数
price: 10
#使用物品需要花费的点券可选支持变量不能为负数
points: 10
#使用物品需要花费的经验等级可选支持变量不能为负数
levels: 10
#使用物品需要的权限可选支持变量
permission: '示例权限'
#使用物品会消耗的数量可选支持变量不能为负数物品数量不足不能使用提供0或没有此项则不消耗物品
required-amount: 1
#冷却时间单位秒可选支持变量不能为负数如果设置了冷却时间表示使用此物品后必须等待指定的时间后才能再次使用此物品(冷却时间每个物品ID单独计算)
cooldown: 10
#一个简单的匹配物品显示名的例子：
'002':
#注意所有用到颜色符号的地方请使用 § 而不是 &
name: '§6银票'
action:
- 'give-money: 100'
- 'tell: §b你使用了一张§6银票§b, 获得了100银币.'
- 'sound: ENTITY_EXPERIENCE_ORB_PICKUP'
required-amount: 1
#一个匹配物品显示名和物品类型的例子：
'003':
#注意这里就不要再用 '§6银票' 这个名称了, 因为上面那个例子只要求物品名称一致并且触发方式都是默认的right 这里再这样写就完全符合上面那个例子的匹配条件了
#name: '§6银票'
name: '§6真·银票'
#类型为纸
type: 'PAPER'
action:
- 'give-money: 1000'
- 'tell: §b你使用了一张§6真·银票§b, 获得了1000银币.'
- 'sound: ENTITY_EXPERIENCE_ORB_PICKUP'
required-amount: 1
#一个匹配物品显示名和Lore以及物品类型的例子：
'004':
name: '§6传送卷轴'
lore:
- '§a类型: §d消耗品'
- '§b使用后可以在当前世界内随机传送。'
type: 'PAPER'
action:
- 'op: tpr'
- 'sound: ITEM_BOOK_PAGE_TURN'
required-amount: 1
#同一种物品不同触发方式执行不同动作的例子(005、006)：
'005':
name: '§6§l新手保护券'
lore:
- '§d持有此保护券可在死亡时保留物品栏以及经验。'
- '§a使用方法: §b放在物品栏中自动生效'
- '§3仅限{player}本人使用'
- '§5类型: §c消耗品'
- ''
- '§7注: 本券为消耗品，每张仅能使用一次。'
type: 'PAPER'
trigger:
#手持时触发
- 'held'
action:
- 'tell: §a用不到新手保护券？右键使用每张可兑换10级经验。'
#虽然006和005的name、lore、type相同，但是触发方式并不重叠，所以不会冲突。
'006':
name: '§6§l新手保护券'
lore:
- '§d持有此保护券可在死亡时保留物品栏以及经验。'
- '§a使用方法: §b放在物品栏中自动生效'
- '§3仅限{player}本人使用'
- '§5类型: §c消耗品'
- ''
- '§7注: 本券为消耗品，每张仅能使用一次。'
type: 'PAPER'
trigger:
#右键点击触发
- 'right'
action:
- 'console: xp add {player} 10 levels'
- 'tell: §a你使用一张新手保护券兑换了10级经验。'
- 'sound: ENTITY_EXPERIENCE_ORB_PICKUP'
required-amount: 1

复制代码

语言文件

#语言文件版本号请勿修改
version: 2
log-prefix: '[ItemCommand] '
message-prefix: '§8[§3ItemCommand§8] '
language-version-error: '§c语言文件版本错误: '
language-version-outdated: '§e当前语言文件版本：§a{0} §c最新版本：§b{1} §6需要更新.'
language-update-complete: '§a语言文件更新完成!'
config-version-error: '§c配置文件版本错误: '
config-version-outdated: '§e当前配置文件版本：§a{0} §c最新版本：§b{1} §6需要更新.'
config-update-complete: '§a配置文件更新完成!'
update-found-new-version: '§c发现新版本可用! §b当前版本: {0} §d最新版本: {1}'
update-major-update: '§e(有大更新)'
update-download-link: '§a下载地址: '
update-check-failure: '§e检查更新失败, 状态码: '
update-check-exception: '§4检查更新时发生IO异常.'
load-item-error-not-match: '§4加载 {0} 时出错! name、lore、type 至少需要提供一个, 当前全未提供'
load-item-error-unknown-type: '§e加载 {0} 时出错! 未知的物品类型: type: {1}'
load-item-error-not-found-operator: '§e加载条件时出错! 在条件中未找到运算符: {0}'
load-item-error-unknown-trigger: '§e加载 {0} 时出错! 未知的触发方式: {1}'
action-execute-error-sound: '§e错误: 无法执行 sound(-all) 动作! 原因: 指定的音效 {0} 不存在'
action-execute-error-give-money-not-found-economy: '§e未找到经济插件, 无法执行 give-money 动作!'
action-execute-error-give-money-not-found-economy-tip: '§e请检查是否正确安装Vault插件以及经济提供插件! (如Essentials、CMI、Economy等)'
action-execute-error-give-money-invalid-value: '§e错误: 无法执行 give-money 动作! 原因: 无效的数字格式: {0}'
action-execute-error-give-points-not-found-points: '§e未找到点券插件, 无法执行 give-points 动作!'
action-execute-error-give-points-not-found-points-tip: '§e请检查是否正确安装PlayerPoints插件!'
action-execute-error-give-points-invalid-value: '§e错误: 无法执行 give-points 动作! 原因: 无效的数字格式: {0}'
action-execute-error-title-args-error: '§e错误: 无法执行 title(-all) 动作! 原因: 无效的参数格式: {0}'
action-execute-error-title-not-support: '§e错误: 无法执行 title(-all) 动作! 原因: 当前服务端不支持此操作'
action-execute-error-title-invalid-time: '§e错误: 无法执行 title(-all) 动作! 原因: 无效的显示时间: {0}'
action-execute-error-action-bar-not-support: '§e错误: 无法执行 action-bar(-all) 动作! 原因: 当前服务端不支持此操作'
use-item-cooling: '§4使用冷却: §c{0}§4秒。'
use-item-condition-invalid-number: '§e解析条件时出错! 在数值比较表达式中发现无效数字: {0}'
use-item-error-price: '§e解析 {0} 时出错! 无效的花费: price: {1}'
use-item-error-points: '§e解析 {0} 时出错! 无效的花费: points: {1}'
use-item-error-levels: '§e解析 {0} 时出错! 无效的花费: levels: {1}'
use-item-error-required-amount: '§e解析 {0} 时出错! 无效的需求数量: required-amount: {1}'
use-item-error-cooldown: '§e解析 {0} 时出错! 无效的冷却时间: cooldown: {1}'
use-item-error-not-economy: '§c错误: 未找到经济插件，无法扣除余额。'
use-item-error-not-points: '§c错误: 未找到点券插件，无法扣除点券。'
use-item-not-enough-money: '§c你没有足够的金钱({0})使用此物品。'
use-item-not-enough-points: '§c你没有足够的点券({0})使用此物品。'
use-item-not-enough-levels: '§c你没有足够的等级({0})使用此物品。'
use-item-not-enough-permission: '§c你没有权限使用此物品。'
use-item-not-enough-amount: '§c你没有足够数量的物品可以使用。 (需要{0}个)'
command-list: '§6已加载的物品ID列表: §a{0}'
command-reload: '§a配置文件重载完成。'
command-version: '§a当前版本: §b{0}'
command-unknown: '§6未知的子命令'
command-add-not-item: '§d你确定你手里有物品？'
command-add-not-name: '§a你手中的物品没有显示名称, 无法添加name项。'
command-add-not-lore: '§a你手中的物品没有Lore, 无法添加lore项。'
command-add-console: '§a控制台无法使用此命令。'
command-add: '§a已添加到配置文件, ID为: {0}, 快去修改吧!'
command-give-usage: '§6用法: /ic give <玩家> <物品ID> <物品数量> [物品类型]'
command-give-tip1: '§7(物品类型参数仅在指定ID的物品配置中未指定物品类型时需要, 默认为石头)'
command-give-tip2: '§b<> = 必填参数 [] = 可选参数'
command-give-not-found-player: '§c指定的玩家不在线或不存在！'
command-give-not-found-id: '§c指定的ID不存在或未能正确加载。'
command-give-invalid-amount: '§c参数错误: 无效的数量: {0}'
command-give-error-amount: '§c错误: 物品数量不能小于1'
command-give-invalid-type: '§c错误: 无效的物品类型: {0}'
command-give: '§a已将§b{0}§a个{1}§a添加到§c{2}§a的物品栏.'
command-type-not-item: '§d你确定你手里有物品？'
command-type-console: '§a控制台无法使用此命令。'
command-type: '§a当前手持物品的类型是: §b{0}'

复制代码

下载地址

ItemCommand-1.0.3.jar (85.23 KB, 下载次数: 1059)
ItemCommand-1.0.2.jar (83.97 KB, 下载次数: 43)
ItemCommand-1.0.1.jar (83.97 KB, 下载次数: 34)
ItemCommand-1.0.0.jar (82.71 KB, 下载次数: 42)
如果下载后启动时报错，那么很有可能是下载错误导致的，请重新下载或去百度网盘下载。
由用户开发的ItemCommand配置生成器如有需要可以点击前往查看

本插件已在1.5.2/1.6.4/1.7.2/1.7.10/1.8.8/1.9.4/1.10.2/1.11.2/1.12.2/1.13.2/1.14.4/1.15.2/1.16.5/1.17.1/1.18.1/1.19测试通过

插件理论兼容Minecraft 2.0.0版本之前的任何新版本，所以即使是本帖没有标明的新版本通常也能正常使用。

备用下载地址：百度网盘 提取码: xcpc

如果使用金币需要安装Vault插件以及支持Vault的经济插件(如Essentials、CMI、Economy等)

Vault下载地址：SpigotMC MCBBS

如果使用点券需要安装PlayerPoints插件

PlayerPoints下载地址：SpigotMC(1.8-1.18) Dev-Bukkit(1.2-1.10)

如果使用PAPI变量需要安装PlaceholderAPI插件并启用对应的变量扩展

PlaceholderAPI下载地址：SpigotMC MCBBS

问题反馈

如果使用过程中有任何问题/建议/意见欢迎在本帖回复或与我私信

最后，如果你觉得本插件有用,请给我评个分~

提示：评分人气不消耗自身人气

更新日志

2022-02-13 1.0.3版本发布

- 将"title-all"和"action-bar-all"动作中解析变量的玩家改为使用物品的玩家

- 新增"sound-all"动作用来给全服玩家播放指定音效

- 新增"/ic type"命令用来查看手持物品的类型

- 其他细节修正和优化

2022-02-10 1.0.2版本发布

- 修复右键使用空地图时即使设置了取消右键点击事件仍会变成地图的问题

- 其他细节修正和优化

2022-02-07 1.0.1版本发布

- 新增"lore-exact"选项用来选择Lore的匹配方式, 详见物品配置文件

2022-01-30 1.0.0版本发布

开源

插件为非盈利性插件，免费发布，严禁销售和转卖

开源协议遵循Apache-2.0

开源地址：Github

本插件所用所有代码均为原创,不存在借用/抄袭等行为

Dreamself

厉害了作者

1525659012

好家伙，正好需要类似的插件，就出来了

racrunn

MCBBS有你更精彩~

zuo_dao

不错呀，感觉用法挺多的。收藏了

苏子峰

我曹，太全面了亲

清影-Donasen

这插件也太棒了太全面了

c2839834837

MCBBS有你更精彩~

奥力給

好强大的插件，前排支持一下！

maxiaolingwc

能否用这个实现mm的技能绑定在武器上？mmc不支持。18.1，所以我想找找取代的方法

w297129629

支持支持支持

苏子峰

你好可以增加个消耗组条件吗

大概是这样:
required-item:
- 'name:我是材料:12' 扣除名字包含我是材料的物品12个
- 'lore:普通淬炼:12'

salmonn

有点复杂

502mc

苏子峰发表于 2022-2-5 23:46
你好可以增加个消耗组条件吗

大概是这样:

不好意思目前没有打算支持这样消耗物品，这种功能更适合用专用插件或定制插件去实现。
如果想使用本插件实现此功能，有个变通的方法，不过还是需要编程去实现：

另写一个插件注册一些PAPI变量，当解析这个变量的时候会返回true或false
例如检测到背包内有足够的满足条件的物品后扣除这些物品并返回true，如果不足就返回false

然后在本插件的物品配置的条件那一项中写上那个变量，例如：

condition:
- '!%变量_扣除某某材料%, §c材料不足，无法使用。'

复制代码

当然这样也挺麻烦，不过比完整写一个插件来实现要简单不少

502mc

salmonn 发表于 2022-2-6 00:05
有点复杂

一点也不复杂，如果你只想给物品绑定物品并在使用后扣除一个物品，只要复制最后一个示例物品006 修改一下就可以了，例如：

'007':
name: '§6某个物品'
lore:
- '§d物品的LORE。'
type: '物品类型'
action:
- 'cmd: 这是一条命令'
required-amount: 1

复制代码

就这么简单

青柠檬栀夏

啊吧啊吧

苏子峰

502mc 发表于 2022-2-6 13:19
不好意思目前没有打算支持这样消耗物品，这种功能更适合用专用插件或定制插件去实现。
如果想使用本插件 ...

这样也可以啊，有相关变量吗

502mc

苏子峰发表于 2022-2-6 15:44
这样也可以啊，有相关变量吗

不清楚，不知道现有的变量能不能实现你的需求，八成要自定义变量吧

苏子峰

本帖最后由苏子峰于 2022-2-6 17:04 编辑

502mc 发表于 2022-2-6 16:52
不清楚，不知道现有的变量能不能实现你的需求，八成要自定义变量吧

%checkitem_amount_namecontains:测试物品%
已有检测名字的变量了，不知道你的插件可以更新扣除相关的功能吗

- 'TAKE-ITEM: amount:1,name:测试物品'

502mc

苏子峰发表于 2022-2-6 17:03
%checkitem_amount_namecontains:测试物品%
已有检测名字的变量了，不知道你的插件可以更新扣除相关的功 ...

我看了一下这个变量扩展支持删除指定物品你可以研究一下具体用法
https://github.com/PlaceholderAP ... ceholders#checkitem

2014jdjfcg

这个插件非常的不错，除了这个插件外做RPG还有没有其它的插件综合一下？

canyan666

强烈支持

canyan666

用指令去编辑完全不会还是直接在items.yml里直接编辑来的实在

canyan666

还是在items.yml 编辑来的实在指令编辑搞不来

canyan666

该插件的
=======================================
  #使用物品需要花费的钱可选支持变量不能为负数
  price: 10

  #使用物品需要花费的点券可选支持变量不能为负数
  points: 10

而实际是奖励钱与奖励点券

在测试中服务器内未安装点券插件

在执行

  #使用物品需要花费的点券可选支持变量不能为负数
  points: 10

从而显示

[ItemCommand] 未找到点券插件, 无法执行 give-points 动作!
[ItemCommand] 请检查是否正确安装PlayerPoints插件!

=================望修复==================

下一页最后一页