Script

Einleitung

Die Scriptsprache von Clonk heißt C4Script.
Objekte und Szenarien von Clonk können ein Script enthalten. Funktionsaufrufe aus Szenarioscripten gelten als globale Aufrufe. Funktionsaufrufe aus Objektscripten gelten als lokale Aufrufe.
Für weitere Informationen zu den spezifischen Scriptarten siehe Objektscripte und Szenarioscripte.
C4Script verwendet C-ähnliche Syntax. Es gibt Operatoren, Variablendeklaration, Compound Statements (Blöcke), Bedingungen (if) und Wiederholungsschleifen (for und while).

Debugging

Fehlermeldungen lassen sich durch Aktivieren des Debugmodus in den Optionen des Menüsystems anzeigen. Jeder Script-Programmierer sollte den Debugmodus aktivieren.

Funktionen

Ähnlich wie in anderen Sprachen können in C4Script Funktionen deklariert werden:
func CreateRock()
{
  CreateObject(Rock,50,50);
  return 1;
}

Variablen/Parameter

Variablen können Werte der Typen int, bool, string, proplist, array oder object enthalten. Für alle in Funktionsaufrufen ausgelassenen Parameter gilt grundsätzlich der Vorgabewert nil. Funktionen akzeptieren maximal zehn Parameter.

Kommentare

Scripte können Kommentare im C-Stil enthalten. Kommentare werden beim Laden des Script herausgefiltert und komplett ignoriert.
func MyFunction() // A comment until the end of the line
{
  Message("This code is executed");
  /* A comment in
     a block */ Message("This one is executed, too");
  // Message("This code is not executed");
  return 1;
}

Weitere Informationen

Funktionen
Aufruf von Scriptfunktionen
Datentypen
Variablen und ihre Geltungsbereiche
Operatoren: +, -, = etc. in C4Script
Die for-Schleife
Befehle zur Schleifenkontrolle
#appendto: Zum nachträglichen Erweitern fremder Scripte
Effekte
Abfrage von Spieldaten
Scriptspieler (z.B. KI-Spieler)
Sound modifiers
Diagnostic messages

Libraries

Shape
Sven2, 2002-04
matthes, 2004-06