Tutorials - JamesNorris/Ablockalypse GitHub Wiki

Beginner's Guide to the Ablockalypse - Modified by TRok92 for updated commands system

Disclaimer


This is how I understand the plugin. That means that much of this has been found out by trial and error. I couldn't find much on how this plugin works and I can't get some of the features to work but this should help some of the beginners in creating a very fun gametype.


In this short tutorial I will be showing you how to build, create, and test your very own Zombie Ablockalypse.

  1. Installation:

As with many bukkit plugins this one is drag and drop into your plugins folder. Start up the server and the Ablockalypse folder will be created. Inside are the Config, Items, and Local files. We will get to these later. For now start up minecraft and we'll get to work.

  1. Creating a game:

    In order to begin making your game you must first create it. To do this you must type /za game create (gamename)

eg: /za game create test

This will create the game "test". Remember the spelling of your game because in order to create game objects and to allow people to join the game the name must match exactly. This means names are cAsE sEnSiTiVe.

eg: /join Test

Will make the player join a completely different game

This can cause trouble later on when creating game objects and signs.

Congratulations you have created a game of Zombie Ablockalypse.

Though you have created it if you were to join this game the zombies would spawn on top of you and you wouldn't be able to buy any weapons. Before we start playing the game we'll need some game objects to help us along.

  1. Initial starting things:

    There is one thing that we need to start with, and that is the Mainframe. This is where the players first spawn in the game. One thing that can be noted it that this can be configured to also be a teleportation receiver, although lets start with the basics.

    When placing the mainframe, you only need to go and stand on top of the block and then type the command:

/za object create mainframe test

Once you've done that it will give you a message, and your done with this step!

So you know, the mainframe can be any block.

  1. Creating game objects:

    There are a few types of game objects available to you when creating a game. These are: Areas, Barriers, Spawners, and Chests.

    Areas:

When creating an area, you must remember one thing: An area is not the space itself but the door that leads to the space.

This means that instead of having to highlight an entire area you can just highlight a door that leads to a closed off area. When making an area you must type the command:

/za area (game name)

eg: /za area test

This tells the plugin that you want to make an area for zombie ablockalypse in the game "test".

Once you have typed this command, it will come back telling you to click on the first block of your area. When this pops up click on the bottom of your 2 piece door, wall, rubble or blockade. (Personally I have found that doors sometimes glitch and break once they have been selected as areas.) Then the top part of the area door.

Unfortunatly these area doors cannot be more that 2 blocks large, so if you were trying to make a destroyed building disappear you're out of luck.

Once you have clicked on both pieces of the door, they will start flashing with blue wool. This means that the plugin has accepted the area and is ready for another command. In the chat it will also tell you that the area has been created.

Barriers:

Barriers are pieces of fence connected together. Though it says that you must make a barrier by making a 3x3 wall of fences, I have found that any set of fences should be OK. For now however we will use this 3x3 barrier.

Once you have made your wall of fences, Type the command /za barrier (game name)

eg: /za barrier test

After typing this command, the plugin should tell you to click on the center of your 3x3 fence. After doing this, the center fence will begin to blink, just like the area doors. This shows that the barrier has been made. It will also tell you in the chat that the barrier has been created.

Spawners:

In order for the game to work properly and to prevent zombies from spawning on your head, spawners must be used. These area places where the zombies will spawn from. Zombies will only spawn from the spawners closest to the player so feel free to place them all around your map.

To create a spawner type the command /za spawner (game name)

eg: /za spawner test

This will make the next block you click on a spawner. The block you click on will start flashing blue and your spawner has been made. As usual the plugin will tell you that the spawner has successfully been created. Spawners can be anything, from grass to obsidian, just remember that the zombies will spawn on top of the spawner, so make sure that there aren't any low hanging ceilings that they could spawn on top of.

Chests:

Finally the mystery chest. In order to create this you must simply type the command /za chest (game name)

eg: /za chest test

