SetName

Kategorie: Objekte / Status
Ab Engineversion: 4.9.1.0 GWE (erweitert ab 4.9.6.0 CR)

Beschreibung

Ändert für eine Runde den Namen eines Objekts oder einer Definition.

Syntax

bool SetName (string szNewName, object pObj, id idDef, bool fSetInInfo, bool fMakeValidIfExists);

Parameter

szNewName:
Neuer Name. Wenn 0 (nicht ""!), wird der Name des Objekts auf den Namen seiner Definition beziehungsweise den Namen in der Spielerdatei zurückgesetzt.
pObj:
[opt] Objekt, dessen Name geändert werden soll. 0 bei lokalem Aufruf.
idDef:
[opt] Wenn angegeben, wird pObj ignoriert, und stattdessen der Name der Definition geändert.
fSetInInfo:
[opt] Nur für Crewobjekte: Wenn wahr, wird der Name permanent in der Infosektion des Spielers geändert. Namen dürfen jeweils nur einmal pro Spielerdatei vorkommen. Ab CR.
fMakeValidIfExists:
[opt] Steuert das Verhalten, falls ein Clonk mit dem angegebenen Namen schon in der Stammcrew des Spielers existiert: Wenn unwahr, schlägt die Funktion in diesem Fall fehl. Wenn wahr, wird ein neuer Name durch Anhängen einer Zahl erzeugt. Ab CR.

Anmerkung

Vor Clonk Endeavour bewirkte ein Aufruf für ein Mannschaftsmitglied noch eine permanente Änderung in der Spielerdatei und ein Aufruf für ein normales Objekt eine Änderung für alle Objekte der gleichen Definition.

Beispiel

protected func InitializePlayer(iPlr)
  {
  SetName("Strunzmuffel", GetHiRank(iPlr));
  return(1);
  }
Szenarioscript: Die höchstrangigen Clonks neu beitretender Spieler heißen in dieser Runde anders.
Siehe auch: GetName, MakeCrewMember
Sven2, Juni 2003