Tested Minecraft Versions:
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 :
Installation:
Just install OneTimeItem.jar in the plugin folder. Then you can either "restart the server" or "reload the plugin.
Commands:
Configuration:
- 1.7
- 1.8
- 1.9
- 1.10
- 1.11
- 1.12
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.
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.
- 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