EasySign
Jump to navigation
Jump to search
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
| 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 |
| 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 |