Bukkit

Intro

Thank you for choosing SweetPvP as your PvP-arena manager :) Down here you'll find all the steps (and background information) you have to undertake to make everything work. Please read the entire page before asking stupid questions from which the anwsers are listed down here. So let's get to it!

config.yml

Once you have installed the plugin, the plugin will create a folder called SweetPvP in your plugins directory. In this folder there will be 2 files. config.yml and data.yml. Do not mess with data.yml unless you know exactly what you are doing (knows the source-code f.e.). The config.yml is the file where you can configure the plugin to your likings. In the table below you'll find an overview of all configurable features in SweetPvP.

Kits

In the kits-section of the config.yml you define a kit by making a list of items.

kit:
  <kitname case sensitive>:
  - <item 1>
  - <item 2>
  - <item 3> etc.

You can make as much kits as you like with as much items as you like as long it fits in an inventory. Armour will be put on automaticly. The kitname is case sensitive and will be used as name for your kit on signs and for the permissions. The manner the items should been written in will be like this:

<itemID>,<amount>

To specify a data value, you have to simply add the data value to it:

<itemID>,<amount>,<damageValue>

SweetPvP also adds the possibility to add (unsafe) enchantments to items with a max of 3 enchantments. You specify 1, 2 and 3 enchantments like this:

<itemID>,<amount>,<damageValue>,<enchantment1>,<level>
<itemID>,<amount>,<damageValue>,<enchantment1>,<level>,<ench2>,<level>
<itemID>,<amount>,<damageValue>,<enchantment1>,<level>,<ench2>,<level>,<ench3>,<level>

The enchantment-names you can come up with are the following and will add up to level 10.

• power
• flame
• infinity
• punch
• sharpness
• arthropods
• smite
• efficiency
• unbreaking
• fireaspect
• knockback
• fortune
• looting
• respiration
• protection
• blastresistance
• featherfalling
• fireprotection
• projectileprotection
• silktouch
• thorns
• aquaaffinity

Example:

kit:
  Basic:
  - 268,1
  - 261,1
  - 262,16
  - 298,1
  - 299,1,0,protection,1
  - 322,1,1
  PvP:
  - 267,1,0,sharpness,1
  - 261,1
  - 262,64
  - 364,16
  - 306,1
  - 307,1
  - 308,1
  - 309,1

The Lobby

Congratulations, you have customized the plugin to your likings! We'll start now with the in-game part of the setup.

To define the lobby (make sure you have the sweetpvp.admin permission) just stand on the place you would like to have the lobbyspawn and then use the /spvp setlobby command. Congratulations, the lobby is set! The lobby will be used to be teleported to if you use /spvp lobby or when you quit/win/lose a match.

Setting up the Arena

To setup an arena, you first have to build it and make place for as many spawnpoints as you would like to have. Please keep in mind that the game will only start when all spawns are taken.

To define every spawn in an arena, you go to the specific spawn and then use the (make sure you have the sweetpvp.admin permission) /spvp set <arena#> command and replace <arena#> with the number of the arena. Once you have done this, a message like this will show up: Repeat this process until you defined all spawns of the arena. Did you make a mistake or want to remove all spawns of an arena (in fact, deleting the arena)? Just use (make sure you have the sweetpvp.admin permission) /spvp delete <arena#> command and you can start again defining the player-spawns.

Finished? Then move on to the next step: placing the signs.

Placing Arena-Signs

You are nearly finished setting up your first arena. The only thing you have to do is provide a way for players to join. There are 3 types of joins for an arena. These types are: basic, power and kit. Note: Please make sure everyting is CapITAlIzeD as is should be!

Basic Sign

The basic sign is a sign which lets you join without having an extra kit or extra powers. To make this sign you have to type the following:

Of course you can edit (in case of multiple arenas) the number to the number of the actual arena.

When you have done this, a third line of (green) text will appear. This will show you how many players are currently in the arena or it will show you if the arena is disabled (red text) or it will show you that the arena is currently in-game (red text). When you see this appearing, and you see a message in you chat saying the sign was created successfully you know everything went right. When you made a mistake, the first line will turn red and an error will show up. Then you have to make the sign again following the right syntax. There is also a chance that you might want to WorldEdit signs. In that case the sign will work well, however the third line won't be updated. To fix this, just right-click the sign and then leave the game using /spvp quit and the sign will get updated from now on.

Power Sign

The power sign provides a join which gives you an extra power (listed below). It will still be a fist-fight. You make those signs like so:

You can change the "Disorient" to all of the powers listed below. Make sure you capitalize the first letter!

Kit Sign

The kit signs provides a join which gives you a kit when you join. The kits can be configured in the config.yml as said before. You make a kit-sign like so:

The name of the kit (in this example "Knight") can be changed to all kit-names you have configured. Please keep in mind that the names are cASe-SenSItIvE!

Congratulations

Congratulations! You have set up the plugin to your wishes :) You can join an arena by using the right-mouse button on a sign. If you have still any questions, please put them in the comments on the MAIN-PAGE. To add another arena, just repeat from "Setting up the Arena" but replace the "1" with "2". The plugin can handle 999 arenas.

-SugarCaney