Um diese Probleme zu lösen, haben wir ein Dateiformat für zusätzliche Befehle definiert. Diese Datei kann nicht nur PHost-Befehle, sondern auch andere neue Befehle aufnehmen, die du erzeugen möchtest. Der Nachteil ist, dass du ein modifiziertes Maketurn benötigst, um die Befehle auch an den Host zu senden.
Die Befehlsdatei heißt cmdX.txt, dabei ist X die Spielernummer. Diese Datei ist eine einfache Textdatei. Jede Zeile ist dabei eins der folgenden:
- leer. Leerzeilen werden ignoriert.
- ein Kommentar. Zeilen, deren erstes nicht-leeres Zeichen ein # ist, werden ignoriert.
- ein Befehl. Diese werden unverändert als Befehlsnachrichten an den Host gesendet.
- ein Spezialbefehl, der mit $ beginnt und eine besondere Aktion bewirkt.
Die folgenden Spezialbefehle sind momentan definiert:
- $timestamp MM-DD-YYYYhh:mm:ss
Zeitstempel. Die Datei gilt als veraltet und sollte ignoriert werden, wenn der Parameter nicht der Zeitstempel des aktuellen Zuges ist. Dieser Befehl muss, falls er verwendet wird, der erste in der Datei sein. Dieser Befehl wird von PCC 1.0.17, VPA 3.61 und Portable Maketurn unterstützt. - $send-file NAME
Erzeugt einen SendBack-Befehl mit einem Datei-Transfer, der die angegebene Datei enthält. Wird von PCC 1.1.2 und VPA 3.61 unterstützt. - $thost-allies ee1ff2
Erzeugt eine Folge von Allianzbefehlen für HOST. Wird von PCC 1.0.17 und Portable Maketurn unterstützt. - $include NAME
Angegebene Datei einbinden. Dieser Befehl wird momentan von keinem Programm unterstützt.
Bei jedem Befehl ist angegeben, welches Maketurn ihn unterstützt (Stand März 2003). Fühle dich dazu aufgerufen, diese Befehle auch in deinem Client zu unterstützen und, falls nötig, neue Befehle einzuführen. Um Verwirrung zu vermeiden ist es empfehlenswert, dieses Dateiformat zu benutzen anstatt ein neues, inkompatibles Format zu erfinden.
Beispiel:
# Additional Commands $time 04-14-199921:34:42 allies add 9 allies config 9 +c ~m
Die erste Zeile ist ein Kommentar. In der zweiten ist angegeben, zu welchem Zug diese Datei gehört. Die dritte und vierte Zeile enthalten zwei allies-Befehle.