狡诈师
本帖最后由 爱国民主 于 2019-7-20 21:20 编辑
翻译未完成，敬请期待，感谢支持

温馨提示：上方目录可以点击 / 如果图片挂了请告诉我
如果你觉得维基原贴缺少什么东西，请向作者反馈：点击
如果你想知道哪些插件可以关联ItemJoin：点击原文 / 点击上方目录[API/HOOK]

备注：不知道给ItemJoin什么译名，毕竟它不仅是物品菜单，而且还是其它东西（不知如何描述，总之也可以作为RPG物品、抽奖等）
它不是普通菜单物品的插件，它的功能非常多，高度自定义，支持多版本

如果你觉得写配置物品（items.yml）麻烦
可以输入命令 /ItemJoin save <物品名称> （物品名称会写入配置，作为ID）
输入之后，它会自动为你写好基础配置并保存到items.yml中，然后你可以进一步修改

注意：Item-ID将继续在Minecraft v1.13及更高版本上运行，但是它们未来将不再得到更新支持，因为Minecraft v1.13中不存在Item-ID。建议尽快停止使用Item-ID

注意：
    | - 清除物品：在config.yml中
    | - All将清除玩家库存中的任何物品
    | - ItemJoin则仅清除ItemJoin的物品
        

2021.12 数据，可能有更多内容
翻译未完成，敬请期待，感谢支持
温馨提示：上方目录可以点击 / 如果图片挂了请告诉我
如果你觉得维基原贴缺少什么东西，请向作者反馈：点击
如果你想知道哪些插件可以关联ItemJoin：点击原文 / 点击上方目录[API/HOOK]


备注：不知道给ItemJoin什么译名，毕竟它不仅是物品菜单，而且还是其它东西（不知如何描述，总之也可以作为RPG物品、抽奖等）
它不是普通菜单物品的插件，它的功能非常多，高度自定义，支持多版本


如果你觉得写配置物品（items.yml）麻烦
可以输入命令 /ItemJoin save &lt;物品名称&gt; （物品名称会写入配置，作为ID）
输入之后，它会自动为你写好基础配置并保存到items.yml中，然后你可以进一步修改


注意：Item-ID将继续在Minecraft v1.13及更高版本上运行，但是它们未来将不再得到更新支持，因为Minecraft v1.13中不存在Item-ID。建议尽快停止使用Item-ID


注意：
    | - 清除物品：在config.yml中
    | - All将清除玩家库存中的任何物品
    | - ItemJoin则仅清除ItemJoin的物品
 


创建物品
创建物品非常简单，要创建物品就必须列出世界标识符（允许某世界拥有和使用该物品菜单）
提示：如果没有写世界标识符，就默认全世界可以拥有和使用
现在，你需要在配置items.yml中给物品菜单写物品名称（作为ID）
配置中必须有id（物品材质）和slot（库存槽位）才能正常获得和使用该物品菜单
l另外，可以对id进行动态化，具体看目录 [动态物品]
下面是创建三个物品的例子

代码:

  1. items:
  2. any-text:
  3.     id: 284
  4.     slot: 0
  5.     enabled-worlds: world_name_here, another_world_name
  6. another-item:
  7.     id: SEEDS
  8.     slot: 2
  9. wheat-item:
  10.     id: WHEAT
  11.     slot: 4
  12.     enabled-worlds: world, world_nether, world_the_end

接下来你可以为物品菜单自定义更多选项
如物品名称（name），物品注释（lore），附魔，附加值，权限，物品数量等


附加值（data-value）
如果只写id: 35的话则只获得白色羊毛
那么其它颜色怎么办？这时候我们就要运用到附加值了
白色羊毛

代码:

  1. id: 35
  2. data-value： 0
橙色羊毛

代码:

  1. id: 35
  2. data-value: 1

耐久值（durability）
你可以为物品添加固定有限耐久值或无限耐久值


