attackconfiguration.md

title	layout
attackconfiguration	wiki

{% include toc.md %} Note: The attack system will be rewritten to a more action fighting system. This page contains information about the current system. So do not expect this to stay the same for very long.

Basics

In the Mana server each being can have a series of attacks. For a character these attacks most likely will come from the items it has equipped. For monsters the attacks are defined in the monsters.xml.

If a being wants to attack a target it picks the best suitable attack and uses it. To determinate the best attack the being goes through the list of the available attacks and checks if the attack has a sufficient range to hit the target. Then it will pick the attack with the highest priority and uses that. The used attack first goes through a warmup. After the warmup is finished the damage will be dealt. After this the cooldown starts. During warmup start until cooldown end no other attack can be used meanwhile. After the attack a reuse timer starts. However this timer only affects the attack that was used but not any other attack (This can be used to allow fast attack with dual wield weapons for e.g.)

XML Attack Node

All configuration files (items.xml and monsters.xml) parse <attack> nodes the same way. Here you will find what properties you can set and what their effect is.

Example: {% highlight xml %}

{% endhighlight %}

This two example nodes define two attacks. For the example these attacks are part of a spear attack. The spear can be either used for a short range stab attack or a long range throw attack.

Here is a documentation about the possible parameters for the attack node:

Parameter Name	Type	Mandatory	Default value	Client	Server	Description
id	integer	only for multiple attacks	0	X	X	The id is only used for telling the client which animation to play.
priority	integer	no	0		X	A attack with a higher priority will be preferred if two attacks are usable.
warmuptime	integer	no	0		X	The time between the start of the attack and the actual dealing of damage in game ticks (one tick equals 100ms).
cooldowntime	integer	no	0		X	The time between the dealing of damage and the end of the current attack in game ticks (one tick equals 100ms). Only after the cooldown finished any other attack can be used again.
reusetime	integer	no	0		X	The time after which the *current* attack can be used again *after* the cooldown finished in game ticks (one tick equals 100ms). This can be used to allow fast attack with dual wielding.
basedamage	integer	no	0		X	The minimum of damage the attack can cause (given that the target has no defence).
deltadamage	integer	no	0		X	The delta of the damage the attack can cause. The actual damage will be a random number between basedamage and basedamage + deltadamage
chancetohit	integer	no	0		X	The chance to land a hit. This number is not percent value but a factor that is compared against the dodge chance of the target with some randomness. FIXME Document how this calculation happens.
type	string	no	"other"		X	The type of the damage dealt by the attack. Possible values are: "physical" "magical" "direct" "other"
element	string	no	"neutral"		X	The element of the damage dealt by the attack. Possible values are: "neutral" "fire" "water" "earth" "air" "lightning" "metal" "wood" "ice"
range	integer	no	0		X	The range of the attack in pixels.
animation	string	no	"attack"	X		The name of the animation which the attacker will play.