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
Author
Wifi
Downloads
0
Views
19
First release
Last update

Ratings

0.00 star(s) 0 ratings

More resources from Wifi

Top