ItemJoin

Tested Minecraft Versions:     1.7, 1.8, 1.9, 1.10, 1.11, 1.12, 1.13
Native Minecraft Version(s):  1.7, 1.8, 1.9, 1.10, 1.11, 1.12, 1.13
Contributors:                              SlimeDog, piggalotgaming, XYBlue, Siuan,TheColdEmerald,                                                                                              Kubson_19, Moemilords, Askarion, momoservertw
Donations:                                   https://www.paypal.me/RockinChaos

Having issues with ItemJoin?
Please see our Resolution Center to resolve your problem.
This plugin allows you to give players customizable items on join. This is a multiple purpose plugin from either giving items to players on Hub, Minigame servers or giving players items on regular servers such as Survival, Factions, Skyblock, and other servers that are not Hub or Minigames based. You can define an infinite amount of items and worlds! You can give players items on join, no matter if they were new or if they stored the item. Although if they already have the item in their inventory they will not receive a duplicate. You also have the option of setting items to only be given on first-join or first-world, the first time you enter a certain world. ItemJoin has extreme customization from what it once was, and has grown way beyond my expectations. Thank you guys for your continued support, if you wish to have a feature implemented please request a feature on Github! If you want to say thanks the best way is to support us by donating.
 



 
You can use this plugin with Chest Commands GUIBossShopDeluxeMenu's, or even CustomGUI that allows you to create menus made of items, and you can use ItemJoin to execute commands such as making a compass to warp you to specific locations. There is no real limitation to how ItemJoin can interact with other plugins, as long as the plugins have a command to execute their objectives such as /menu, then ItemJoin can use that on an item.
 
 
 
ItemJoin is unique because it has extreme functionality, it is also currently the only plugin out there that gives you an item of your choice per world! What do I mean by per world? I can set it so in the world named Pandora, it will give me a diamond sword and then in world Pandora_nether it will give me a minecart on login, respawn, or world switch! There is no limit to a number of items or worlds you can define! If the world is not defined you will not be given items in that world however, items will transfer worlds unless you have ItemJoin hooked into Multiverse-Inventories or set ItemJoin items to clear upon switching worlds in the config.yml. ItemJoin is currently the only plugin that has an active developer always adding new features and is up to date with working per world functionality and support for offhand items as well as future items. Other plugins are either out of date, inactive developer, missing features, or the per world support does not work at all! ItemJoin was built on the idea of resolving these problems, to become the ultimate custom items on join plugin!
 
 
 
  • Supports CraftBukkit / Spigot 1.7 - 1.13
  • Supports the animating of an items name, lore, material type, and skull skins.
  • Items on Join.
  • Items on Respawn.
  • Items on World Change.
  • Items on Gamemode Change.
  • Items on WorldGuard Region Enter.
  • Items on WorldGuard Region Leave.
  • Global commands to be executed on join.
  • Set each individual item to be given either every time or every first join, or even limit the items to a user's ip!
  • Multiple slots for each item.
  • Allow or deny overwriting current items in your inventory.
  • If a player already owns the item, it does not give a duplicate.
  • All items are Unique and cannot be crafted or re-named to!
  • Failed number of items to be given will be displayed.
  • Custom potion-effects to all types of potion bottles.
  • Custom potion-effects on consuming of golden apples, both Notch, and regular golden apples.
  • Prevent items from being spammed.
  • Set items to be limited to a specific gamemode.
  • Items commands can be executed either by clicking them in your inventory or interacting with them via right click and left click.
  • Each individual item supports separate commands.
  • Set cooldowns for each command.
  • Set custom cooldown messages for each command.
  • Set custom economy to charge for each command.
  • Left and right click to perform different commands.
  • Define what actions you want to use to execute your commands, left click, right click, physical, and/or inventory click.
  • Define multiple command instances. These execute the commands as the following; console, player, message, or server.
  • Switch servers using BungeeCord.
  • Get any item with a simple command.
  • Remove any item with a simple command.
  • Play sounds when executing commands.
  • Clear all items or clear only ItemJoin items upon joining and/or changing worlds.
  • Add any enchantment and level to any item.
  • Set a players skin to a skull item.
  • Global Items
  • Custom Tipped Arrow Items.
  • Custom Book Items.
  • Custom Banner Items.
  • Custom Firework Items.
  • Custom Map Items.
  • Custom Skull Items.
  • Custom Offhand Items.
  • Dyed leather items.
  • Hide item attributes.
  • Prevent moving items.
  • Prevent the placement of items.
  • Prevent the storing of items.
  • Prevent self-drops.
  • Prevent death-drops.
  • Prevent all item pickups.
  • Lock the count/amount of the item in your inventory, infinite uses.
  • Cancel certain events.
  • Multiple languages.
  • Toggle on/off CheckforUpdates.
  • Automatic Update Command.
  • Supports item info checking.
  • Supports Editing the config(s) and reload it while in game.
  • Supports first-join commands.
  • Supports dynamically updating items when a placeholder is changed.
  • Supports adding a probability of receiving an item, a random chance.
  • Supports giving default vanilla unmodified items to players.
    Supports item-usage cooldowns.
  • Supports giving certain item upon a players first-join.
  • Supports giving certain item upon a players first-world.
  • Allows the limitation of items to specific players IP-Address, preventing players from receiving multiple items by having multiple characters.
  • Supports custom head textures.
  • Supports data-values.
  • Supports variables.
  • Supports Armor Slots.
  • Supports JSON Books.
  • Supports Vault.
  • Supports Multiverse-Core.
  • Supports Multiverse-Inventories.
  • Supports PerWorldInventory.
  • Supports PerWorldPlugins.
  • Supports AuthMe.
  • Supports WorldGuard.
  • Supports MyWorlds.
  • Supports xInventories.
  • Supports TokenEnchant.
  • Supports HeadDatabase.
  • Supports BetterNick.
  • Supports PlaceholderAPI, see the valid placeholders.
  • The number of features is limitless and its thanks to all of you supporting ItemJoin.


