在使用 ItemJoin 时遇到问题?
请参阅 故障排除 以解决您的问题。
本插件允许玩家在加入、重生、切换世界、进入区域、离开区域、首次加入和首次进入世界时获得高度自定义的物品。这是一个多功能插件,适用于在枢纽服务器、小游戏服务器或竞争类服务器(如生存、阵营、空岛及其他替代游戏模式)中向玩家发放物品。您可以为任何定义的世界设置无限数量的物品。玩家可以每次加入时都获得该物品,也可以限制数量以避免重复物品。拥有无数可能性和无限功能,但这一切取决于您的需求。如果您正在寻找某项功能,它很可能已经实现。
本插件可与 Chest Commands、BossShop、DeluxeMenus 或 CustomGUI 配合使用,从而创建由物品组成的菜单。ItemJoin 可以赋予物品一个命令,用于打开这些菜单或在指南针上执行命令将玩家传送至特定位置。只要感兴趣的插件具有可执行目标的功能性命令(例如 /menu),ItemJoin 就可以将其作为 ItemCommand 使用,因此 ItemJoin 与其他插件的交互没有具体限制。
本插件以其高功能和活跃的开发者而独特。如果缺少某项功能或最新版本中存在新漏洞,我们将迅速解决。在少数同类提供物品的插件中,这是目前唯一一款能在特定世界中为玩家提供他们选择的物品的插件,从而防止玩家将物品带入黑名单世界。如果未在世界配置中定义自定义物品,则玩家在该未指定世界中不会获得该物品;不过,除非受到限制、在切换世界时清空或使用多库存插件,否则物品会随世界转移。ItemJoin 不断扩展并添加新的生活质量功能,而其他插件要么过时,要么开发者不活跃,要么缺少功能,要么限制特定世界的物品功能已损坏!ItemJoin 旨在解决这些问题,成为终极的“加入时获取自定义物品”插件!
- 可以为单个物品定义特定的 itemflags,使物品具备特殊用途和修改后的值。
- 每个物品都可以设置特定的触发事件(triggers),以确定何时发放该物品。
- 物品可以指定自己的 ItemCommands,这些命令可以作为实例控制台、玩家、服务器、消息等执行,更多详情请参见 Wiki。
- 如果定义了特定操作,ItemCommands 可以执行相应动作,包括多次点击、左/右键点击、物理交互和/或背包点击,允许用户为每种操作定义不同的命令。
- 执行的命令可以收取经济费用,并设置自定义冷却时间、自定义音效和粒子效果。
- 设置自定义头颅纹理和头颅所有者,用于玩家头颅物品。
- 支持玩家头颅、染色箭矢、书籍、旗帜、烟花、皮革护甲、地图物品等的自定义功能。
- 支持所有物品槽位,包括护甲槽位和合成槽位。
- 根据玩家的 IP 地址限制某些物品,降低物品滥用的可能性。
- 提供原版未修改物品以及具有部分已定义功能特性的原版物品。
- 当占位符更改时动态更新物品。
- 可在特定世界中切换阻止所有物品移动或所有物品拾取。
- 物品可以限制于特定游戏模式。
- 为具有交互事件的物品(如末影珍珠或食物)指定自定义物品使用冷却时间。
- 物品可以设置玩家获得该物品的概率,即随机几率。
- 可以在加入、首次加入和切换世界时执行通用命令。
- 支持自定义附魔和不安全等级。
- 可在加入或切换世界时切换清空所有物品或仅清空 ItemJoin 物品。
- 切换是否覆盖玩家背包中现有的物品。
- 支持 PlaceholderAPI,详见 有效占位符列表。
功能数量是无限的,这要感谢所有支持本插件及其开发者的用户。
命令
您可以使用 /ItemJoin 或 /IJ 来执行命令。
itemjoin:
description: 显示插件信息、特定版本和作者,并重定向至帮助菜单。
permission: itemjoin.use
aliases: [ij]
usage: |
/itemjoin
示例: /itemjoin
itemjoin help:
description: 显示可用帮助菜单页面,展示所有可用的命令。
permission: itemjoin.use
usage: |
/itemjoin help
示例: /itemjoin help
示例: /itemjoin help 2
示例: /itemjoin help 3
示例: /itemjoin help 4
示例: /itemjoin help 5
示例: /itemjoin help 6
示例: /itemjoin help 7
示例: /itemjoin help 8
示例: /itemjoin help 9
itemjoin reload:
description: 重新加载所有插件配置文件并缓存新数据。
permission: itemjoin.reload
usage: |
/itemjoin reload
示例: /itemjoin reload - Configuration(s) Reloaded!(配置已重新加载!)
itemjoin menu:
description: 打开 GUI 菜单,允许查看、修改和创建所有自定义物品。
permission: itemjoin.menu
usage: |
/itemjoin menu
示例: /itemjoin menu - The creator menu has been launched!(创作者菜单已启动!)
itemjoin info:
description: 显示你手中物品的所需信息,例如材质类型,以及在旧版本中的数据值。
permission: itemjoin.use
usage: |
/itemjoin info
示例: /itemjoin info - The item type is WOODEN_SWORD.(物品类型为 WOODEN_SWORD。)
itemjoin world:
description: 显示你当前所在的维度/世界,有助于调试。
permission: itemjoin.use
usage: |
/itemjoin world
示例: /itemjoin world - You are in the world Pandora_the_end.(你位于维度 Pandora_the_end。)
itemjoin list:
description: 显示已定义的自定义物品及其各自启用的维度/世界。
permission: itemjoin.list
usage: |
/itemjoin list
示例: /itemjoin list - Current defines items are map-item, ultra-item.(当前定义的物品为 map-item, ultra-item。)
itemjoin updates:
description: 检查插件是否有可用更新。
permission: itemjoin.updates
usage: |
/itemjoin updates
示例: /itemjoin updates - You have requested to check for available plugin updates!(您请求检查插件的可用更新!)
itemjoin upgrade:
description: 如果发现新版本,强制插件更新至最新版本,更改生效需要重启服务器。
permission: itemjoin.upgrade
usage: |
/itemjoin upgrade
示例: /itemjoin upgrade - You have requested to force update the plugin.(您请求强制更新插件。)
itemjoin permissions:
description: 显示每个权限节点页面,展示玩家哪些权限处于启用/禁用状态,包括自定义物品相关节点。
permission: itemjoin.permissions
usage: |
/itemjoin permissions
示例: /itemjoin permissions - You have the permissions itemjoin.reload.(您拥有权限 itemjoin.reload。)
示例: /itemjoin permissions 2 - You have the permissions ultra-item.(您拥有权限 ultra-item。)
itemjoin get:
description: 将指定的自定义物品及数量添加至玩家的背包中。
permission: itemjoin.get, itemjoin.get.others
usage: |
/itemjoin get
示例: /itemjoin get Ultra - You have received the item [Ultra]!(您收到了物品 [Ultra]!)
示例: /itemjoin get Ultra 12 - You have received 12x of the item [Ultra]!(您收到了 12 个 [Ultra] 物品!)
示例: /itemjoin get Ultra RockinChaos - You have given the item [Ultra] to RockinChaos!(您已将物品 [Ultra] 给予 RockinChaos!)
示例: /itemjoin get Ultra RockinChaos 8 - You have given 8x of the item [Ultra] to RockinChaos!(您已将 8 个 [Ultra] 物品给予 RockinChaos!)
itemjoin getOnline:
description: 将指定的自定义物品及数量发送给所有在线玩家。
permission: itemjoin.get.others
usage: |
/itemjoin getOnline
示例: /itemjoin getOnline Ultra - You have given the item [Ultra] to RockinChaos!(您已将物品 [Ultra] 给予 RockinChaos!)
示例: /itemjoin getOnline Ultra 8 - You have given 8x of the item [Ultra] to RockinChaos!(您已将 8 个 [Ultra] 物品给予 RockinChaos!)
itemjoin getall:
description: 将所有自定义物品发送给指定玩家。
permission: itemjoin.get, itemjoin.get.others
usage: |
/itemjoin getall
示例: /itemjoin getall - You have received all of the ItemJoin items.(您收到了所有 ItemJoin 物品。)
示例: /itemjoin getall RockinChaos - You have given RockinChaos all of the ItemJoin items that are available.(您已将所有可用的 ItemJoin 物品给予 RockinChaos。)
itemjoin remove:
description: 从玩家背包中移除指定的自定义物品及数量。
permission: itemjoin.remove, itemjoin.remove.others
usage: |
/itemjoin remove
示例: /itemjoin remove Ultra - You have removed the item [Ultra]!(您移除了物品 [Ultra]!)
示例: /itemjoin remove Ultra 12 - You have removed 12x of the item [Ultra]!(您移除了 12 个 [Ultra] 物品!)
示例: /itemjoin remove Ultra RockinChaos - You have removed the item [Ultra] to RockinChaos!(您已从 RockinChaos 处移除物品 [Ultra]!)
示例: /itemjoin remove Ultra RockinChaos 8 - You have removed 8x of the item [Ultra] to RockinChaos!(您已从 RockinChaos 处移除了 8 个 [Ultra] 物品!)
itemjoin removeOnline:
description: 从所有在线玩家背包中移除指定的自定义物品及数量。
permission: itemjoin.remove.others
usage: |
/itemjoin removeOnline
示例: /itemjoin removeOnline Ultra - You have removed the item [Ultra] from RockinChaos!(您已从 RockinChaos 处移除物品 [Ultra]!)
示例: /itemjoin removeOnline Ultra 8 - You have removed 8x of the item [Ultra] from RockinChaos!(您已从 RockinChaos 处移除了 8 个 [Ultra] 物品!)
itemjoin removeall:
description: 从指定玩家背包中移除所有自定义物品。
permission: itemjoin.remove, itemjoin.remove.others
usage: |
/itemjoin removeall
示例: /itemjoin removeall - You have removed all of the ItemJoin items from your inventory.(您已从背包中移除所有 ItemJoin 物品。)
示例: /itemjoin removeall RockinChaos - You have removed all of the ItemJoin items from RockinChaos.(您已从 RockinChaos 处移除所有 ItemJoin 物品。)
itemjoin enable:
description: 允许为所有玩家或指定玩家全局启用自定义物品,或针对特定玩家和维度启用。
permission: itemjoin.enable, itemjoin.enable.others
usage: |
/itemjoin enable
示例:/itemjoin enable - 您已全局启用自定义物品。
示例:/itemjoin enable RockinChaos - 您已为 RockinChaos 启用自定义物品!
示例:/itemjoin enable RockinChaos world_the_end - 您已为 RockinChaos 在维度 world_the_end 中启用自定义物品!
itemjoin disable:
description: 禁用所有玩家或指定玩家的全局自定义物品使用,或针对特定玩家和维度禁用。
permission: itemjoin.disable, itemjoin.disable.others
usage: |
/itemjoin disable
示例:/itemjoin disable - 您已全局禁用自定义物品。
示例:/itemjoin disable RockinChaos - 您已为 RockinChaos 禁用自定义物品!
示例:/itemjoin disable RockinChaos world_the_end - 您已为 RockinChaos 在维度 world_the_end 中禁用自定义物品!
itemjoin purge:
description: 清除数据库中所有玩家或指定玩家的所有数据或指定数据。
permission: itemjoin.purge
usage: |
/itemjoin purge
示例:/itemjoin purge - 您已从数据库文件中清除了所有数据!
示例:/itemjoin purge first-join - 您已从数据库文件中清除了所有首次加入数据!
示例:/itemjoin purge first-world - 您已从数据库文件中清除了所有首次进入世界数据!
示例:/itemjoin purge ip-limits - 您已从数据库文件中清除了所有 IP 限制数据!
示例:/itemjoin purge first-join RockinChaos - 您已从数据库文件中清除了 RockinChaos 的所有首次加入数据!
示例:/itemjoin purge first-world RockinChaos - 您已从数据库文件中清除了 RockinChaos 的所有首次进入世界数据!
示例:/itemjoin purge ip-limits RockinChaos - 您已从数据库文件中清除了 RockinChaos 的所有 IP 限制数据!
<center>
<b>权限</b>
请注意:权限区分大小写,包括世界名称!
</center>
itemjoin.*:
description: 授予插件所有方面的访问权限,包括每个权限节点。
default: false
children:
itemjoin.all: true
itemjoin.all:
description: 授予插件所有方面的访问权限,包括每个权限节点。
default: false
children:
itemjoin.use: true
itemjoin.reload: true
itemjoin.menu: true
itemjoin.updates: true
itemjoin.upgrade: true
itemjoin.permissions: true
itemjoin.list: true
itemjoin.purge: true
itemjoin.get: true
itemjoin.get.others: true
itemjoin.remove: true
itemjoin.remove.others: true
itemjoin.enable: true
itemjoin.enable.others: true
itemjoin.disable: true
itemjoin.disable.others: true
itemjoin.bypass.inventorymodify: false
itemjoin.use:
description: 授予基本插件命令的访问权限。
default: true
itemjoin.menu:
description: 授予菜单命令的访问权限。
default: false
itemjoin.reload:
description: 重载命令的访问权限。
default: false
itemjoin.updates:
description: 更新命令的访问权限。
default: false
itemjoin.upgrade:
description: 升级命令的访问权限。
default: false
itemjoin.permissions:
description: 权限命令的访问权限
default: true
itemjoin.list:
description: 列表命令的访问权限。
default: false
itemjoin.purge:
description: 清除命令的访问权限。
default: false
itemjoin.get:
description: 基本获取命令的访问权限。
default: false
itemjoin.get.others:
description: 授予可能影响其他玩家的所有获取命令的访问权限。
default: false
itemjoin.remove:
description: 基本移除命令的访问权限。
default: false
itemjoin.remove.others:
description: 授予可能影响其他玩家的所有移除命令的访问权限。
default: false
itemjoin.enable:
description: 基本启用命令的访问权限。
default: false
itemjoin.enable.others:
description: 授予可能单独影响其他玩家的所有启用命令的访问权限。
default: false
itemjoin.disable:
description: 基本禁用命令的访问权限。
default: false
itemjoin.disable.others:
description: 授予可能单独影响其他玩家的所有禁用命令的访问权限。
default: false
itemjoin.bypass.inventorymodify:
description: 拥有此权限的玩家将绕过任何物品移动限制。
default: false
<center>
<b>物品权限</b>
这些是非服务器管理员玩家接收物品所需的权限。
</center>
itemjoin.<world>.<item>:
description: 授予在特定世界中获取特定物品的权限。
用指定物品的名称替换 <item> 参数,
并用要接收该物品的世界名称替换 <world> 参数。
itemjoin.<world>.*:
description: 授予从指定世界获取所有物品的权限。
用要接收该物品的世界名称替换 <world> 参数。
<center>
虽然此权限默认未赋予,但默认情况下所有物品的权限要求都已禁用。要使此权限生效(仅当您打算使用物品权限时),请在 config.yml 中将 Permissions.Obtain-Item 设置为 TRUE。
<br></br>
如果您希望为每个物品设置自定义权限节点,您可以单独配置它们,这将覆盖上面显示的默认节点。您只需将权限节点添加到您的物品中即可,在这种情况下,我们将其命名为 itemjoin.specialty,但实际上它可以是任何名称,例如 chicken.fingers。您需要将该权限赋予玩家,并以以下格式将其添加到物品中:permission-node: 'itemjoin.specialty'。最后,自定义权限节点可以与默认权限节点互换使用,在您只想让少数物品具有自定义权限节点的情况下尤为适用。
</center>
示例:
itemjoin.world_the_end.*
itemjoin.world_the_end.ultra-item
items:
example-item:
id: DIAMOND_SWORD
slot: 0
permission-node: 'itemjoin.specialty'
<center>
如果您需要更详细、解释更好的<a href="https://github.com/RockinChaos/ItemJoin/wiki/Commands">命令</a>和<a href="https://github.com/RockinChaos/ItemJoin/wiki/Permissions">权限</a>,可以在<a href="https://github.com/RockinChaos/ItemJoin/wiki">维基</a>上找到。
<br></br>
<br></br>
<b>英文教程</b>
<br></br>
<br></br>
<br></br>
<br></br>
<br></br>
<b>意大利语教程</b>
<br></br>
<br></br>
</center>
<br></br>
_ItemJoin 有自己专用的 [Custom API](https://github.com/RockinChaos/ItemJoin/wiki/API-&-Dependencies#itemjoins-custom-api) 吗?_
* 是的,ItemJoin 确实允许其他插件在必要时进行挂钩。所有 API 选项均位于 me.RockinChaos.itemjoin.api.ItemJoinAPI 下。
* 您可以在这里查看所有可用方法;[可用方法](https://github.com/RockinChaos/ItemJoin/blob/master/src/me/RockinChaos/itemjoin/api/ItemJoinAPI.java)。
* 如果您希望添加某个方法,欢迎在 [GitHub](https://github.com/RockinChaos/ItemJoin/issues) 上提交请求!
_ItemJoin 支持占位符吗?_
* 是的,ItemJoin 默认自带少量占位符,但您可以将 ItemJoin 与 [PlaceholderAPI ](https://www.spigotmc.org/resources/placeholderapi.6245/)挂钩以实现终极占位符功能!只需在 config.yml 中将 PlaceholderAPI 设置为 true 即可
_ItemJoin 是否支持多个世界?_
* 是的,ItemJoin 会根据 `items.yml` 中指定的每个世界给予物品。未在 `items.yml` 中定义的任何服务器世界将不会获得物品。
您还可以让 ItemJoin 与 [Multiverse-Core](http://dev.bukkit.org/bukkit-plugins/multiverse-core/) 和 [Multiverse-Inventories](http://dev.bukkit.org/bukkit-plugins/multiverse-inventories/) 集成,这样在不同世界之间切换时,无需清空玩家的背包即可拥有不同的物品。只需在 `config.yml` 中将 Multiverse-core 和 Multiverse-Inventories 设置为 true 即可。
_我可以在首次加入时仅获取物品吗?_
* 可以,ItemJoin 对首次加入模式具有极高的兼容性。您只需要在 `items.yml` 的每个物品中添加 `first-join` 物品标志(itemflag),即可实现仅在首次加入时获取该物品。您可以设置仅在首次加入时获取一组物品,而其他物品每次都会获取;或者简单地设置所有物品仅在首次加入时获取。如果您希望每次重新加入时都能收到物品,只需从该物品中移除 `first-join` 物品标志即可。
_我可以限制特定 IP 地址的玩家获取物品吗?_
* 可以,ItemJoin 对 IP 限制模式具有极高的兼容性。您只需要在 `items.yml` 的每个物品中添加 `IP-limit` 物品标志,即可将这些物品限制为特定玩家的 IP。您可以设置仅在一组物品中使用 IP 限制,而其他物品不受 IP 地址影响;或者简单地设置所有物品都受限制。您还可以指定 `first-join` 物品标志与 `IP-limit` 物品标志配合使用,以同时限制物品的 IP 地址,并仅在首次加入时发放。
_ItemJoin 是否有任何依赖项?_
* ItemJoin 没有零必需的依赖项,但有一些可选依赖项可以让您的体验更好!
* 您可以在 [Wiki 页面](https://github.com/RockinChaos/ItemJoin/wiki/API-&-Dependencies) 上了解更多关于这些 API / Hook 的信息。
* [Vault ](https://dev.bukkit.org/bukkit-plugins/vault/)- 您可以接入 Vault 以在 ItemJoin 的命令中使用您的经济系统!
* [PlaceholderAPI ](https://www.spigotmc.org/resources/placeholderapi.6245/)- 您可以在 ItemJoin 的任何部分使用所有这些占位符!无论是命令、名称、描述、头颅持有者、书籍描述、作者等!ItemJoin 的所有部分都已接入 PlaceholderAPI。
* [Multiverse-Core](http://dev.bukkit.org/bukkit-plugins/multiverse-core/) - 仅用于 Multiverse-Inventories,因为 ItemJoin 在没有此插件的情况下已经支持多世界。
* [MyWorlds ](https://www.spigotmc.org/resources/myworlds.39594/)- 允许轻松的多世界支持。
* [Multiverse-Inventories ](http://dev.bukkit.org/bukkit-plugins/multiverse-inventories/)- 使用 ItemJoin 轻松设置世界背包。您可以设置在加入和世界切换时获取物品,而无需清空玩家背包!这对 ItemJoin 的背包管理非常有用。
* [xInventories ](https://www.spigotmc.org/resources/xinventories.657/)- 使用 ItemJoin 轻松设置世界背包。您可以设置在加入和世界切换时获取物品,而无需清空玩家背包!这对 ItemJoin 的背包管理非常有用。
* [PerWorldInventory ](https://www.spigotmc.org/resources/per-world-inventory.4482/)- 使用 ItemJoin 轻松设置世界背包。您可以设置在加入和世界切换时获取物品,而无需清空玩家背包!这对 ItemJoin 的背包管理非常有用。我最近看到这个插件开始无处不在,它似乎是 Multiverse-Inventories 的一个很棒的选择。
* [PerWorldPlugins ](https://dev.bukkit.org/bukkit-plugins/perworldplugins/)- 由于不建议这样做(因为 ItemJoin 会在未在世界列表下定义的任何世界中禁用),但如果您的服务器上运行了 PerWorldPlugins,ItemJoin 确实支持 PerWorldPlugins,并且 ItemJoin 将在 PerWorldPlugins 不允许的世界中被禁用。
* [AuthMe ](https://www.spigotmc.org/resources/authme-reloaded.6269/)- 玩家在输入登录命令并完全注册到 AuthMe 后将获得物品。
* [WorldGuard](https://dev.bukkit.org/projects/worldguard) - 玩家在进入每个物品下定义的指定区域后将获得物品,离开该区域后物品将被收回。这允许创建仅限区域的物品,并且只能在指定区域内使用,除非另有定义。
* [TokenEnchant](https://www.spigotmc.org/resources/tokenenchant.2287/) - 现在可以在接收物品时赋予特定的 TokenEnchantments。
* [BetterNick ](https://www.spigotmc.org/resources/better-nick-api-1-8-3-1-12-2.39633/)- 如果某些情况下物品出现问题并且您使用了这个插件,将此设置为 true 可能会解决物品无法正常工作的问題。这允许 ItemJoin 轻松找到您的原始玩家名称和 UUID,如果您使用 BetterNick 进行了昵称。
* [HeadDatabase](https://www.spigotmc.org/resources/head-database-11-000-heads.14280/) - 物品现在可以接入 HeadDatabase 并使用 <hdb-head id> 从中获取玩家头颅。
<center>
有关 ItemJoin 的更多信息请在此处查看;
<a href="https://github.com/RockinChaos/ItemJoin/wiki">https://github.com/RockinChaos/ItemJoin/wiki</a>
<br></br><br></br>
<br></br><br></br>
<br></br>
衷心感谢那些捐赠以帮助支持插件开发的人。重要的是捐赠的事实,而不是捐赠的金额,因为这些支持者捐赠是为了支持他们所热爱的东西。即使是最小的捐赠也意义重大,因为它让我感到我所创造的东西是被需要的。每一笔捐赠都激励着我,给了我保持这个插件存活和繁荣的动力。
</center>
<Awesome Crafters>
TheRobLP => $168.04USD
momoservertw => $116.00USD
Terbin => $20.00USD
Siuan => $20.00USD
JackScurvy => $10.00USD
Malum => $10.00USD
MrPranklez => $10.00USD
Jaocb => $5.00USD
Kubson_19 => $5.00USD
Graatvis => $3.00USD
TheColdEmerald => $1.00USD
Vxrrxckter => $1.00USD
CloneMC => $0.55USD
Slimedog => $UNKUSD
piggalotgaming => $UNKUSD
XYBlue => $UNKUSD
Moemilords => $UNKUSD
Askarion => $UNKUSD
</Awesome Crafters>
```
显示为 UNK 值的支持者是我无法计算捐赠金额的人。如果您是这些支持者之一,并且知道您贡献的金额,请联系我,我将填入正确的数值。如果您也想成为这些了不起的支持者的一员,请考虑进行捐赠,这是向开发者表达感谢的最佳方式!
★ 请求的更改 ★
请通过私信向我发送功能请求,我会始终查看并回复您。
删除线 请求表示已完成。
no.1) ........
Having issues with ItemJoin?
Please see Troubleshooting to resolve your problem.
This plugin grants the ability to give highly custom items to players upon joining, respawning, world-switch, region-enter, region-exit, first-join, and first-world. This is a multi-purpose plugin for giving items to players on a hub server, minigame servers, or even competitive servers such as survival, factions, skyblock, and other alternative game settings. You can set up an infinite amount of items for any specific world(s) you define. Players can be given the item every time upon joining or limit them to a set amount so they do not have any duplicate items. There are so many possibilities and limitless features but only if you want that ability. If there is a feature you are looking for it is likely to have already been implemented.
This plugin can be used with Chest Commands, BossShop, DeluxeMenus, or even CustomGUI which will allow the creation of menus made of items which ItemJoin could have an item with a command bound to open these menus or to execute commands on a compass to warp players to specific locations. There are no specific restrictions for how ItemJoin can interact with other plugins, as long as the plugin of interest has commands to execute their objectives such as /menu, then ItemJoin can utilize that as an ItemCommand.
This plugin is unique for its high functionality and hyperactive developer, if there is a feature that is missing or a new bug in the latest update it will be resolved swiftly. Out of the very few similar category plugins that give items, this is currently the only plugin out there that gives the player an item of their choice in a specific world, so players do not carry items to a black-listed world. If the world is not defined under the custom item players will not be given that item in the unspecified world although, items will transfer worlds unless it has been restricted, clear on world-switch, or use a multi-inventory plugin. ItemJoin is always expanding and adding new quality-of-life features, other plugins are either out of date, have inactive developers, missing features, or limiting items to a specific world is broken! ItemJoin was built on the idea of resolving these problems, to become the ultimate custom items on join plugin!
- Individual items can be defined with specific itemflags which give the item special utilization and modified values.
- Each item can be set with specific trigger events called triggers which will determine when the item will be given.
- Items can be specified with their own specific ItemCommands which can be executed as an instance console, player, server, message, and more available in the wiki.
- ItemCommands can be executed with certain actions if defined, multi-click, left/right-click, physical, and/or inventory click, which will allow the user to define different commands for each action.
- Executed commands can be charged an economical cost and put on a custom cooldown with custom sounds and particles.
- Set custom skull textures and skull owners to player head items.
- Supports custom features for player heads, tipped arrows, books, banners, fireworks, leather armor, map items, and more.
- Every item slot is supported, including armor slots and crafting slots.
- Restrict certain items to a player's ip-address, reducing the chances of item abuse.
- Give vanilla unmodified items as well as vanilla items that have the functionality of some defined features.
- Dynamically updates items when a placeholder is changed.
- Toggle blocking ALL item movement or ALL item pickups in specific worlds.
- Items can be limited to specific gamemodes.
- Specify custom item-usage cooldowns for items that have interaction events such as ender pearls or even food items.
- Items can be given a probability of players receiving an item, a random chance.
- General commands can be executed upon join, first-join, and world-switch.
- Custom enchants and unsafe levels.
- Toggle between clearing ALL or only ItemJoin items upon joining or world-switch.
- Toggle overwriting existing items in the player's inventories.
- Supports PlaceholderAPI, see the valid placeholders.
The number of features is limitless and it's thanks to all of you supporting this plugin and the developer.
Commands
You can either use /ItemJoin or /IJ to execute a command.
itemjoin:
description: Shows the plugin information, specific version, and author including a redirect
to the help menu.
permission: itemjoin.use
aliases: [ij]
usage: |
/itemjoin
Example: /itemjoin
itemjoin help:
description: Displays a page of the available help menu showing the available commands.
permission: itemjoin.use
usage: |
/itemjoin help
Example: /itemjoin help
Example: /itemjoin help 2
Example: /itemjoin help 3
Example: /itemjoin help 4
Example: /itemjoin help 5
Example: /itemjoin help 6
Example: /itemjoin help 7
Example: /itemjoin help 8
Example: /itemjoin help 9
itemjoin reload:
description: Reloads all plugin configuration files and caches any new data.
permission: itemjoin.reload
usage: |
/itemjoin reload
Example: /itemjoin reload - Configuration(s) Reloaded!
itemjoin menu:
description: Opens a GUI Menu to allow the view, modification, and creation of all custom items.
permission: itemjoin.menu
usage: |
/itemjoin menu
Example: /itemjoin menu - The creator menu has been launched!
itemjoin info:
description: Displays any needed information for the item you are holding, such as material type
and in legacy versions the data value.
permission: itemjoin.use
usage: |
/itemjoin info
Example: /itemjoin info - The item type is WOODEN_SWORD.
itemjoin world:
description: Shows you what world you are in, useful for debugging purposes.
permission: itemjoin.use
usage: |
/itemjoin world
Example: /itemjoin world - You are in the world Pandora_the_end.
itemjoin list:
description: Shows you what items are defined and their respective enabled worlds.
permission: itemjoin.list
usage: |
/itemjoin list
Example: /itemjoin list - Current defines items are map-item, ultra-item.
itemjoin updates:
description: Checks for any available updates for the plugin.
permission: itemjoin.updates
usage: |
/itemjoin updates
Example: /itemjoin updates - You have requested to check for available plugin updates!
itemjoin upgrade:
description: Forces the plugin to update to the latest version if a new version is found,
a server restart will be required for changes to take effect.
permission: itemjoin.upgrade
usage: |
/itemjoin upgrade
Example: /itemjoin upgrade - You have requested to force update the plugin.
itemjoin permissions:
description: Displays a page of every permission node showing which permissions are
enabled/disabled for the player, including custom item nodes.
permission: itemjoin.permissions
usage: |
/itemjoin permissions
Example: /itemjoin permissions - You have the permissions itemjoin.reload.
Example: /itemjoin permissions 2 - You have the permissions ultra-item.
itemjoin get:
description: Gives the specified custom item and the amount you specified to the player's inventory.
permission: itemjoin.get, itemjoin.get.others
usage: |
/itemjoin get
Example: /itemjoin get Ultra - You have received the item [Ultra]!
Example: /itemjoin get Ultra 12 - You have received 12x of the item [Ultra]!
Example: /itemjoin get Ultra RockinChaos - You have given the item [Ultra] to RockinChaos!
Example: /itemjoin get Ultra RockinChaos 8 - You have given 8x of the item [Ultra] to RockinChaos!
itemjoin getOnline:
description: Gives the specified custom item and the amount to all online players.
permission: itemjoin.get.others
usage: |
/itemjoin getOnline
Example: /itemjoin getOnline Ultra - You have given the item [Ultra] to RockinChaos!
Example: /itemjoin getOnline Ultra 8 - You have given 8x of the item [Ultra] to RockinChaos!
itemjoin getall:
description: Gives all custom items to the specified player.
permission: itemjoin.get, itemjoin.get.others
usage: |
/itemjoin getall
Example: /itemjoin getall - You have received all of the ItemJoin items.
Example: /itemjoin getall RockinChaos - You have given RockinChaos all of the
ItemJoin items that are available.
itemjoin remove:
description: Removes the specified custom item and the amount you specified from the player's inventory.
permission: itemjoin.remove, itemjoin.remove.others
usage: |
/itemjoin remove
Example: /itemjoin remove Ultra - You have removed the item [Ultra]!
Example: /itemjoin remove Ultra 12 - You have removed 12x of the item [Ultra]!
Example: /itemjoin remove Ultra RockinChaos - You have removed the item [Ultra] to RockinChaos!
Example: /itemjoin remove Ultra RockinChaos 8 - You have removed 8x of the item [Ultra] to RockinChaos!
itemjoin removeOnline:
description: Removes the specified custom item and the amount from all online players.
permission: itemjoin.remove.others
usage: |
/itemjoin removeOnline
Example: /itemjoin removeOnline Ultra - You have removed the item [Ultra] from RockinChaos!
Example: /itemjoin removeOnline Ultra 8 - You have removed 8x of the item [Ultra] from RockinChaos!
itemjoin removeall:
description: Removes all custom items from the specified player.
permission: itemjoin.remove, itemjoin.remove.others
usage: |
/itemjoin removeall
Example: /itemjoin removeall - You have removed all of the ItemJoin items from your inventory.
Example: /itemjoin removeall RockinChaos - You have removed all of the ItemJoin items from RockinChaos.
itemjoin enable:
description: Enables the use of custom items for all players or specified players globally
or specified player and world.
permission: itemjoin.enable, itemjoin.enable.others
usage: |
/itemjoin enable
Example: /itemjoin enable - You have globally enabled custom items.
Example: /itemjoin enable RockinChaos - You have enabled custom items for RockinChaos!
Example: /itemjoin enable RockinChaos world_the_end - You have enabled custom items for RockinChaos
in the world world_the_end!
itemjoin disable:
description: Disables the use of custom items for all players or specified players globally
or specified player and world.
permission: itemjoin.disable, itemjoin.disable.others
usage: |
/itemjoin disable
Example: /itemjoin disable - You have globally disabled custom items.
Example: /itemjoin disable RockinChaos - You have disabled custom items for RockinChaos!
Example: /itemjoin disable RockinChaos world_the_end - You have disabled custom items for RockinChaos
in the world world_the_end!
itemjoin purge:
description: Purges ALL data or the specified data from the database file for ALL players
or the specified player.
permission: itemjoin.purge
usage: |
/itemjoin purge
Example: /itemjoin purge - You have purged ALL data from the database file!
Example: /itemjoin purge first-join - You have purged ALL first-join data from the database file!
Example: /itemjoin purge first-world - You have purged ALL first-world data from the database file!
Example: /itemjoin purge ip-limits - You have purged ALL IP-limit data from the database file!
Example: /itemjoin purge first-join RockinChaos - You have purged ALL first-join data of RockinChaos
from the database file!
Example: /itemjoin purge first-world RockinChaos - You have purged ALL first-world data of RockinChaos
from the database file!
Example: /itemjoin purge ip-limits RockinChaos - You have purged ALL ip-limit data of RockinChaos
from the database file!
Permissions
Please note; permissions are case-sensitive, including the world names!
itemjoin.*:
description: Grants access to all aspects of the plugin, including every permission node.
default: false
children:
itemjoin.all: true
itemjoin.all:
description: Grants access to all aspects of the plugin, including every permission node.
default: false
children:
itemjoin.use: true
itemjoin.reload: true
itemjoin.menu: true
itemjoin.updates: true
itemjoin.upgrade: true
itemjoin.permissions: true
itemjoin.list: true
itemjoin.purge: true
itemjoin.get: true
itemjoin.get.others: true
itemjoin.remove: true
itemjoin.remove.others: true
itemjoin.enable: true
itemjoin.enable.others: true
itemjoin.disable: true
itemjoin.disable.others: true
itemjoin.bypass.inventorymodify: false
itemjoin.use:
description: Grants access to basic plugin commands.
default: true
itemjoin.menu:
description: Grants access to the menu command.
default: false
itemjoin.reload:
description: Grants access to the reload command.
default: false
itemjoin.updates:
description: Grants access to the updates command.
default: false
itemjoin.upgrade:
description: Grants access to the upgrade command.
default: false
itemjoin.permissions:
description: Grants access to the permissions command
default: true
itemjoin.list:
description: Grants access to the list command.
default: false
itemjoin.purge:
description: Grants access to the purge command.
default: false
itemjoin.get:
description: Grants access to the basic get commands.
default: false
itemjoin.get.others:
description: Grants access to all get commands that could affect other players.
default: false
itemjoin.remove:
description: Grants access to the basic remove commands.
default: false
itemjoin.remove.others:
description: Grants access to all remove commands that could affect other players.
default: false
itemjoin.enable:
description: Grants access to the basic enable command.
default: false
itemjoin.enable.others:
description: Grants access to all enabled commands that could affect other players individually.
default: false
itemjoin.disable:
description: Grants access to the basic disable command.
default: false
itemjoin.disable.others:
description: Grants access to all disable commands that could affect other players individually.
default: false
itemjoin.bypass.inventorymodify:
description: Players with this permission will bypass any item movement restrictions.
default: false
Item Permissions
These are the permission(s) required for players who are not server administrators to receive the item(s).
itemjoin.<world>.<item>:
description: Gives permission to get a specific item in a specific world.
Replace the <item> argument with the name of the specified item and
the <world> argument with the name of the world to receive that item.
itemjoin.<world>.*:
description: Gives permission to get all items from the specified world.
Replace the <world> argument with the name of the world to receive that item.
While this permission is NOT given by default, ALL items have their permission requirement disabled by default. In order for this permission to work (only if you intend on using item permissions), in the config.yml set Permissions.Obtain-Item to TRUE.
If you want to have a custom permission node for each item, you can set up individual ones which will supersede the default node shown above. All you have to do is add the permission node to your item, in this case, we will call it itemjoin.specialty but it can technically be anything such as chicken.fingers. The permission you choose will need to be given to the player and added to the item in this format permission-node: 'itemjoin.specialty'. Lastly, custom permission nodes can be used interchangeably with the default permission nodes in the instance where you only want a few items to have custom permission nodes.
Example(s):
itemjoin.world_the_end.*
itemjoin.world_the_end.ultra-item
items:
example-item:
id: DIAMOND_SWORD
slot: 0
permission-node: 'itemjoin.specialty'
If you want more detailed, better-explained commands and permissions they can be found on the wiki.
English Tutorial(s)
Italian Tutorial(s)
Does ItemJoin have its own Custom API?
- Yes, ItemJoin does in fact allow other plugins to hook into it if needed. All API options are located under me.RockinChaos.itemjoin.api.ItemJoinAPI.
- You can see all available methods here; Available Methods.
- If you wish to see a method added feel free to submit a request on GitHub!
Does ItemJoin support placeholders?
- Yes, ItemJoin has few placeholders by default but you can hook ItemJoin with PlaceholderAPI for ultimate placeholders! Just set PlaceholderAPI to true in the config.yml
Does ItemJoin support multiple worlds?
- Yes, ItemJoin gives items to each specified world in the items.yml. Any server worlds not defined in the items.yml will not receive items.
You can also have ItemJoin hook into Multiverse-Core & Multiverse-Inventories so you can have different items per world without clearing the player's inventory when they switch worlds. Just set Multiverse-core and Multiverse-Inventories to true in the config.yml.
Can I get items on first-join only?
- Yes, ItemJoin has extreme compatibility with the first join mode. All you have to do is simply add the first-join itemflag to each item in the items.yml to get that item on the first join only. You can make it so only a set of items are given on first-join and others are given every time, or simply just make it so all items on first-join. If you want to receive the item every time you join again, just simply remove the first-join itemflag from the item.
Can I limit items to specific players' ip-address?
- Yes, ItemJoin has extreme compatibility with ip limit mode. All you have to do is simply add the IP-limit itemflag to each item in the items.yml to limit those items to the specific player's ip. You can make it so only a set of items are given in an IP-limit and others are given regardless of the ip-address, or simply just make it so all items are in a limit. You can also specify the first-join itemflag to work alongside the IP-limit itemflag to limit the item's ip-address as well as give them upon first joining only.
Does ItemJoin have any dependencies?
- ItemJoin has ZERO required dependencies but there are some optional ones that can make your experience much better!
- You can learn more about these APIs / Hooks on the wiki page.
- Vault - You can hook into Vault to use your economy on ItemJoin's commands!
- PlaceholderAPI - You can use all of these placeholders on any part of ItemJoin! Whether it's commands, name, lore, skull-owner, book-lore, authors, etc! All parts of ItemJoin are hooked into PlaceholderAPI.
- Multiverse-Core - Only used for Multiverse-Inventories as ItemJoin already has multi-world support without this.
- MyWorlds - Allows easy multi-world support.
- Multiverse-Inventories - Easily set world inventories using ItemJoin. You can make it so you get the items on join and world change without clearing the player's inventory! Very helpful with ItemJoin inventory management.
- xInventories - Easily set world inventories using ItemJoin. You can make it so you get the items on join and world change without clearing the player's inventory! Very helpful with ItemJoin inventory management.
- PerWorldInventory - Easily set world inventories using ItemJoin. You can make it so you get the items on join and world change without clearing the player's inventory! Very helpful with ItemJoin inventory management. I have recently seen this plugin start to pop up everywhere and it seems like an amazing alternative to Multiverse-Inventories.
- PerWorldPlugins - As it is not recommended since ItemJoin is disabled in any world that is not defined under world-list but, ItemJoin does support PerWorldPlugins if you happen to have it running on your server for some reason and ItemJoin will be disabled in worlds that are not allowed by PerWorldPlugins.
- AuthMe - Items will be given after the player types the login command and fully registers to AuthMe.
- WorldGuard - Items will be given after the player enters the specified region defined under each item, upon leaving the region the items will be revoked. This allows the creation of region-only items and can only be used in the specified regions unless defined otherwise.
- TokenEnchant - Items will now be able to be given specific TokenEnchantments when receiving them.
- BetterNick - If items for some reason end up breaking and you use this plugin, setting this to true could resolve issues with items not working properly. This allows ItemJoin to easily find your original player name and UUID if you are nicknamed using BetterNick.
- HeadDatabase - Items can now hook into HeadDatabase and fetch player heads from there using <hdb-head id>.
More Information on ItemJoin can be found here;
A massive thanks to those who have donated to help support the plugin's development. It is not the amount donated that matters, it is the fact that these supporters donated to support what they love. Even the smallest donation means so much because it grants the feeling that I have created something that is wanted. Every donation inspires and gives me the motivation to keep this plugin alive and thriving.
<Awesome Crafters>
TheRobLP => $168.04USD
momoservertw => $116.00USD
Terbin => $20.00USD
Siuan => $20.00USD
JackScurvy => $10.00USD
Malum => $10.00USD
MrPranklez => $10.00USD
Jaocb => $5.00USD
Kubson_19 => $5.00USD
Graatvis => $3.00USD
TheColdEmerald => $1.00USD
Vxrrxckter => $1.00USD
CloneMC => $0.55USD
Slimedog => $UNKUSD
piggalotgaming => $UNKUSD
XYBlue => $UNKUSD
Moemilords => $UNKUSD
Askarion => $UNKUSD
</Awesome Crafters>
Supporters who are listed with a UNK value are those for who I am unable to calculate the amount donated. If you are of these supporters and know the amount you contributed, please contact me and I will fill in the proper value. If you wish to be a part of these amazing supporters, consider donating as it is the best way to say thanks to the developer!
★ Requested Changes ★
Please Pm me with feature requests as I will always look them over and get back to you.
Crossed Out requests mean that they have been completed.
no.1) ........
评论 0
登录后参与评分
还没有评论,来抢沙发吧