AddGold( _playerId, _amount )
AddGold( _amount ) -- Kurzschreibweise für Spieler 1 (menschlicher Spieler im SinglePlayer Modus)

Mittels dieser Funktion kann man die Rohstoffmenge eines Spielers (_playerId) um eine angegebene Menge (_amount) verändern.

Wird keine _playerId angegeben, so wird automatisch 1 für die _playerId verwendet. Will man also die Rohstoffmenge des menschlichen Spielers im SinglePlayer Modus verändern, reicht es aus, nur den Wert anzugeben. Im MultiPlayer Modus hingegen, muss man die _playerId mit angeben.

Der Ausgangswert für alle Resourcen ist Null. Normalerweise werden die Start-Resourcen in der Funktion InitResources() gesetzt.

Da es keine Funktionen wie SubGold() oder SetGold() gibt, muss man auch AddGold() verwenden, um einem Spieler Ressourcen abzuziehen. Dazu kann man einen negativen Wert für _amount verwenden, bzw. einen durch arithmetische Funktionen berechneten Wert. Hierbei ist es wichtig darauf zu achten, dass die Menge dadurch nicht ins Minus kommen würde, denn dann wird die Funktion AddGold() nicht ausgeführt, d.h. die Rohstoffmenge bleibt unverändert!

Die jeweils aktuelle Rohstoffmenge lässt sich mittels der Funktion GetGold() ermitteln.

Die Gold-/ Talermenge von Spieler 2 um 500 erhöhen:

AddGold( _playerId, -_amount)
AddGold( 2, 500)

Die Gold-/ Talermenge von Spieler 1 auf 0 setzen:

AddGold(1, -GetGold(1))

Die Gold-/ Talermenge von Spieler 1 auf den genauen Wert von 1.250 setzen (egal ob seine aktuelle Menge größer, gleich oder kleiner diesem Wert ist):

AddGold(1, -GetGold(1) + 1250)

Weiterhin ist es auch möglich die Rohstoffmenge eines Computers zu ermitteln und an der Spieler zu übergeben:

function Rohstoffe()
 local GoldAmount = GetGold(2) -- Goldmenge wird auf dieser variable gespeichert, 
 AddGold(1,GoldAmount) --oder auch nur AddGold(Gold)-- und dann an den Spieler übergeben
end

Die Funktionsweise für die anderen Resourcen ist dieselbe.
Siehe hierzu:

• AddClay()
• AddIron()
• AddStone()
• AddSulfur()
• AddWood()

Die jeweils aktuelle Menge einer Resource eines Spielers kann man mittels der GetResource() Funktionen ermitteln.
Siehe hierzu:

• GetClay()
• GetGold()
• GetIron()
• GetStone()
• GetSulfur()
• GetWood()

Zurück