Gamesetup Configuration

From DvZ Wiki
Jump to: navigation, search

General Information

The default setup.yml can be seen here: https://github.com/andre111/Dwarves-vs-Zombies/blob/master/DvZ/src/main/resources/config/default/setup.yml

Sections

The setup.yml is split into several sections:

Section Description
gamestart General (start) options.
teams Teams and their relation are defined here.
timer Timers are setup here.

Gamestart

Option Description
startteams List of startteams.

Players get added to one of the startteams when they join the game. Can not be empty!

eventeamsplit Tries to keep the same number of players in every startteam.

Disabling this makes startteam selection completly random.

starttimers List of timers to start on gamestart.

Teams

Every team is namend.

Option Description
name Ingame display name of the team.
respawn The player respawn to this team.
assassinDisplay Displayname of Assassins in Scoreboard. Use "" to not display.
needRelease The team needs to be released.
hasMonument The team has a monument.
monumentName The displayname of the monument.
monumentBar Display the monument health from this team.

Used for displaying the dwarf monument to the monsters.

classes List of classes available to this team.
selectInLobby Select class in Lobby or at the teamspawn.
relation.friendly List of teams this team is friendly to.

Prevents breaking of their monument.

relation.hostile List of teams this team is hostile to.

Enables PvP between the teams. Can be used with only one team to allow "oneway" damage.

friendlyFire Players in the same team can hurt each other.
invulnerable Teammembers cannot take damage.
hideKills Hides playername in death messages.
spawnBuff Time a player is invulnerable after spawn.
spawnBuffItems List of items given after the spawn buf runs out.
onDeath List of Setupcommands executed when the last member of the team dies.
onMonumentDestroy List of Setupcommands executed when the monument is destroyed.
items.pickup Allow picking up items.
items.drop Allow droping items.
items.deathDrop Drop items on death or delete them.
effects.day

effects.night

effects.midnight

List of status effects players of this team get at certain times.
effects.lightlevel.above.[0-15]

effects.lightlevel.below.[0-15]

List of status effects players of this team get in certain lightlevels.
kill.enabled

kill.duration kill.particles

Insta kill buff awarded for killing an enemy player.

Particles can either be a Bukkit particle name: Bukkit Source
or a minecraft particle name: Minecraft Wiki

Timers

Every timer is namend. Timers can be used to add delayed events to the game such as the monster release. You can also setup timers and don't start them and then execute their onEnd Setupcommands by using: /dvz_setup finishtimer [timer].

Option Description
time Time in seconds.
showDisplay Display timer in scoreboard.
display Displayname
onEnd List of Setupcommands to execute when the timer finishes.

Setupcommands

The setup.yml uses "Setupcommands" in several places. These are available currently:

Setupcommand Description
win [team] The provided teams wins. Can be combined with more win or lose commands when in the same actionlist.
lose [team] The provided teams loses. Can be combined with more win or lose commands when in the same actionlist.
release [team] The provided team gets released.
starttimer [timer] Starts the provided timer.
setstartteam [team] Sets the startteam to the provided teams.
addstartteam [team] Adds the provided team to the list of startteams.
removestartteam Removes the provided team from the list of startteams.
set [team] [flag] [true/false] Sets a flag for a team.

Avaliable flags: invulnerable

assassins [team] [percentage_of_players] Turns the percentage of players into assassins.
command [command] [arg1] [arg2] ... Executes a normal bukkit command.