Custom Join Items

Cover

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.

Features

  • 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".

Configuration

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.
first-item:
    
    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'
    
    lore:
      - '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 ''.


Videos

Spanish - German - Portuguese



Metrics

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.

Updater

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 neeablis neeablis Mar 01, 2015 at 10:44 UTC - 0 likes

    Is there a way to add NBT data to an item? Thank you.

  • Avatar of MuhsinunCool MuhsinunCool Feb 25, 2015 at 02:02 UTC - 0 likes

    Hey guys just found out something i know that a few people including me have suggested that the author put a Wait: variable in the plug well until he does you can use this plugin: http://dev.bukkit.org/bukkit-plugins/commandoverride/Command Override It let's you make your own commands and as you can see in the prictures you can have a wait thing and as the gui exits after the command is done like to exit the menu just set an item without a command you can use these commands and the gui will close and that will probably take about 1 second so then the next gui would open! :D mew

    ZBDH7a69cd36aae795bce2bd9ceb41763e60

  • Avatar of Froggymac4 Froggymac4 Feb 23, 2015 at 00:26 UTC - 0 likes

    justjan im having the same problem

  • Avatar of gwinny7 gwinny7 Feb 19, 2015 at 00:44 UTC - 0 likes

    if you want a book that gives a book when the player join, that is a different plugin fond it the plugin(it works for spigot 1.8 and bukkit 1.7 -> http://www.spigotmc.org/resources/yourbook.1342/

  • Avatar of PacMcHD PacMcHD Feb 18, 2015 at 12:10 UTC - 0 likes

    Hey how to make a book?

  • Avatar of Rudy923 Rudy923 Feb 18, 2015 at 03:21 UTC - 0 likes

    How do you add books? Do you make the Id a book a make a book.yml

  • Avatar of JustJan1707 JustJan1707 Feb 18, 2015 at 01:15 UTC - 1 like

    Hello, I have a problem. Everything is right, i gave the perms, i editted the items.yml right. But when players join they don't get the items, when they do /kill they get the items. So for me it's pretty bad cause i have a hub server and every time you join the hub you need to do /kill. That is really frustrating.

  • Avatar of asdfghjkl910 asdfghjkl910 Feb 16, 2015 at 19:50 UTC - 0 likes

    Hello, I found a bug with the Plugin. Whenever I travel to one world and come back to my Hub I get a second server selector that dosen't work.

    This is my items.yml first-item: name: '&aServer Selector' id: 345 slot: 1 lore: - 'Select a Server' cooldown-seconds: 0 permission: '' give-at-respawn: false first-join-only: false allow-drop: false block-movement: true disabled-worlds: world_nether, world_the_end, Factions, Paintball, Survival, Creative, give-on-world-change: true command: 'menu'

    I'm using Chest Commands with it.

    Please Advise @filoghost

    asdfghjkl910

    • 2015-02-16_14.51.01.png
      This is the additional Server ...
    • 2015-02-16_14.51.01.png
      This is the additional Server ...
  • Avatar of PerezHD PerezHD Feb 13, 2015 at 17:57 UTC - 0 likes

    I was just wondering if you can add enchantments :/

  • Avatar of BAAbol BAAbol Feb 12, 2015 at 16:11 UTC - 0 likes

    Hi, I wonder would have to do to put my video on your Youtube videos section.

Facts

Date created
Sep 03, 2013
Categories
Last update
Feb 12, 2014
Development stage
Release
Language
  • enUS
License
All Rights Reserved
Curse link
Custom Join Items
Downloads
68,644
Recent files

Authors