Sign Tutorial

Essentials Signs

Since Essentials 2.8, all signs are now disabled by default. You can enable each sign individually in the Essentials config.yml.
Note: You need to have at least one sign type enabled to use coloured signs, and don't forget about the permission nodes for colours!

Description: These special sign types come by default with the Essentials.jar plugin.

The permission nodes to be able to create and use Essentials' signs can be found in the Command Reference/Perm. It's highly recommended that players be granted access to use signs, while certain creation privileges should be tightly controlled.

For a detailed sign tutorial video, click here.

Signs

[Sign] Text1	All Essentials signs have their type on the top line in [square brackets] If Essentials signs are made correctly the type text will change to blue
[Sign] Text1	If an error is made the type text will change to red
In the following guide <param> is a required parameter and [param] is optional, with the exception of the top line which should be given as written. Signs with a [cost] tag can be used in several ways: You can provide a cost amount, for example: '$5'. You can provide a usage count, for example: '7 Times'. You can provide an item cost, for example: '2 bonemeal' or '2 351,15'. You can provide an exp cost, for example: '23 exp'.

Mail Sign

[Mail]	The first line must be '[Mail]'
[Mail]
This sign acts like an alias to the /mail command, letting people check their mail, useful if you don't allow access to this command.

Free Sign

[Free] <ItemID>	The first line must be '[Free]' Next line must be either an item name or item ID
[Free] dirt
This sign acts like a chest, but when you take items from this chest, the items will be automatically replenished.

Kit Sign

[Kit] <KitName> [Group] [Cost]	The first line must be '[kit]' Next line must be the kit name Next line can be a permissions group or 'Everyone' The last line can be a per use cost See above for [cost] details. For information about kits, see http://wiki.ess3.net/wiki/Command_Reference/Kits
[Kit] Tools
This sign will give a player a predefined kit. If you do not set a group, the user will be checked for the essentials.kits.<kitname> permission. Setting the group to 'Everyone' or to a group name, will allow the sign to be used without the kit permission, and allows for sign only kits. Warning: Experience may vary based on permissions system. Group Manager will include inheritance when checking group.

Disposal Sign

[Disposal]	The first line must be '[Disposal]'
Simply acts like a chest that eats items: Omnomnomnom...

Heal Sign

[Heal] [Cost]	The first line must be '[Heal]' The next line can be a per use cost See above for [cost] details.
[Heal]
A very simple sign which heals you to full hearts, when it's right-clicked. You should not EVER allow your players the create permission for this sign, unless I guess you're running a "Creative" style server.

Time Sign

[Time] <day/night> [Cost]	The first line must be '[Time]' The next line has to be either 'day' or 'night' The next line can be a per use cost See above for [cost] details.
[Time] Day
This sign will allow players to change the server time to day or night, similar to the /time command.

Weather Sign

[Weather] <sun/storm> [Cost]	The first line must be '[Weather]' The next line has to be either 'sun' or 'storm' The next line can be a per use cost See above for [cost] details.
[Weather] Sun
This sign will allow players to change the server weather to sun or storm, similar to the /weather command.

Warp Sign

[Warp] <Warp Name> [Group] [Cost]	The first line must be '[warp]' Next line must be the warp location Next line can be a permissions group or 'Everyone' The last line can be a per use cost See above for [cost] details.
[Warp] City
This sign will warp a player to the warp point. If you do not set a group, the user will be checked for the essentials.warps.<warpname> permission. Setting the group to 'Everyone' or to a group name, will allow the sign to be used without the warp permission, and allows for sign only warps.

Spawnmob Sign

[Spawnmob] <Amount> <MobType> [Cost]	The first line must be '[spawnmob]' Next line must be the amount of mob to spawn Next line must be the mob type The last line can be a per use cost See above for [cost] details.
[Spawnmob] 1 wolf:tamed
This sign will spawn a mob near to the sign. The user will also need the appropriate spawnmob permission eg: 'essentials.spawnmob.wolf' If you don't give 'essentials.spawnmob' they won't be able to spawn via command.

Enchant Sign

