API jednotky
Jako tvůrce můžeš používat metody jednotek pro psaní logiky pro schopnosti, které tvoříš.
Class metody
Níže jsou různé metody, které jsou dostupné:
unit.heal(amount)
Přidává dané množství zdraví k Tvým HP.
Zdraví nemůže být vyšší než maximum.
Argumenty
amount
(číslo): Množství HP pro přidání.
unit.takeDamage(amount)
Ubírá dané množství zdraví.
Pokud je jednotka svázána, automaticky se rozváže po zranění.
Zdraví nemůže být nižší než nula. Pokud dosáhne nuly, jednotka zemře a zmizí z hrací plochy.
Argumenty
amount
(číslo): Množství HP pro ubrání.
unit.damage(receiver, amount)
Poškozuje další jednotku.
Pokud daná jednotka zemře, útočník získá nebo ztratí množství bodů definované hodnotou jednotky. Zisk nebo ztráta závisí na tom, zda byla daná jednotka přátelská nebo nepřátelská.
Argumenty
receiver
(jednotka): Jednotka na kterou bude útočeno.
amount
(číslo): Množství HP, které útok způsobí.
unit.isAlive()
Určuje, zda je jednotka naživu.
Jednotka je naživu pokud má pozici.
Returns
(boolean): Zda je tato jednotka naživu nebo ne.
unit.release(unit)
Osvobodí (rozváže) danou jednotku.
Pokud je daná jednotka přátelská, osvoboditel získá množství bodů definované hodnotou jednotky.
Argumenty
receiver
(jednotka): Jednotka která bude osvobozena.
unit.unbind()
Rozváže jednotku.
unit.bind()
Sváže jednotku.
unit.isBound()
Určuje, zda je jednotka svázána.
Returns
(boolean): Zda je tato jednotka svázána nebo ne.
unit.earnPoints(points)
Přidává dané body ke skóre.
Argumenty
points
(číslo): Množství bodů pro přidání.
unit.losePoints(points)
Ubírá dané body od skóre.
Argumenty
points
(číslo): Množství bodů pro ubrání.
unit.triggerEffect(effect)
Spouští daný efekt.
Argumenty
effect
(string): Jméno efektu.
unit.isUnderEffect(effect)
Určuje, zda je jednotka pod daným efektem.
Argumenty
effect
(string): Jméno efektu.
Returns
(boolean): Zda je tato jednotka pod daným efektem nebo ne.
unit.getOtherUnits()
Vrací všechny jednotky na hrací ploše krom této jednotky.
Returns
(Unit[]): Ostatní jednotky na hrací ploše.
unit.getSpace()
Vrací pole, na kterém se jednotka nachází.
Returns
(Space): Pole, na kterém se jednotka nachází.
unit.getSensedSpaceAt(direction, forward = 1, right = 0)
Vrací pocítěné pole v daném směru a množství polí.
Použij tuto metodu, když vracíš pole ze smyslů. Vždy vracej pocítěné pole k hráčovi.
Argumenty
direction
(string): Směr.
forward
(number): Množství polí směrem dopředu.
forward
(number): Množství polí směrem doprava.
Returns
(SensedSpace): Pocítěné pole.
unit.getSpaceAt(direction, forward = 1, right = 0)
Vrací pole v daném směru a množství polí.
Používej tuto metodu interně. Nikdy nevracej běžné pole hráčovi.
Argumenty
direction
(string): Směr.
forward
(number): Množství polí směrem dopředu.
forward
(number): Množství polí směrem doprava.
Returns
(Space): Pole.
unit.getDirectionOfStairs()
Vrací směr, ve kterém jsou schody vzhledem k této jednotce.
Returns
(string): Relativní směr, ve kterém jsou schody.
unit.getDirectionOf(space)
Vrací směr daného pole vzhledem k této jednotce.
Argumenty
space
(SensedSpace): Hledané pole.
Returns
(string): Relativní směr, ve kterém je pole.
unit.getDistanceOf(space)
Vrací vzdálenost mezi daným polem a touto jednotkou.
Argumenty
space
(SensedSpace): Hledané pole.
Returns
(number): Vzdálenost pole.
unit.move(direction, forward = 1, right = 0)
Posune jednotku v daném směru a množství polí.
Argumenty
direction
(string): Směr.
forward
(number): Množství polí směrem dopředu.
forward
(number): Množství polí směrem doprava.
unit.rotate(direction)
Otočí jednotku do daného směru.
Argumenty
direction
(string): Směr otočení.
unit.vanish()
Smaže jednotku z hrací plochy.
unit.log(message)
Zapíše zprávu do herního logu.
Argumenty
message
(string): Zpráva pro zapsání.
Vlastnosti instance
name
(string)
Jméno jednotky.
character
(string)
Charakter, který reprezentuje jednotku na hrací ploše.
health
(number)
Celkové množství poškozené (v HP), které může jednotka přijmout předtím, než zemře.
maxHealth
(number)
Maximální hodnota health
.
reward
(number)
Množství bodů pro odměnění při interakci.
enemy
(boolean)
Zda je tato jednotka nepřátelská nebo ne.
bound
(boolean)
Zda je tato jednotka svázána nebo ne.