Signs - JamesNorris/Ablockalypse GitHub Wiki
# Intro
Signs can be used to buy items off the walls, buy perks, buy areas, make a way for others to join your game, and more importantly enchant your weapons (a.k.a pack-a-punching your weapon). Signs are a critical element in a map as they make a ZA map what it is. So one must correctly input the correct strings or the sign will either not work correctly or the player will not be able to use it. You can see the proper formatting for the signs in the local.yml file, also you can read below on how to format and what each one does.
## Shop Signs
These are signs that will allow the players to buy weapons to fight the zombie horde! A player would use their points earned from killing some zombies to purchase weapons. The given price can be altered on the config.yml file as well at which level/wave a player may purchase the weapon. Currently, only 6 weapons can be set to purchase, any other will not work, they are: Wooden Sword, Stone Sword, Iron Sword, Gold Sword, Diamond Sword, and a Grenade (Ender Pearl). For a Shop Sign to be created, one must first place a sign and use the format below.
Shop format: Line 1= [ZA] Line 2= [WEAPON] Line 3= "weapon string"
On where "weapon string" is above is where one must put the name of the weapon they want to sell. Below are all the currently possible strings one can put for a weapon.
Weapon Strings: * [WOOD_SWORD] * [STONE_SWORD] * [IRON_SWORD] * [GOLD_SWORD] * [DIAMOND_SWORD] * [GRENADE]
Once all the 3 lines are set, the sign is then ready to be used in-game as a shop. The sign does not have a cool-down feature so if the player as the money, it can spam click the sign, buying a great amount of the item. This is especially useful for the Grenade.
## Perk Signs
Perk Signs are signs that sell perks to help in the endless struggle to survive the endless waves of zombies. Just like Shop Signs, players must earn points so to buy perks but this will also require them to complete a certain level/wave to be able to buy the perk...if they still have the money to buy it that is (by default). This can also be changed in the config.yml file along with the wave that it's unlocked. Currently, there is only 4 perks that can be set to purchase and they are: Heal, Speed, Regen, and Damage. For a Perk Sign to be created use the format below.
Perk Format: Line 1= [ZA] Line 2= [PERK] Line 3= "perk string"
On where "perk string" is above is where the string for the perk should be placed. The strings for those perks are below.
Perk Strings: * [HEAL] * [SPEED] * [DAMAGE] * [REGEN]
Once all the 3 lines are set, the sign is then ready to be used in-game as a perk machine.
## Enchantment Signs
These bad boys will transform any weapon, even a wooden sword, into a zombie killing machine. If a player as a weapon, they can upgrade/enchant/pack-a-punch it using these signs. Only 2 variations exist: Damage and Random. Both implement an enchantment on the weapon; aggressive enchantment's will be the only ones that will be implemented on the weapon. Enchantment's price and wave unlock can be altered in the config.yml file like the others. The format for this sign is shown below.
Enchantment Format: Line 1= [ZA] Line 2= [ENCHANT] Line 3= "enchant string"
On where "enchant string" is above is where the string for the enchantment should be. The strings for those enchantments are below.
Enchant Strings: * [DAMAGE] * [RANDOM]
Once all the 3 lines are set, the sign is then ready to be used in-game as a pack-a-punch machine! It is known that if one pack-a-punches an already pack-a-punched weapon then that weapon will be removed. It is unknown if this is intentional or if this is a bug/glitch. Nonetheless, it is heavily advised to warn players NOT TO ENCHANT A WEAPON TWICE or they will lose their weapon.
## Passage Signs
Passage Signs will make it possible to open any selected set of blocks using the "/za object create passage " command.To build it, you must first have a wall. Then, initiate the command and click on the bottom of the door, after that the top of the door; the result will be a message saying that the passage creation was successful. Finally, to finish it off place the sign near the door and input the format. The format for an Passage Sign is shown below.
Passage Format: Line 1= [ZA] Line 2= [PASSAGE] Line 3 (optional)= "price"
For "price", you can put whatever you wish for the area to cost. Also, notice that these "[]" are not used for the "price" as its not a string. You'll decide the price so the config files don't have to, although, as for default it puts 1500 points in case you decided to leave it out. But putting any number on Line 3 will override the default setting. For example, if you just want to make an passage that has the Mystery Chest in it but not have it cost 1500 points, putting 750 on Line 3 will completely override the 1500 points making it cost 750 points. Remember: Every Passage Sign is alone 1500 points and even if you make one sign output 750 points will not make all the future or past signs cost 750 points. Each one can have its own individual cost.
## Join signs
Join signs are the most basic signs yet. These are not as important as the ones above, as anyone can initiate the command and join a game. There isn't too much to say about these as its self explanatory; whoever clicks on it will join the game its assigned to. The reason one would use this sign is if they create a lobby/place where players can relax, chat, or do whatever other than having them go around the map and either messing with it or grieving. For that reason alone, it is highly recommended that you make a Join Sign so that can be avoided. The choice to use this sign is totally up to you. Anyways, the format for creating the Join Sign is below.
Join Format: Line 1= [ZA] Line 2= [JOIN] Line 3= "map"
Where "map" is, you input the name of you map without using these "[]". Unless your map name has those in which case go ahead. Careful, as inputting the wrong map name will make the plugin create a new game to compensate, so know the name of the map before hand. How it spelled and capitalization is also taken under account. So if you map name is test then put test for Line 3, if it is Test then put that, or even if its tEsT] put that. Bottom line, don't make a mistake or you'll end up creating new games each time and remember what your map is called and if it has caps and/or special characters.