Custom Join Items Plugin 1.7.4

Updated: May 27, 2015 | 426 views |

http://img.niceminecraft.net/BukkitPlugin/Custom%20Join%20Items.png

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.

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

    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.

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

  • Give items on respawn
  • Add plugin commands
  • Add data value
  • Add symbols
  • Add commands as op or console
  • Add BungeeCord support
  • Restrict crafting and storing items
  • Add right or left click options
  • Add multiple commands for item
  • Add a cooldown
  • Add enchantments
  • Add books
  • Add per-world config
  • Command to get an item

Custom Join Items Plugin 1.7.4 Download Links

http://www.dl2.9minecraft.net/index.php?act=dl&id=1388802036

http://www.dl5.9minecraft.net/index.php?act=dl&id=1388827526


Credits: filoghost