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 ItsLemonmelon ItsLemonmelon Aug 22, 2014 at 10:28 UTC - 0 likes

    Is there any way to put it on the armor inventory AND not just 1 item, adding more items like for pvp, I want more arrows, not just 1... o.-

  • Avatar of MCTylerPVP MCTylerPVP Aug 18, 2014 at 23:50 UTC - 0 likes

    @chris_61: Go

    op: say if you want to say something like op...You really need to go read the wiki for chest commands it explains everything on how to set this stuff up..Prob why noone has responded to a lot of your generic questions...

    EDIT: Its wrote up above....

    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).
    

    This puts my "clickable" voting link in chat...

    Vote6:
      COMMAND: 'tell:&7Website: &3&l&nhttp://www.mineservers.com/server/20731/vote'
      NAME: '&3[+] MineServers List Voting website [+]'
      LORE:
        - 'Voting Link for server.'
        - 'Click to get the link.'
        - 'Then click on Link [arrow_down] [arrow_down] [arrow_down] to open site.'
      ID: 385
      DATA-VALUE: 0
      KEEP-OPEN: true
      POSITION-X: 8
      POSITION-Y: 3
    
    Last edited Aug 18, 2014 by MCTylerPVP

    MC Client Link-EODSteven.org- WebPage http://MCTyler.Enjin.com

  • Avatar of MCTylerPVP MCTylerPVP Aug 18, 2014 at 23:48 UTC - 0 likes

    @drew5494: Go

    Make 'em Books then...

  • Avatar of drew5494 drew5494 Aug 14, 2014 at 22:34 UTC - 0 likes

    Would be better if there were books

  • Avatar of chris_61 chris_61 Aug 14, 2014 at 14:21 UTC - 0 likes

    Hi there, how do you make it so when you right click an item it will say a something in the chat for example a link. I would like to do this without doing /me or /say as the command. Lots of the servers have Website or Forums/Store and it simply says the store link. I don't want to make it ghetto by using /me

  • Avatar of madtomic madtomic Aug 14, 2014 at 03:49 UTC - 0 likes

    Can I use this on cb1.7.2-r0.3 or cb1.7.9-r0.2?

  • Avatar of jackbgoode2001 jackbgoode2001 Aug 13, 2014 at 21:13 UTC - 0 likes

    Can you make it so that players can get armour (equipped) when they join, thanks!

    minecraft servers
  • Avatar of MCTylerPVP MCTylerPVP Aug 12, 2014 at 09:22 UTC - 0 likes

    @Bobbinkin: Go

    For this plugin there is no permissions...but I have chest commands set up..hold on...

        - chestcommands.open.main-menu.yml
        - chestcommands.open.simple-shop.yml
        - chestcommands.open.perks.yml
        - chestcommands.open.donor.yml
        - chestcommands.command.open
    

    There you go...Also do you have a SpanQuit or SpawnJoin plugin?

    Last edited Aug 12, 2014 by MCTylerPVP
  • Avatar of Bobbinkin Bobbinkin Aug 10, 2014 at 03:10 UTC - 0 likes

    Hey I was wondering how I disable the players from receiving the items on different worlds. My players still receive the items when I use Perworld plugins. The items just dont work when they do.

  • Avatar of Bobbinkin Bobbinkin Aug 09, 2014 at 14:21 UTC - 0 likes

    @MCTylerPVP: Go

    what is the permission for items? My players cant see them either, even though I set a custom node, then gave it to that group. Help pls.

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
42,179
Recent files

Authors