SetName

Kategorie: Objekte / Status
Ab Engineversion: 1.0 OC

Beschreibung

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

Syntax

bool SetName(string name, bool set_permanent, bool make_valid_if_exists);

Parameter

name:
Neuer Name. Wenn nil, wird der Name des Objekts auf den Namen seiner Definition beziehungsweise den Namen in der Spielerdatei zurückgesetzt.
set_permanent:
[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.
make_valid_if_exists:
[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.

Beispiele

protected func InitializePlayer(player)
{
	GetHiRank(player)->SetName("Strunzmuffel");
	return 1;
}
Szenarioscript: Die höchstrangigen Clonks neu beitretender Spieler heißen in dieser Runde anders.
protected func Initialize()
{
	Wood->SetName("Baumstamm");
}
Szenarioscript: Holz wird in dieser Runde Baumstamm genannt.
Siehe auch: GetName, MakeCrewMember
Sven2, 2003-06
Isilkor, 2009-09