[Enchant] <Item> <Enchantment> [Cost]	The first line must be '[enchant]' Next line must be the item to enchant. Use '*' or 'any' for any. Next line must be the enchantment to place The last line can be a per use cost See above for [cost] details.
[Enchant] any silktouch:5
This sign will enchant an item.

Gamemode Sign

[gamemode] <Mode> [Cost]	The first line must be '[gamemode]' Next line must be the mode. Next line can be the cost. See above for [cost] details.
[gamemode] Survival
This sign will set your gamemode. <Mode> accepts survival, creative, and adventure.

Info Sign

[info] [chapter] [page] [Cost]	The first line must be '[info]' Next line must be the page or the chapter Next line can only be a page number, if a chapter was given above. Last line can be the cost. See above for [cost] details.
[Info] Website
This sign will function just like the /info command. You do not need 'essentials.info' permission node. This sign is useful for displaying website urls or lists of rules.

Repair Sign

[repair] <hand/all> [Cost]	The first line must be '[repair]' Next line must be either "hand" or "all". Next line can be a use cost. See above for [cost] details.
[Repair] all
This sign will repair your tools and armor. Like the /repair command, using 'all' will repair all items in your inventory, not just the one being held. Like the /repair command, this sign will check for command costs, so 'repair-item' will be charged for every item in your inventory.

Essentials Eco Signs

These sign types are crucial to any server's economy. Players can sell their hard-earned blocks for money with trade signs, while buy & sell signs enable a permanent, and infinite selling/buying shop. To help your players, you may consider creating an (infinite stock) buy sign for netherrack(netherstone), glowstone, diamond, or other rare items.

The creation of buy & sell signs are traditionally limited to administrators or moderators, because these are infinite shops. Trade signs require the creator to have the items being sold, while buy & sell signs don't.

Trade Sign

[Trade] <Buying> <Selling>	Line1: Must be '[Trade]' Line2: What you want Line3: What you are giving away
[Trade] $<Cost> <# Item>:<tot>   [Trade] <Item> $<Cost>:<tot>	Line2: Should be be either: '<amount> <item>' or '$<amount>'
[trade] $5 10 dirt:100   [trade] 10 dirt $5:100	Line3: Should be be either: '<amount> <item>:<total>' or '$<amount>:<total>' Total being the amount to place in the sign.
[trade] $5:0 10 dirt:100 KHobbits [trade] 10 dirt:0 $5:100 KHobbits	If the syntax is correct Your name will appear on line 4.
These types of signs are typically used by players to sell items to other players. Right clicking the sign by the owner collects the items/cash stored in the sign. Right clicking the sign by the owner with the item being sold, will restock the sign with more items. Anybody else right clicking the sign will buy the items being sold, if they have the 'cost' on them. <item> can be a shortname ie 'bonemeal' or itemId '351,15'. The /itemdb command can help with this. For a video tutorial on how to use trade signs click here

Buy Sign

[Buy] <amount> <itemID> <Cost>	The first line must be '[Buy]' Next line must be the amount per purchase Next line must be either an item ID or name The last must be the cost See above for [cost] details.
[Buy] 10 dirt $5
[Buy] 10 exp $5	You can also buy/sell exp Just use 'exp' instead of an item
Unlike with trading, when setting up a Buy Sign, you are creating an infinite 'admin' shop. The 'cost' is simply removed from the player, and the 'reward' is spawned. See above for valid cost syntax. The amount, is how many items are sold per transaction; in this case, it will be 10 dirt for ever 5 dollars

Sell Sign

[Sell] <amount> <itemID> <Cost>	The first line must be '[Sell]' Next line must be the amount per sale Next line must be either an item ID or name The last must be the cost See above for [cost] details.
[Sell] 10 dirt $5
Same as the Buy Sign, except your selling your items. When you right-click the sign, the items are removed from your inventory and you get the specified 'cost' amount.

Balance Sign

[Balance]	The first line must be '[Balance]'
A very simple sign which displays the players balance, when it's right-clicked.

Coloured Signs

You can also make signs contain coloured text, using Essentials. To make one, simply use the colour codes here before your text.
For example: &4This is red
Yields: This is red