Custom Join Items


This plugin allows to give customized items on join, each one execute a command. This is useful for lobby servers, for example. You can set a permission to receive the item, and you can add infinite items. At the moment is really small, but I'm planning to add more features. Note that the user will receive the item on join, no matter if he was new, or if he stored the item.

You can use this plugin with Chest Commands GUI that allows you to create menus made of items, and each one executes a command.


  • Give items on join, to people with correct permission.
  • If a player already owns the item, it does not give a duplicate.
  • Give items on respawn (configurable)
  • Prevent items from being dropped, even on death.

Commands and permissions

/cji reload - reloads the plugin
/cji update - updates the plugin

The permission is "customjoinitems.admin".


In the plugin's folder you find a file named items.yml:

# This is just an internal name, must not be the same of another.
    id: 352
    # (REQUIRED) The ID of the material.
    name: '&aTest item'
    # (REQUIRED) The custom name of the item (with formatting codes).
    data-value: 0
    # This is optional. Can be used for colored wool, and other items
    # with data values.
    cooldown-seconds: 5
    # This prevents command spam.
    command: 'say Hello world'
    # The command bound to this item. It will be executed when the item
    # is right clicked.
    # There are some prefixes that can give extra functionalities to
    # commands:
    # 'console: ' (execute the command as console)
    # 'op: ' (execute the command as op)
    # 'server: ' (for BungeeCord)
    # 'tell: ' (sends a message to the player)
    # You can use symbols and the placeholders %player% and %world%.
    # Use multiple commands like this: 'command; command2; command3'
      - 'Line 1'
      - 'Line 2'
      - '...'
    # The lore of the item (with formatting codes and symbols support).
    block-movement: false
    # This prevents players from moving the item at all.
    slot: 9
    # If omitted, the item will be placed in the first empty slot.
    # If set, the item will attempt to place in that hotbar's slot,
    # and it will move any existing item that is in that slot,
    # if there's enough space in the inventory.
    permission: 'customjoinitems.test'
    # The item required to obtain the item on join. If not set,
    # everyone will get the item.
    first-join-only: false
    # (default = false)
    # If true, the player will get the item only when they join
    # the server the first time.
    # NOTE: give-at-respawn will automatically be set to false,
    # if this node is true.
    give-at-respawn: true
    # (default = true)
    # If set to true, the player will receive the item when he dies
    # and respawn.
    allow-drop: false
    # (default = false)
    # Allows players to drop the item.

    give-on-world-change: false
    # (default = false)
    # The plugin will eventually give the item to the players when they
    # change world.
    # Useful if you have Multiverse or similar plugins.
    disabled-worlds: world_nether, world_the_end
    # a list of disabled worlds separated by commas. If you don't want to
    # disable an item in some worlds, remove this node or set it to ''.


Spanish - German - Portuguese


This plugin uses Metrics-Lite, to track anonymous data about servers using this plugin. It will help the future developement, and has no impact on your server's performance. If you really want to disable it, go to the folder /plugins/PluginMetrics and set opt-out: true.


You can use "/cji update" in-game to automatically update the plugin. You can disable the update checking at startup by setting update-notifications: false in config.yml.

Future features

  • Restrict crafting and storing items
  • Add right or left click options
  • Add cooldown bypass for admins, through a permisison
  • Add enchantments
  • Add books
  • Add per-world config
  • Command to get an item

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of TheNoobCakes TheNoobCakes Feb 02, 2016 at 04:41 UTC - 0 likes

    @SuperRonanCraft: Go

    What was the plugin for the book on spawn?

  • Avatar of Azen0x Azen0x Jan 26, 2016 at 21:44 UTC - 0 likes

    It possible to upload source code ?

    public void onJoin(PlayerJoinEvent e){
       e.getPlayer().kickPlayer("Buy VIP on Webshop to join the server !");
  • Avatar of SuperRonanCraft SuperRonanCraft Jan 18, 2016 at 06:50 UTC - 0 likes

    Great plugin and all, but hasn't been updates in 2 years, I'm moving to another one that has the book feature that I wanted so bad, sorry filoghost, but you're slacking :) hope you update soon to come back to this plugin, and also updates ChestCommands! It's such a good plugin!

  • Avatar of Scratchy741 Scratchy741 Jan 02, 2016 at 22:17 UTC - 0 likes

    Hi! Really nice plugin! But found a bug. When you are in a creative mode and you will click on "Chest" tab and than double-left-click the item, you can move with it. Even I have move disabled and it has to be only on slot 9. I dont mind the bug, but the worst part of it is glitched item. If you have clicked with it on empty slot in inventory, it will stuck here and new item will appear on slot 9.

  • Avatar of game3232 game3232 Dec 19, 2015 at 08:07 UTC - 0 likes

    We want you to be multiplied by the enchantment on the item

  • Avatar of SuperRonanCraft SuperRonanCraft Dec 13, 2015 at 02:24 UTC - 0 likes

    Please update this plugin for 1.8! Some items are not being given all the time. Still runs well with some bugs, please fix it, it's the only good plugin out there that does what I want it to!

  • Avatar of MatsCraft1 MatsCraft1 Dec 11, 2015 at 20:53 UTC - 0 likes

    @AlexanderHuard: Go

    @AlexanderHuard: Go

    Uhmm oh oh D:

    MatsCraft1 SigCard
  • Avatar of AlexanderHuard AlexanderHuard Dec 03, 2015 at 01:07 UTC - 0 likes

    Hey, I love this plugin, but It has a major bug! I don't receive anu items on join. I have set all the right options in the config.yml and items.yml

    Here they are: CONFIG: ITEMS:

  • Avatar of XveiT45 XveiT45 Nov 30, 2015 at 03:46 UTC - 0 likes

    Can you add command for example /cji give first-item and it gives items

  • Avatar of AzyreAngels AzyreAngels Sep 25, 2015 at 20:10 UTC - 0 likes

    Sadly this seems like a dead plugin, I waited in hope that he would come back and fix the bugs / update it. He never came :(.

    You guys should check out: I love his plugin. It is literally a perfect replacement for me. He seems to be constantly updating and he accepted and added features I requested so that was cool.

    @cecemaster: Go

    I have tried this too and it seems like there are no support for variables. Supports player variables if you are specifying commands.


Date created
Sep 03, 2013
Last update
Feb 12, 2014
Development stage
  • enUS
All Rights Reserved
Curse link
Custom Join Items
Recent files