EasySign

Easy Signs is a sign configuration plugin. All sign types follow the same rules:

• Signs are "special" based on their location, not the text on the sign
• If a sign is broken, it will be removed as an easy sign within a few minutes
• Only admins can configure a sign
• All players can activate the sign
• To configure a sign, look at it, and run /easy-sign <type> [<args>] (the options are listed below)
• Multiple actions can be added. They are run in the order they are added to the sign during configuration.
• To activate a sign, left or right click it
• To remove a sign, simply break it, or look at it and run /easy-sign-delete
• To list all the actions on the sign, use /easy-sign-info. Each action will have a number in this list.
• To remove an action from a sign, use /easy-sign-remove <number>
• To move an action from one position to another in the order, use /easy-sign-reorder <from> <to>

Each "module" or sign type is configured differently, and the documentation is listed below. For the quick version of this guide, just run /easy-sign in game. An example would be: /easy-sign warp 1 2 3

Configuration Commands

Name	Command	Usage
Delete	/easy-sign-delete	deletes the entire sign
Info	/easy-sign-info	Displays the info on a sign
Remove	/easy-sign-remove <action>	Removes the action # from the list of cmds on the sign
Reorder	/easy-sign-reorder <from> <to>	reorder the items

Sign Commands

Name	Command	Usage
Announce	/easy-sign announce <id> <message>	Announces in-game - the message is broadcast only once when the player clicks the sign. Supports /signtext colors and %s is replaced with the players name. The ID sets the 'key' for the sign gropup, players can only announce once per group
Bed (Set)	/easy-sign setbed [<world>] x y z	Sets the players bed location at the specified position
Bed (Teleport)	/easy-sign tpbed	Teleports the player back to their bed
Cart	/easy-sign cart [<world>] x y z	Spawns a minecart at the specified location
Command	/easy-sign cmd <command>	runs the command as the user
Give	/easy-sign give <item> <qty> [<slot>]	gives the player an item
Give Held	/easy-sign giveheld [<slot>]	gives the player a duplicate of your currently held item
Give Max	/easy-sign givemax <id> <item> <qty> <max gives> [<slot>]	gives the player max # of an item
Heal	/easy-sign heal [<gap>]	refills a players health. If ia gap is provided then the player gets half a heart every gap seconds. default is 0 = instant
Hunger	/easy-sign hunger	refills a players hunger bar
Inventory (Check for Empty)	/easy-sign check-empty-inventory [<message>]	If the player's inventory is not empty, do not execute any subsequent sign actions and show <message>, if specified, or a default message. Default message: Your inventory must be completely empty to use this.
Inventory (Clear)	/easy-sign ci	clears the players inventory
Inventory (Drop)	/easy-sign dropinventory [scatter] [<world>] x y z	Drops a copy of your current inventory at the specified coordinates. Specify 'scatter' as the first argument to give the dropped items random velocities
Inventory (Give)	/easy-sign giveinventory	Gives the player the items in your inventory, filling the empty space
Inventory (Replace)	/easy-sign inventory	Clears the players inventory and gives them an exact copy of your current inventory
Launch	/easy-sign launch x y z	Launches the player with the specified velocity vector.
Leather	/easy-sign leather <red> <green> <blue> <item1> ... <itemN>	gives the player leather armor with the specificed red, green, and blue color components (0-255). <item1> to <itemN> are a list of items to give and can only be: helmet, chestplte, leggings, or boots
Lore	/easy-sign lore <item> <qty> <lore>||<itemmsg>||<qtymsg>	Takes a specified qty of an item from a player if it has the required lore. Colors are ignored and lines are concatenated without spaces. The item must be in the players hand. If the wrong item is held <itemmsg> is shown. If it is the right item but insufficient qty <qtymsg> is shown. The <itemmsg> and <qtymsg> can be multiple words and color codes are allowed. The double bar seq || is used to separate those arguments. If the item is not taken for whatever reason, subsuquent sign actions are not processed. Caution: multiple consecutive spaces in any of these strings will be replaced with single spaces
Max (uses)	/easy-sign max <id> <uses>	Allows the sign to be used <uses> items and no more. No other commands will run when limit is reached
Message	/easy-sign msg <message>	Sends the player a message. Color codes with & are supported
Potion	/easy-sign potion <id> <strength> <seconds>	applies a potion effect to the player. <ID> must be 1-23 <strenght> has a minimum level of 1 These potion effects can be used.
Potion (clear)	/easy-sign clearpotions	Clears all potion effects
Random Location	/easy-sign randloc <max_distance>	Randomly spawns the player max_distance away from 0,0
Sleep	/easy-sign sleep	resets spawn at the point of the sign
Take	/easy-sign take <item> <qty> <failmsg>	takes an item from the player. If they dont have enough a failmsg is shown and no other commands are run
Warp	/easy-sign warp [<world>] x y z	sends player to coordinates listed, <world> is optional