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 TheCarlus77 TheCarlus77 Jan 24, 2015 at 19:33 UTC - 0 likes

    Hello ! I love this plugins :) But when can we translate this ? I'm french and my players don't understand english :s Thanks in advance

    Last edited Jan 24, 2015 by TheCarlus77

    == Zone-Craft ! {PVP/FACTION} == Server-IP => <= | Zone-Craft-Website

  • Avatar of IrrealPower IrrealPower Jan 17, 2015 at 15:53 UTC - 0 likes


    Why i can't create items? I have done configuration right but doesen't give me the item! I have the right permission!

  • Avatar of AnonimousGuyPT AnonimousGuyPT Jan 14, 2015 at 19:11 UTC - 0 likes

    add a comand debug please? :)

  • Avatar of MCTylerPVP MCTylerPVP Jan 13, 2015 at 00:47 UTC - 0 likes

    @Jleeto: Go

    effect <player> 1 [Howlong] [multiplier]
    effect <player> 1 300 2

    300 = 300 seconds maybe their player is %player% not sure...never done effects with this plugin. I tried using speed instead of 1 and it throws and error saying invalid effect number. Look up all the effects and there number with google.

    Last edited Jan 13, 2015 by MCTylerPVP

    MC Client WebPage

  • Avatar of Jleeto Jleeto Jan 12, 2015 at 03:31 UTC - 0 likes

    How would I add an item, and upon click, give the player speed II?

  • Avatar of MCTylerPVP MCTylerPVP Jan 10, 2015 at 00:41 UTC - 0 likes

    You guys are a full year behind chest commands...Does it Matter?

  • Avatar of TheOnlyRealTGS TheOnlyRealTGS Dec 31, 2014 at 15:37 UTC - 0 likes

    @Milkyway705: Go

    /i 397:3 1 player:%player%

    Owner of MC-Simple Gaming! Hope to see you there :)
    Need a free BuyCraft alternative? Try MinecraftMarket! | Need a working Trade plugin? Try SimpleTrading!

  • Avatar of NoHoPeLess NoHoPeLess Dec 30, 2014 at 10:29 UTC - 0 likes

    There are some issues with the new chest commands gui...

    - The worlds are not ignored i set for example "world" to the ignored worlds but users become an "no permission" message if they right click with an item

    I will write an ticket for this

    BalayaCraft! Server-IP | BalayaCraft-Website | Facebook | Twitter | Youtube |

  • Avatar of alexlab963 alexlab963 Dec 30, 2014 at 07:55 UTC - 0 likes

    BUG If you block movement and drop.And a player hits the Q button a couple of times while holding the item, the item will move to the first available slot. Ex. I have an item on the first slot and item on the 3rd and an item on the 5th if i hold the 3rd item and hit Q a few times the item will go to the 2nd slot because in the first there is an item.But if i hold the 5th item and hit Q both 5th and 3rd items will move.The 3rd will go at slot 2 and the 5th at slot 3

  • Avatar of Milkyway705 Milkyway705 Dec 28, 2014 at 22:43 UTC - 0 likes

    like here Head on join


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