DoMagicEnergy

Kategorie: Objekte / Status
Ab Engineversion: 4.6.5.0 CP (erweitert ab 4.9.6.0 CR)

Beschreibung

Verändert den Magiewert eines Objekts. Jedoch wird die gewünschte Veränderung vorgabemäßig nur als ganze ausgeführt und daher auch nur, wenn dadurch nicht die Ober- bzw. Untergrenze (physische Fähigkeit des Clonks bzw. 0) überschritten wird. Wenn die Veränderung iChange nicht als ganze ausgeführt werden kann, gibt die Funktion FALSE zurück. Hierdurch kann mit einem einzelnen Funktionsaufruf gleichzeitig überprüft werden, ob eine Transaktion überhaupt möglich ist.

Syntax

bool DoMagicEnergy (int iChange, object pObj, bool fAllowPartial);

Parameter

iChange:
Veränderung des Magiewertes; positiv oder negativ
pObj:
[opt] Objekt, dessen Magiewert verändert wird. 0 bei lokalem Aufruf.
fAllowPartial:
[opt] Wenn wahr, überträgt der Befehl auch teilweise Zauberenergie bis auf 0 oder das Maximum. Der Befehl schlägt nur fehl, wenn die Zauberenergie gar nicht verändert wurde. Ab CR.

Beispiel

if (DoMagicEnergy(-10)) ObjectCall(CreateObject(MLGT,0,0,GetOwner()), "Activate", this());
Zaubert einen Blitzzauber, wenn die nötige magische Aufladung dafür vorhanden ist.
Siehe auch: GetMagicEnergy
Sven2, November 2001