and then click on a chest. This will create the mystery chest for the game. Be sure to remember that in the config there is an option to make the mystery chest shuffle, so feel free to make as many chests as you want.

  1. Signs:

Signs are a major part of the game. These allow you to purchase weapons, areas, perks, and enchants. Every sign starts with the line [ZA] (be sure to keep it capitalized). This shows that it is a sign designated for zombie ablockalypse. The next line that you type will depend on what you want to make the sign do.

Weapon Signs

Weapon signs are neccessary for fun gameplay. These allow players to spend points they get from killing zombies to upgrade their arsenal. They are set up this way:

I********[ZA]****I
I
[WEAPON]**I
I
[Wood_Sword]*I

This will allow the players to buy a wooden sword with their points.
The weapons that are able to be sold are in the Items file inside of the ablockalypse file.
Remember that ZA and WEAPON must be capitalized or it will not work.

Area Signs

Area signs allow players to purchase areas for a set amount. They are set up like this:

I*****[ZA]I
I
[AREA]****I
I
1500I

In this case the area costs 1500 points to open, but this number can be set to any. You could have a door set to sell for 1337 points, all you have to do is change the bottom number of the sign. Notice that the bottom number is not surrounded by square brackets. This means that it is not necessary for the sign to function. The third line could be left blank and the sign would still work, the default price for areas is 1500.

In order for these signs to work, you must put them beside the area you want opened. This is important because the sign will open the closest area to it.

Perk Signs

Perk signs allow players to buy perks or buffs. There are three kinds of perks: Juggernog, Staminup, and Deadshot.
The signs are set up like this:

I****[ZA]*I
I
[PERK]**I
I
[Juggernog]*I

This sign would allow the player to buy Juggernog, but this is easily changable by simply changing the perk on the third line.

Enchant Signs

Enchant signs are the most powerful signs in the game. These allow the player to upgrade their weapon to new hights of power. There is only one enchant: Packapunch.
The signs are set up like this:

I********[ZA]*****I
I
[ENCHANT]*I
I
[Packapunch]**I

This sign will allow players to upgrade their weapon to an even deadlier version.

Join Signs

The most important sign you can make is the join sign. This sign will allow players to join the game simply by right clicking it. They are set up like this:

I****[ZA]I
I
[JOIN]I
I
test*****I

This sign will allow the players to join the game "test".
In order for this sign to work, the name of the game must be identical to what you called your game. If it is one letter off, or even a capitalized letter off, it will create a new game that the player will join.

I have found that if you have an area sign close to a join sign, the area sign will not work. This won't cause trouble if you build your map far away from the join sign, but is a good thing to take note of.

  1. Config

The config for Zombie Ablockalypse is pretty self explanatory. Just follow the instructions there and you should be set.

  1. Items

The items file in the ablockalypse file in the plugins folder allows you to change the price, name, level, and upgrade name of the weapons in the mod.

  1. Local

Best leave this alone.

  1. Permissions

The permissions for Ablockalypse can be found inside the Ablockalypse .Jar file. If you are reading this I assume you know how to open a .jar file but for those who don't: Simply open the jar file with an archive software such as winrar or 7zip. They are as such:
commands:
za:
description: Base command for Zombie Ablockalypse
permission: za.base
usage: Incorrect Syntax, '/za' is correct usage.
permissions:
za.base:
description: Allows players to use the base command.
default: op
za.create:
description: Allows players to create/end/maintain ZA games.
default: op
za.sign:
description: Allows players to place ZA signs.
default: op
za.join:
description: Allows players to join games.
default: op

Things to note

You can add weapons to the Items file but the one time I tried, it made zombies fall from the sky... The sign worked though.
You should remember to capitalize the signs. If all else fails and the sign is not working just capitalize everything.
I havent't yet found out how to change the health and speed of the zombies but am looking forward to being able to configue that aspect of them.

Final Thoughts

This is my knowledge of the Ablockalypse plugin, if I got some things wrong I apologize. Please remember that I may be doing things wrong, if you know better then feel free to change this tutorial.

-MeImNot