SetPlrExtraData

Kategorie: Spieler
Ab Engineversion: 4.9.1.0 GWE

Beschreibung

Mithilfe dieses Befehls können beliebige, scriptdefinierte Werte unter einem gegebenen Namen in der Spielerdatei gespeichert werden. Auf diese Weise kann man Daten über einen Spieler über Szenariogrenzen hinweg erhalten (z.B. für RPGs) Zurückgegeben wird (wenn erfolgreich) der gesetzte Wert.

Syntax

any SetPlrExtraData (int iPlr, string strDataName, any Data);

Parameter

iPlr:
Nummer des Spielers, für den zusätzliche Daten gespeichert werden sollen
strDataName:
Name, der den Daten zugeordnet werden soll
Data:
Daten, die gesetzt werden sollen.

Anmerkungen

Es dürfen keine Objektpointer oder Zeichenfolgen (Strings) gespeichert werden.
Da die Namen des ExtraData über Szenariogrenzen hinweg gültig sind, sollte man dem Namen einen Prefix hinzufügen, um Doppelbenutzungen zu vermeiden ("MySzen_MyName").

Beispiel

Timer:
  for(var i=0; i<GetPlayerCount(); i++)
    SetPlrExtraData(i, "MySzen_Wealth", GetWealth(i));
  return();

Initialize:
  for(var i=0; i<GetPlayerCount(); i++)
    SetWealth(i, GetPlrExtraData(i, "MySzen_Wealth"));
  return();
Die erste Funktion speichert periodisch das Vermögen unter dem Namen "MySzen_Wealth" in dem entspr. Spieler ab. Wird die Runde nun neu gestartet und das Objekt erstellt, so wird das Vermögen der Spieler in Initialize wiederhergestellt.
Siehe auch: GetPlrExtraData, SetCrewExtraData
PeterW, Januar 2002