EasySign

From MC Public Wiki
Revision as of 19:11, 1 January 2017 by Silversunset (talk | contribs)
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


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