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, Momocraft

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, Sky Block, 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 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 GUI Or BossShop 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. 
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, will give me a diamond sword and then in world Pandora_nether it will give me a minecart on login, respawn, or world change! 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 and lore.
  • Items on Join.
  • Items on Respawn.
  • Items on World Change.
  • Items on WorldGuard Region Enter.
  • 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.
  • ItemJoin 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.
  • 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.
  • 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 ItemJoin 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 itemjoin item. /itemjoin get <item>  
itemjoin get <item> <player> Gives that player an itemjoin item. /itemjoin get <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 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
ItemJoin for all
players globally.
/itemjoin enable  
itemjoin enable <player> Enables the use of
ItemJoin for the
specified player.
/itemjoin enable <player>  
itemjoin disable Disables the use of
ItemJoin for all
players globally.
/itemjoin disable  
itemjoin disable <player> Disables the use of
ItemJoin 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 said player from
the database file.
/itemjoin purge first-join <player>  
itemjoin purge ip-limits <player> This will purge all ip-limits
data for 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 use of basic commands.    
itemjoin.reload Allows use of 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. 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 name of world to receive that item.    
itemjoin.WorldName.* Gives permission to get all items from specified world.    


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






Other English Tutorials;


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 a ip-limit and others are given regardless of the ip-address, or simply just make it so all items in a 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;
    • 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.
  • In-game GUI Item creator.
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!


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

About This Project

  • Project ID
  • Created
    Feb 6, 2015
  • Last Released File
    Jan 26, 2019
  • Total Downloads
  • License



Recent Files