冷却
如果物品是消耗品或可交互的类型，例如末影之眼，你可以在为其设置使用冷却时间。
在该示例中，玩家每次想要使用末影之眼时必须等待10秒。
这可以防止该物品在处于冷却状态使用，此选项支持任何指定的物品。

代码:

  1. items:
  2. special-item:
  3.     id: 381
  4.     slot: 0
  5.     use-cooldown: 10
  6.     enabled-worlds: world_name_here

概率（probability）
你可以设置物品为抽奖物品，然后抽中的物品将赠送给玩家
没有设置概率的物品将随机给予玩家，如果物品有概率，则只能给出其中一个物品
物品概率是基于权重，而不是百分比，要使用正整数
如果没有为多个任何物品设置概率，则物品将与赢得概率滚动的物品一起给出
这也适用于有多槽位物品，所以如果选择的物品具有多个槽位，则如果它是多槽位项目，则将给予多个槽位中的物品
如果没有设置概率，则百分之百给玩家该物品
如果抽中的物品的配置（items.yml中的slot）有多个槽位，则不会变为物品堆而给予玩家，它只会放在各自的槽位上含有概率配置的效果图
随机例子

代码:

  1. items:
  2. sword-of-a-god:
  3.     id: DIAMOND_SWORD
  4.     slot: 0
  5.     name: '&e你抽中了'
  6.     probability: 15
  7.     triggers: join, world-change
  8.     enabled-worlds: world, world_nether, world_the_end
  9. herobrine-apple:
  10.     id: GOLDEN_APPLE
  11.     slot: 0
  12.     name: '&c金色苹果'
  13.     probability: 55
  14.     enabled-worlds: world, world_nether, world_the_end
  15. filler-pane-item-four:
  16.     id: DIAMOND_PICKAXE
  17.     slot: 0
  18.     name: '&f没啥用的镐子'
  19.     probability: 110
  20.     triggers: join, world-change
  21.     enabled-worlds: world, world_nether, world_the_end
上述概率配置很多选项是可选填的，你可以删掉部分，但必须有物品名称（就是ID）、id（物品材质）、slot（槽位）
下面是所有可用的选项列表

代码:

  1. items:
  2. ultra-item:
  3.     id: DIAMOND_SWORD
  4.     slot: 0
  5.     name: '&b神剑'
  6.     count: 1
  7.     durability: 5
  8.     lore:
  9.    - '&7强大的神剑'
  10.    - '&7足以令人畏惧'
  11.     commands:
  12.    multi-click:
  13.   - 'message: &e你可以发送多条消息'
  14.   - 'console: say 而且你还可以执行多个命令'
  15.   - 'player: say 这是物品槽位1'
  16.   - 'say Hello world!'
  17.    right-click:
  18.   - 'console: gamemode 1 %player%'
  19.   - 'message: &e你的当前游戏模式为创造模式'
  20.    left-click:
  21.   - 'console: gamemode 3 %player%'
  22.   - 'message: &e你的当前游戏模式为观察者模式'
  23.    multi-click-air:
  24.   - 'message: &e这个是防止在左右点击方块、标牌时执行命令'
