Items.yml

This is a quick overview of the default items.yml configuration.

If you are looking for help on how to create custom ItemJoin items, please view this section of the wiki: https://github.com/RockinChaos/ItemJoin/wiki/Creating-Items

---

items-Version: 8

This should NEVER be touched, modifying this will cause the items.yml file to break and regenerate.

items-Delay: 2

This is the delay in half-seconds that ItemJoin will wait to give you the items. 1 = 0.5 seconds.

This is useful if you have another plugin that clears the player's inventory, you can set the delay long enough that the items are given after the other plugins clear the player's inventory. Usually 2-3 seconds at the most.

It is not recommended to set this any lower than 2 half-seconds as it can result in issues with giving the items.

items-Overwrite: false

Setting this to true will allow ItemJoin items to overwrite any items (if any) that are in the dedicated slot for the ItemJoin item. However, setting this to false will prevent ItemJoin from accidentally removing items if they are in the dedicated slot for an item. Therefore, the ItemJoin item will not be given.

If you wish to you can specify per-world instead of globally. Simply remove the true/false statement and put the name or world or world(s) separated by a comma.

All the worlds that are defined will be the worlds that ItemJoin can overwrite items in.

Example(s):

items-Overwrite: true
items-Overwrite: world, world_the_end

items-Spamming: false

Setting this to false will prevent players from rapidly spamming the use of Item's Commands. It is recommended to leave this to false.

items-RestrictCount : false

Setting this to false will prevent players from being given more of an item if it is not the same count as in the items.yml, saying you ate 3 out of the 4 bread you would not receive any more bread until you ate all of it. However, setting this to true will give the player more of the item if the stack/count size is not the same as the items.yml.

To sum this up, setting this to true will allow the player to have their items refreshed (topped up) if they have used some of the stacks of the item they were given.