You can either use /ItemJoin or /IJ to execute a command.

Commands Description Usage  
itemjoin Displays some options. /itemjoin  
itemjoin help Displays some options. /itemjoin help  
itemjoin reload Reloads the ij config.yml. /itemjoin reload  
itemjoin info Displays necessary held
items information, such
as material type.
/itemjoin info  
itemjoin updates Checks for updates. /itemjoin updates  
itemjoin autoupdate Force updates ItemJoin. /itemjoin autoupdate  
itemjoin loaded Checks what worlds are loaded. /itemjoin loaded  
itemjoin permissions Checks what permissions you have. /itemjoin permissions  
itemjoin permissions 2 Checks what permissions you have. /itemjoin permissions 2  
itemjoin get <item> Gives you an ij item. /itemjoin get <item>  
itemjoin get <item> <amount> Gives you the item and the amount you specified. /itemjoin get <item> <amount>  
itemjoin get <item> <player> Gives that player an ij item. /itemjoin get <item> <player>  
itemjoin get <item> <player> <amount> Gives the amount of the item you specified to the player. /itemjoin get <item> <player> <amount>  
itemjoin getAll Gives you all ij items. /itemjoin getAll  
itemjoin getAll <player> Gives the player all ij items. /itemjoin getAll <player>  
itemjoin getOnline <item> Gives the item you specified to all online players of the server. /itemjoin remove <item> <player>  
itemjoin remove <item> Removes that ItemJoin item from your inventory. /itemjoin remove <item>  
itemjoin remove <item> <player> Removes that ij item from the players inventory. /itemjoin remove <item> <player>  
itemjoin removeAll Removes all ij items from your inventory. /itemjoin removeAll  
itemjoin removeAll <player> Removes all ij items from the player's inventory. /itemjoin removeAll <player>  
itemjoin removeOnline <item> Removes the item you specified from all online players of the server. /itemjoin remove <item> <player>  
itemjoin world Checks what world you are in. For (debugging). /itemjoin world  
itemjoin list Checks what items you can get each what world. /itemjoin list  
itemjoin save <item> Saves the specified item
to the items.yml.
/itemjoin save <item>  
itemjoin enable Enables the use of
ij for all
players globally.
/itemjoin enable  
itemjoin enable <player> Enables the use of
ij for the
specified player.
/itemjoin enable <player>  
itemjoin disable Disables the use of
ij for all
players globally.
/itemjoin disable  
itemjoin disable <player> Disables the use of
ij for the
specified player.
/itemjoin disable <player>  
itemjoin purge This will purge all data
from the database file,
removing all first-join
players, ip-limited
players enabled/disabled
players, and all other
player data.
/itemjoin purge  
itemjoin purge first-join <player> This will purge all first-join
data for the said player from
the database file.
/itemjoin purge first-join <player>  
itemjoin purge first-world<player> This will purge all first-world
data for the said player from
the database file.
/itemjoin purge first-world<player>  
itemjoin purge ip-limits <player> This will purge all ip-limits
data for the said player from
the database file.
/itemjoin purge ip-limits <player>  
Permissions Description    
itemjoin.* Allows use of all commands.    
itemjoin.all Allows use of all commands.    
itemjoin.permissions Use of the /itemjoin permissions commands.    
itemjoin.use Currently allows the use of basic commands.    
itemjoin.reload Allows use of the reload command.    
itemjoin.updates Use of the /itemjoin update command.    
itemjoin.autoupdate Use of the /itemjoin autoupdate command.    
itemjoin.get Use of the /itemjoin get <item> command.    
itemjoin.get.others Use of the /itemjoin get <item> <player> for player command.    
itemjoin.remove Use of the /itemjoin remove <item> command.    
itemjoin.remove.others Use of the /itemjoin remove <item> <player> for player command.    
itemjoin.list Use of the /itemjoin list command.    
itemjoin.purge Use of the /itemjoin purge command.    
itemjoin.save Use of the /itemjoin save command.    
itemjoin.enable Use of the /itemjoin enable global command.    
itemjoin.enable.others Use of the /itemjoin enable for player command.    
itemjoin.disable Use of the /itemjoin disable global command.    
itemjoin.disable.others Use of the /itemjoin disable for player command.    
itemjoin.bypass.inventorymodify Players will this permission
will bypass any effect that
the inventory modify
flag has.
   
