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 wakeger wakeger Aug 31, 2016 at 19:41 UTC - 0 likes

    Pls, add described features to the next version! :)

  • Avatar of Tukermine Tukermine Aug 17, 2016 at 06:53 UTC - 0 likes

    how do i make it select the person executing the command

  • Avatar of Tukermine Tukermine Aug 17, 2016 at 06:52 UTC - 0 likes

    <<reply 2853697>>

    if you put disabled worlds the item it wont affect it on that world.

  • Avatar of Jones988 Jones988 Aug 16, 2016 at 21:04 UTC - 0 likes

    Can you add clear-inventory-on-join, but per world? I have certain worlds I want to remove inventory, but other worlds I want to keep.

  • Avatar of spdjacobmsnclone spdjacobmsnclone Aug 06, 2016 at 08:55 UTC - 0 likes

    Guys just use this plugin instead: On Spigot: https://www.spigotmc.org/resources/itemjoin.12661/ On Bukkit: http://dev.bukkit.org/bukkit-plugins/itemjoin/

    It has ALL the features you guys want, it is well developed, as well as amazing support. I requested a feature for it and it was added within a few days. Not to mention it is ALWAYS up to date.

    Last edited Aug 06, 2016 by spdjacobmsnclone
  • Avatar of zaid4500 zaid4500 Jul 29, 2016 at 16:27 UTC - 0 likes

    Whenever i configure my items. The items just never appear. And i am not misspelling anything cause i literaly just took the default items but changed the id and lore and commands

  • Avatar of altrisi altrisi Jul 05, 2016 at 11:39 UTC - 0 likes

    @Jeskai_Master: Go

    The command "/cji update" is not to reload the config and search any change/new item. To do that, use "/cji reload", or restart your server. If doing that you already have the old items, check you are not usin Multiverse-Inventories, MultiInv or other per world inventory separator. If you have one of them, remove the items file for that world (s). If not, try doing "/clear" and "/kill". Check if you have "give-at-respawn" and "give-on-world-change" set to true. If it is set to "false", you don't allow the new items to appear.

  • Avatar of altrisi altrisi Jul 05, 2016 at 11:27 UTC - 0 likes

    @NeonLP: Go

    NeonLP, if you want to use that characters, with the file opened in Notepad+ + (is the best editor for config/other YML files) click in the "Encoding" (or something like this, i'm from Spain) menu button (in the upside of the window) and click the button "Convert to ANSI". That encoding is compatible with that special chars (I know it because I use á é í o ú ü).

  • Avatar of NeonLP NeonLP Jun 30, 2016 at 12:20 UTC - 0 likes

    Hey, i am german and i can´t do ä, ö, ü in the items Please add this. And what must i do, that items from another plugins go?

  • Avatar of SlimeDog SlimeDog Jun 28, 2016 at 01:43 UTC - 0 likes

    @heckabecca: Go

    filoghost is still around, so he must be working on something more important. :(

Facts

Date created
Sep 03, 2013
Categories
Last update
Mar 08, 2016
Development stage
Release
Language
  • enUS
License
All Rights Reserved
Curse link
Custom Join Items
Downloads
198,198
Recent files

Authors