SetPlayerTeam

Kategorie: Spieler
Ab Engineversion: 1.0 OC

Beschreibung

Teilt einen Spieler einem neuen Team zu. Es wird geprüft, ob in dem neuen Team noch Platz ist (anhand des MaxPlayer-Werts).

Syntax

int SetPlayerTeam(int player, int new_team, bool no_calls);

Parameter

player:
Spielernummer des Spieler, dessen Team geändert werden soll.
new_team:
Teamnummer des neuen Teams.
no_calls:
Wenn true, werden die Aufrufe "RejectTeamSwitch" und "OnTeamSwitch" nicht getätigt. Der Spieler wird auch nicht neu verfeindet (dies muss ggf. selbst nachgeholt werden).

Anmerkung

Es wird in allen Spielziel, -regel und Umweltobjekten, sowie dem Szenarioscript die Funktion "RejectTeamSwitch" mit der Spieler- und der Teamnummer als Parameter aufgerufen. Sollte diese irgendwo true zurückliefern, kann so der Wechsel verhindert werden. Nach dem erfolgreichen Wechsel eines Spielers, wird wiederum "OnTeamSwitch" (mit der Spielernummer, der neuen und der alten Teamnummer als Parameter) an all diesen Orten aufgerufen.
Siehe auch: GetPlayerTeam, Teams
Clonkonaut, 2008-04