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 DiZiixZ DiZiixZ Oct 19, 2014 at 16:28 UTC - 0 likes

    why we can not do more than 3 item must change what

  • Avatar of TheFalconPunch123 TheFalconPunch123 Oct 12, 2014 at 12:57 UTC - 0 likes

    Ummm well I configured the first item to be a warp gui with clickwarp, but if people use it they can also teleport through blocks. Is this a glitch or something with my config?

    first-item:
      name: '&aWarps'
      id: 345
      slot: 7
      lore:
        - '&7Right click with item in hand'
        - '&7to open the server warps.'
      command: 'invwarp'
      cooldown-seconds: 3
      permission: 'customjoinitems.warps'

    Image and video hosting by TinyPic
  • Avatar of cbroshin101 cbroshin101 Oct 12, 2014 at 03:32 UTC - 0 likes

    this works well with createyourownmenus

  • Avatar of ThomasDrolo ThomasDrolo Oct 11, 2014 at 12:53 UTC - 0 likes

    Config:

    slot3premi: name: '&7[&6Voten&7]' id: 339 data-value: 1 slot: 3 lore: - '' - '&7Vote für unseren Server' command: 'customtext vote' cooldown-seconds: 5 give-at-respawn: true permission: items.premi first-join-only: false allow-drop: false block-movement: false disabled-worlds: Games, mini/pb, survivalgames6, SurvivalGames4, Lobbys give-on-world-change: false slot5premi: name: '&7[&bSpenden&7]' id: 399 data-value: 1 slot: 5 lore: - '' - '&7Spende für unseren Server' command: 'buy' cooldown-seconds: 5 give-at-respawn: true permission: items.premi first-join-only: false allow-drop: false block-movement: false disabled-worlds: Games, mini/pb, survivalgames6, SurvivalGames4, Lobbys give-on-world-change: false slot7premi: name: '&7[&3Effekte&7]' id: 130 data-value: 1 slot: 79999999 lore: - '' - '&7Such dir deinen Effekt' command: 'trails' cooldown-seconds: 5 give-at-respawn: true permission: items.premi first-join-only: false allow-drop: false block-movement: false disabled-worlds: Games, mini/pb, survivalgames6, SurvivalGames4, Lobbys give-on-world-change: false slot9premi: name: '&7[&2Premium-Lobby&7]' id: 322 data-value: 1 slot: 9 lore: - '' - '&7Teleportiere dich zur &2Premium-Lobby' command: 'warp premium' cooldown-seconds: 5 give-at-respawn: true permission: items.premi first-join-only: false allow-drop: false block-movement: false disabled-worlds: Games, mini/pb, survivalgames6, SurvivalGames4, Lobbys give-on-world-change: false

    Aber ingame habe ich diese Items:

    Slot: 1 (Kompass) (richtig) Slot: 2 (Goldener Apfel) (falsch) Slot: 3 (Papier) (falsch) Slot: 5 (Netherstern) (falsch) Slot: 7 (Endertruhe) (falsch) Slot: 9 (Endertruhe) (falsch)

    Könntet ihr mir bitte helfen?? Wär echt vorteilhaft da dass das beste Plugin dafäür ist :/

  • Avatar of kaitheslayer kaitheslayer Oct 07, 2014 at 06:23 UTC - 0 likes

    Hi I love this plugin but as soon as i added an item it stopped working

    here is my config:

    first-item: name: '&6&lGame Selector' id: 345 slot: 3 lore: - '&cRight Click To Open Games GUI Or Do /games' command: 'chestcommands open gameselector' cooldown-seconds: 5 second-item: name: '' id: 160 slot: 2 data-value: 14 cooldown-seconds: 5 all-the-possible-nodes: name: '' id: 160 slot: 4 data-value: 14 command: '' cooldown-seconds: 5 all-the: name: '&6&lMy Stats' id: 339 slot: 5 data-value: 0 lore: - '&cComing Soon!' cooldown-seconds: 5 all-he: name: '' id: 160 slot: 6 data-value: 14 cooldown-seconds: 5 all-te: name: '&6&lVip Hub' id: 266 slot: 7 data-value: 0 lore: - '&cJoin The VIP Lobby' command: 'mvtp VIP-LOBBY' cooldown-seconds: 5 ll-the: name: '' id: 160 slot: 8 data-value: 14 cooldown-seconds: 5 all-the: name: '&4Not Available' id: 352 slot: 9 data-value: 0 lore: - '&cCould Not Retrieve Pets!' ooldown-seconds: 5 give-at-respawn: true first-join-only: false allow-drop: false block-movement: false disabled-worlds: Creative-1, Factions, Infected, Nether-Games, PaintBall-1, Prison-1, SG, SG3, SG4, Sky-Wars-Hub, Survival-Games, arena1, arena2, island-0, prison, world_nether, world_the_end give-on-world-change: true

  • Avatar of DanSpedey DanSpedey Sep 28, 2014 at 15:58 UTC - 0 likes

    Will this plugin be ported to Sponge??

    http://i.imgur.com/UjXiBGT.gif

  • Avatar of Penz5557 Penz5557 Sep 18, 2014 at 18:22 UTC - 0 likes

    @purejack: Go

    thanks :D

  • Avatar of mscott1106 mscott1106 Sep 10, 2014 at 01:46 UTC - 0 likes

    I  am pretty sure I did this correctly, but it does not work on my server. Please help!!!

    first-item:
      name: '&c&lWarp &2&lCompass'
      id: 345
      slot: 1
      lore:
        - '&bRight click to see the warp
        - '&bOptions!'
      cooldown-seconds: 5
      permission: 'customjoinitems.compass'
    second-item:
      name: '&5&lBlazeCraft &4&lJams'
      id: 84
      slot: 2
      lore:
        - '&5Right click to listen to some'
        - '&5awesome music'
      command: 'music'
      cooldown-seconds: 5
      permission: 'customjoinitems.music'
    third-item:
      name: '&4&lR&6&la&e&li&2&ln&1&lb&5&lo&f&lw &4&lA&6&lr&e&lm&2&lo&5&lr'
      id: 345
      slot: 3
      lore:
        - &4Right click to put on color
        - &4changing armor!
      command: 'Rainbow me rainbow'
      permission: 'customjoinitems.rainbow'
      cooldown-seconds: 5
    fourth-item:
      name: '&2&lParticle &5&lSelector'
      id: 345
      slot: 4
      lore:
        - '&2Right click to select a
        - '&2Particle!
      cooldown-seconds: 5
      permission: 'customjoinitems.particle'
      give-at-respawn: true
      first-join-only: false
      allow-drop: false
      block-movement: false
      disabled-worlds: world_nether, world_the_end, World4, ice, hero, starwars, herobrine1, STEAM, tester, Herobrine2, skyworld, SkyWarsBaseWorld, Crusoe, DeadlyOrbit, dreamworld, botb, pyke, sg4, sg6, west, castlewars, FrostBreath, king, island, plotworld, flatroom, herobrine, lotr, mnt, plotme, BLAZE
      give-on-world-change: true

    And also in the config it is one string not a clump.

  • Avatar of marylaza13 marylaza13 Sep 07, 2014 at 14:26 UTC - 0 likes

    Yep, you should add a in-game config, like /cji addinventory and i dont know :/

  • Avatar of DuskFireHD DuskFireHD Sep 07, 2014 at 06:03 UTC - 0 likes

    How Can I Add A Writen Book To The cji Like For Rules??

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
49,770
Recent files

Authors