Selbstausführende Scripts

<< Globale und lokale Variablen

Tutorial: "X³: Terran Conflict Scripting-Tutorial"

Arrays >>

Es ist eigentlich bei fast jedem Scriptpaket notwendig, ein Script zu haben, das sich selbst bei Spielbeginn ausführt. Sonst würde wahrscheinlich keines der Scripte in diesem Scriptpaket je ausgeführt werden. Zudem ist es sehr schlecht, dem Benutzer des Scripts später erst einmal erklären zu müssen, wie man ein Script überhaupt aufruft.

Ob Scripte sich selbst ausführen, hängt von ihrem Namen, bzw. von dessen Präfix ab. Folgende Präfixe führen zu einem selbstausführenden Script:

• setup.
• init.
• !setup.
• !init.

So würde zum Beispiel ein Script namens "init.rassenkonflikte" von selbst ausgeführt werden. So einfach ist das. Es gibt aber noch einige...

Wichtige Hinweise

Nur einmal ausführen

Manchmal müssen selbstausführende Scripts zwar jedes Mal starten, aber bestimmte Aktionen nur einmal vornehmen, zum Beispiel das Definieren eines Hotkeys.
Dafür nutzt man normalerweise globale Variablen. Das selbstausführende Script fragt zunächst eine bestimmte globale Variable ab, und prüft deren Wert. Ist er nicht "[TRUE]", so wird die Aktion ausgeführt und der Wert anschließend auf "[TRUE]" gesetzt.

Wie klappt das?

Beim ersten Mal ergibt die Abfrage nicht "[TRUE]", sondern "null", da es die globale Variable am Anfang noch gar nicht gibt. Anschließend wird die globale Variable auf "[TRUE]" gesetzt.
Beim nächsten Mal ergibt die Abfrage "[TRUE]", da die globale Variable ja eben auf "[TRUE]" gesetzt wurde. Somit wird das ganze nur einmal ausgeführt, es sei denn, ein anderes Script verändert den Wert der globalen Variable wieder.

Beispielcode:

$check = get global variable: name='s304.milit.angriff.setup.check'
If not $check == [TRUE]
*Hier kommen die Aktionen hin, nur einmal ausgeführt werden sollen.
set global variable: name='s304.milit.angriff.setup.check' value=[TRUE]
end
*Hier kommen die Aktionen hin, die immer ausgeführt werden sollen.

Nicht zu lange dauern

Wichtig ist auch, dass alle selbstausführenden Scripts nacheinander laufen. Um nicht andere Scripts aufzuhalten sollte die Ausführung Eures Setup-Scripts nicht lange dauern. Sobald es länger als 2 Sekunden läuft, empfiehlt sich eher, ein anderes Script aufzurufen, und den Code, der viel Zeit beansprucht, dorthin zu verlagern.