OneTimeItem
OneTimeItem
Tested Minecraft Versions:
  • 1.7
  • 1.8
  • 1.9
  • 1.10
  • 1.11
  • 1.12
NOTE: This latest version (3.2.0) and up will require Java8.

This plugin allows a player to have "One-Time" item, which will execute pre-defined set of commands when it is "right-clicked" in the air. Once the item is used, it will automatically be removed from player's inventory.

The server owner can :
  • use any item as an One-Time item,
  • assign any number of commands to be executed upon right-click.
The configuration of each One-Time item must be specifed in the config.yml.



Installation:
Just install OneTimeItem.jar in the plugin folder. Then you can either "restart the server" or "reload the plugin.

Commands:
  • /oti help : displays this help menu.
  • /oti reload : reloads config file.
  • /oti debug <true|false> : turn on / off the debug mode.
  • /oti give <player> <one_time_item_id> <amount> : gives <player> the specified one time items.
  • /oti list : lists available one time items.
Permissions:
  • onetimeitem.admin : allows you to use give | list command
  • onetimeitem.reload : allows you ot use reload command

Configuration:
Code:
Messages:
  ErrorMsg : "&c[OneTimeItem] : Some error occured."
  NoPlayer : "&c[OneTimeItem] : Player Not Found."
  NoSuchOneTimeItem : "&c[OneTimeItem] : No such OneTimeItem %type% found."
  OTItemGiven: "&a[OneTimeItem] %player% received %amount% one time items of type %type%!"
  OTItemReceived: "&a[OneTimeItem] You received %amount% one time items of type %type%!"
  OnceInALifetime: "&c[OneTimeItem] : You can use this item once in your lifetime!"
  CannotUseIt: "&c[OneTimeItem] : You cannot use it here!"
  NoPermission : "&c[OneTimeItem] : You don't have a permission to use this item!"

HelpMessages:
  banner:
    msg: "=== &e[&aOneTimeItem Commands List (%version%)&e] &r==="
  help:
    msg: "&a/oti help : displays this help menu."
  reload:
    msg: "&a/oti reload : reloads config file."
    permission: "OneTimeItem.reload"
  debug:
    msg: "&a/oti debug <true|false> : turn on / off the debug mode."
    permission: "onetimeitem.debug"
  give:
    msg: "&a/oti give <player> <one_time_item_id> <amount> : gives <player> the specified one time items."
    permission: "onetimeitem.admin"
  list:
    msg: "&a/oti list : lists available one time items."
    permission: "onetimeitem.admin"

# if this option is set to true, a user must have a correspoiding permission
# node to use the item
UsePermissionNode: false

# this option just enable/disable the fake glowing effect.
UseEnchantGlow: true

# this option will allow you to use OTI without NBT tag.
# instead it will add unique item tag to the item's lore
UseItemTag: false

#
# command starts with '@' will be executed as a player
# command starts with '>' will be executed as the players as an Op.
# command starts with '!' will be executed by the console.
#
OneTimeItems:
  Multiplier1:
    Item: SNOW_BALL
    Data: 0                     #this is for item like INK_SACK
    Name: "&aMultiplier"
    Lore:
      - "&bRight Click to redeem!"
    Commands:
      - ">asa addmultiplier %player% 2 1:0"
    RandomCommand:         # one of following commands will be randomly picked and executed.
      - ">eco give %player% 100"
      - ">te add %player% 100"
    OnceInALifetime: true  # a player can use this item only once in his/her lifetime
  Multiplier2:
    Item: ENDER_PEARL
    Name: "&aMultiplier 2"
    Lore:
      - "&bRight Click to redeem!"
    Commands:
      - ">asa addmultiplier %player% 2 2:0"
#    DisabledWorlds:
#      - no_multiplier
#    DisabledRegions:
#      - no_multi_region
#    Sound: BLOCK_ANVIL_BREAK
#    Effect: PORTAL  # PORTAL particle is the default

Latest updates

  1. 6.9.1

    6.9.1

Latest reviews

Could you update to most recent version please? Thank you
Its not working
Could you please update the plugin to its latest version? Thanks
Please update to 1.13.2
PLEASE UPDATE IT !
A great plugin, served my purpose. Thanks!

Similar resources

OneTimeItem K
Use an item ONCE! to execute any commands (as a player, console, op!) World/WorldGuard supported!
0.00 star(s) 0 ratings
Downloads
120
Updated
OneTimeItem K
0.00 star(s) 0 ratings
Downloads
217
Updated
0.00 star(s) 0 ratings
Downloads
41
Updated
BlackSpigot General Chat
Rules Help Users
    BlackSpigot.com @ BlackSpigot.com: @BlackSpigot.com send pv I have responded
    Top