物品槽位
槽位系统包括35个数字槽位，6个名称槽位和5个合成槽位（具体看图片）
0到8是常用栏中的前9个插槽。通常，当你计算时你不会从零开始数到后面，但是CraftBukkit / Spigot并不是这样，他们首先从零开始
所以常用栏中的第一个槽位是0
槽位图片
对于实际中的库存，槽位编号从左上角开始并向右增加这些槽位是9到35
若要在你的装备槽位中设置一个物品，你只需输入它的槽位的名称：Helmet（头盔）, Chestplate（胸甲）, Leggings（护腿）, Boots（靴子）
如果你想为副手设置物品，那么只需将槽位填为Offhand
若要在合成槽位中设置物品，你需要输入CRAFTING，然后再在其后面键入[#]作为插槽的编号有关槽位编号请参见槽位图片您可以将合成槽位填为为CRAFTING [＃]或C [＃]或C（＃）（＃是槽位编号的写为0,1,2,3或4）设置合成槽位例子：

代码:

  1. diamond-item:
  2.     id: DIAMOND
  3.     slot: CRAFTING[1]
  4.     itemflags: death-drops, self-drops
  5.     triggers: join
  6.     enabled-worlds: world, world_nether, world_the_end
  7. iron-item:
  8.     id: IRON_INGOT
  9.     slot: CRAFTING[2]
  10.     itemflags: death-drops, self-drops
  11.     triggers: join
  12.     enabled-worlds: world, world_nether, world_the_end
  13. gold-item:
  14.     id: GOLD_INGOT
  15.     slot: CRAFTING[3]
  16.     itemflags: death-drops, self-drops
  17.     triggers: join
  18.     enabled-worlds: world, world_nether, world_the_end
  19. redstone-item:
  20.     id: REDSTONE
  21.     slot: CRAFTING[4]
  22.     itemflags: death-drops, self-drops
  23.     triggers: join
  24.     enabled-worlds: world, world_nether, world_the_end
另外，还有一个名为Arbitrary的槽位，其作用是该物品将被放入玩家库存的第一个可用槽位中它不会移除原本存在于库存中的任何玩家物品就将其置于空的可用槽位
你还可以为每个物品设置多个槽位，只需用逗号分隔槽位，例如1,12,13,Arbitrary,3以下是示例：

代码:

  1. items:
  2. first-item:
  3.    d: SKULL_ITEM
  4.    slot: 0
  5. second-item:
  6.    id: DIAMOND_SWORD
  7.    slot: Arbitrary
  8. helmet-item:
  9.    id: DIAMOND_HELMET
  10.    slot: Helmet
  11. chestplate-item:
  12.    id: 299
  13.    slot: Chestplate
  14. leggings-item:
  15.    id: DIAMOND_LEGGINGS
  16.    slot: Leggings
  17. boots-item:
  18.    id: LEATHER_BOOTS
  19.    slot: Boots
  20. offhand-item:
  21.    id: SHIELD
  22.    slot: Offhand
  23. redstone-item:
  24.     id: REDSTONE
  25.     slot: CRAFTING[4]
  26.     itemflags: death-drops, self-drops
  27.     triggers: join
  28.     enabled-worlds: world, world_nether, world_the_end
允许使用的世界
设置起来非常简单，只需将enabled-worlds标识符添加到物品配置中，并设置可用物品世界
可以用逗号分隔多个世界
如果不希望世界之间存在任何限制，则不要为物品设置任何允许使用的世界


这是个例子：

代码:

  1. items:
  2. any-text:
  3.     id: 284
  4.     slot: 0
  5.     enabled-worlds: world_name_here, another_world_name
  6. wheat-item:
  7.     id: WHEAT
  8.     slot: 4
  9.     enabled-worlds: world, world_nether, world_the_end
如果你想在每个世界中获取该项目，只需将All或Global添加到enabled-worlds标识符，然后在每个世界中都会给予该物品


以下是全局物品的示例：

代码:

  1. items:
  2. any-text:
  3.     id: 284
  4.     slot: 0
  5.     enabled-worlds: Global
  6. wheat-item:
  7.     id: WHEAT
  8.     slot: 4
  9.     enabled-worlds: All

物品标识符Itemflags（物品标识符）允许对物品进行详细修改
要将itemflags添加到物品配置中，如下所示
这些是物品标识符，所有物品标识符都列在下面
提示：物品标识符会经常更新并添加，所以要常回来查看更新！


当前可用的物品标识符
vanilla - 允许给予默认的未修改的无名物品
注意，如果选择使用命令或物品标识符等，它们都将无法运行，They will not function since all this does is allow ItemJoin to give a vanilla type item that can have a modified name or lore if defined.
vanilla-status - Applying this itemflag to an item will allow any item with the vanilla itemflag retain its functionality to ItemJoin without applying any NBTTags to the item. This is useful for trying to implement items being used by other plugins so they can retain their functionality while also (not being given on every join).
first-join - This will only give the item when joining the server for the first time, to get the item every time you join just remove this itemflag. If you want to give the item once per-world entrance, use the first-world itemflag.
first-world - This will only give the specified item once per world for each player.
ip-limit - This will only give the item after checking the IP of a player, so if someone has already joined and then joins with an alt the alt will not get the item, preventing players from loading up on free items. This will limit the item to the players IP address.
unbreakable - Set the item as INDESTRUCTIBLE!
hide-attributes - Hides ALL attributes, such as firework color, damage the item does, enchantments. (Hides everything from lore except the custom lore).
hide-durability - Hides the durability bar from the item.
placement - Prevents this item from being placed if it is a BLOCK, or if the item is being placed in an item-frame.
inventory-modify - Prevents this item from being moved, placed in an item frame, or switched to offhand in the player's inventory.
dynamic - This will allow the item to dynamically update every 100 ticks by default, changing any previous placeholder values to the now up-to-date values. See how to set up dynamic items below.
animate - This will allow the item to animate between the different name and lore iterations every 100 ticks by default, you can make the name of the item and/or the lore to anything you could want, between a different name entirely or just changing the color codes to create a cool effect. See how to setup animated items below.
item-store - Prevents the storage of the item in a trapped chest, chest, enderchest, hopper, anvil, crafting table, shulker box, furnace, item frame, minecart with chest, droppers, dispensers, item-stands, llama chests, and donkey chests.
cancel-events - Prevents player from opening a chest while this item is in hand or any open-able items. Useful for canceling the event of opening a book to set custom book items.
count-lock - Prevents the player from using all of the items. If the item is set to count: 32 then each time the player places the block item the stack will be refreshed back to 32.
death-drops - Clears this item if it is dropped on the ground when the player dies.
self-drops - Prevents the player from dropping this item, either clicking it out of inventory or using the drop key, usually (q).
disposable - If a command is run from the item it will remove x1 of the item from the player's inventory.
item-repairable - This will block the usage of the specified ItemJoin item in an anvil repair recipe. If this itemflag is also used on a consumable recipe item such as a diamond the itemflag will still prevent the repair of an item.
item-craftable - This will block the usage of the specified ItemJoin item in a crafting recipe via the crafting table or the players own personal crafting menu. If an item using this itemflag is placed in either of those following locations the item will be automatically moved back to the first available slot of the player's inventory.
always-give - This will always give the specified ItemJoin item when a player acts upon one of the defined triggers such as on join. This itemflag also has a dual functionality, allowing the hasItem restriction bypass on the regular /itemjoin get &lt;item&gt; and /itemjoin get &lt;item&gt; &lt;player&gt; with no amount being specified.
allow-modifications - Allows the item to still function as a normal ItemJoin item if the ENCHANTMENTS, BOOK PAGES, NAME, LORE, and item COUNT are modified by the player or a plugin.
overwrite - This will perform exactly the same as the items-Overwrite boolean in the items.yml except it is item specific. Applying this itemflag to the item will prevent that specific item from overwriting any other items in the player's inventory whether they are ItemJoin related or not. This itemflag will take priority over the items-Overwrite boolean.
AllowOpBypass - This would allow the user IF THEIR OP to bypass most of these itemflags. It will work on ALL non-item modifying flags. This would NOT work on unbreakable, hide-attributes, stuff like that.
CreativeBypass - This would allow the user IF THEY'RE IN CREATIVE MODE to bypass most of these itemflags. It will work on ALL non-item modifying flags. This would NOT work on unbreakable, hide-attributes, stuff like that.


1305791312
谢谢楼主 感谢
longpozhanhun
66666666666
骚马克
干巴爹，加油楼主
soil-sword
这个插件好！收藏了！
Kenneth_z
lz辛苦 加油 奥利给