What is ItemBound? ItemBound is a small and simple plugin which allows you to bind any command or message to an item.
Getting started Using this plugin is just drag and drop. Put it into your plugins folder and start your server and you're done.
Permissions There are is only one permission for the command and usage of the plugin. All permissions:
itembound.use
Command There is just one command.
And here the description of the command: <> = Variable
/bind<your command or message> => Bind an command to the item you're holding
You can only bind one action to an item at a time.
With item is meant the actual item, not the material of the item.
To the trigger the item action simply left click or right click with the item.
Since actions are bound to the specific item that you had in your hand any other item with the same type will be unaffected.
The item that you bound an action on will get part of the action as name (48 chars max) and the full action into the description of it.
You can also use a placeholder called
%%i.
This placeholder allows you to use the count of the action being used in the action itself. So if you want to save multiple schematics for example but don't want to type the command every single time you could just bind
/schem save schematic_%%i and it will automatically increase the count at the position of
%%i. You can use the placeholder as many times as you want in one action. Everytime you bind a new action the count will be reset and only be increased if a placeholder was detected. The plugin starts counting at 1.
The name of an Item shows what type of action it is:
Blue Name => Action is a message
Aqua Name => Action is a message with an counter
Purple Name => Action is a command
Pink Name => Action is a command with an counter
Translation All messages are in English by default. However you can change them all the time. Just open the message.yml and edit it, it will automatically reload (every of its config and data files will do that)
Code (YAML):
prefix: '&dItem&5Bound &8»'
command:
bind:
success: $
#prefix &aSuccessfully &7bound the specified action to the item in your hand!
only:
player: $
#prefix &7This command can only be executed by a player! not:
permitted: $
#prefix &7You are lacking the permission &8'&citembound.use&8'&7 to use this command!
'no':
action: $
#prefix &7You have to specify an action! item: $
#prefix &7You need to hold an item in your main hand! data:
load:
start: Trying to load data from '$name'
... success: Data was successfully loaded from $name!
failed: Something went wrong while loading data from $name!
save:
start: Trying to save data to '$name'
... success: Data was successfully saved to $name!
failed: Something went wrong while saving data to $name!