✓ OneTimeItem 6.9.1

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 (Text):

Messages:
ErrorMsg : "&c [OneTimeItem] : Some error occured."
NoPlayer : "&c [OneTimeItem] : Player Not Found."
NoSuchOneTimeItem : "&c [OneTimeItem] : No such OneTimeItem %type% found."
OItemGiven: "&a[OneTimeItem] %player% received %amount% one time items of type %type%!"
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