Kategorie: Objekte
/ Status
Ab Engineversion: 1.0 OC
SetName
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