itemjoin.WorldName.Name Replace Name with the name of the specified item and WorldName with the name of the world to receive that item.    
itemjoin.WorldName.* Gives permission to get all items from the specified world.    

 

 

Item Permissions
These are the permission(s) required for players who are not a server administrator to receive the item(s).
Please note; permissions are case sensitive, including the world names! Sometimes certain permissions plugins fix this but in reality, it depends on the permissions plugin you use.
itemjoin.Your_Specified_World_Name_Here.Item_Name:
description: Gives permission to get a specific item in a specific world.
    Replace Item_Name with the name of the specified item (in the items.yml)
    and Your_Specified_World_Name_Here with the name of the world to receive that item.
default: false

itemjoin.Your_Specified_World_Name_Here.*:
description: Gives permission to get all items from the specified world.
    Replace Your_Specified_World_Name_Here with the name of the world to receive that item.
default: false
 
(I recommend itemjoin.Your_Specified_World_Name_Here.* as it would be easier unless you are trying to create permission group specific items)
 
Remember to replace Your_Specified_World_Name_Here with your world's name. If you need to see what world you want the items in, simply stand in the world and type /itemjoin world this will tell you the world name you are in that you want to put in the permission node.
 
The other option is to add a permission node for each specific item you have created. You can use these interchangeably such as adding a custom permission node to one item and using the default permission nodes listed above for items without a dedicated permission node.
 
Simply add the following to your item and replace specialty with your desired text. You can change the permission node to whatever you want such as 'example.fish'. I simply chose to use ItemJoin as the beginning string of the custom permission node. Make sure add the custom permissions you create to a permissions plugin afterward.
 
Add this to your item; permission-node: 'itemjoin.specialty'
 
Here is an example of an item utilizing the custom permission node utility;
items:
  example-item:
    id: DIAMOND_SWORD
    slot: 0
    permission-node: 'itemjoin.specialty'

 

If you want more detailed, better-explained commands and permissions click here.


English Tutorial(s)

 

 

 

 

Other 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 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 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 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 a 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 players 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 in an ip-limit. You can also specify the first-join itemflag to work alongside the ip-limit itemflag to limit items 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 API / Hooks by clicking the link here; https://www.spigotmc.org/wiki/api-hooks/
    • 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 its 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;
 

Please Pm me with feature requests! I will always look them over and get back to you.
Crossed Out requests means that they have been completed.
 
  • Send me some feature requests!
 
 
 
Leaving a review?
Please do not post issues or bugs in the review! Please report a bug first and wait for the developer's response!
If you have any issues, the reviews are not the place to report them! Try opening a bug report.
If you want a feature that ItemJoin is missing, try requesting a feature!

Comments

  • To post a comment, please or register a new account.
Posts Quoted:
Reply
Clear All Quotes

About This Project

  • Project ID
    89257
  • Created
    Feb 6, 2015
  • Last Released File
    Feb 24, 2019
  • Total Downloads
    40,814
  • License

Categories

Members

Recent Files