Allgemein

Neben den Grundbefehlen gibt es einige StellwerkSim-eigene Befehle, die es erlauben, Werte zu setzen oder auszulesen.

Manche Befehle können Werte setzen, andere (oder auch die gleichen) können Werte lesen, wieder andere können nur in bestimmten Klassen stehen. Befehle zum Setzen von Werten werden genau so eingegeben, wie sie heißen, Befehle zum Lesen müssen immer mit einem $ beginnen.

Abkürzungen

Im Folgenden wird bei den Befehlen immer angegeben, wie und wann diese verwednet werden können. Dabei werden folgende Abkürzungen verwendet.

1. (L0) - Befehl unterstützt Lesen, es werden dann keine Parameter benötigt
2. (L) - Befehl unterstützt Lesen, es werden Parameter benötigt, Details dann im Text
3. (S) - Befehl unterstützt Setzen
4. (:S) - Befehl darf nur in Klasse Start
5. (:B) - Befehl darf nur in Klasse Bahnhof
6. (:SB) - Befehl gibt in den Klassen unterschiedliche Werte zurück

StellwerkSim spezifische Kommentarfunktion:

Neben den Befehlen sind auch Kommentare möglich. Diese beginnen am Zeilenanfang mit einem Doppelkreuz (#). Es gibt einige Spezialkommentare:

1. #DESC - diese Zeilen werden in der ThemaScript-Übersichtsliste (ThemaScript-Editor) ausgegeben
2. #DATE - enthält immer das Datum der letzten Sicherung, wird automatisch gesetzt

Wichtig: hinter dem Schlüsselwort muß immer ein Leerzeichen stehen!

Die Befehle:

verspätung oder verspaetung

setzt die (Start-)Verspätung des Zuges

1. Klasse: Start (L0)(S), Bahnhof (L0)(S)
2. lesen: kein Parameter
3. schreiben: 1 Parameter (Ganzzahl)

tempo

setzt das Tempo des Zuges

1. Klasse: Start (L0)(S), Bahnhof (L0)(S)
2. lesen: kein Parameter
3. schreiben: 1 Parameter (Ganzzahl)

länge oder laenge

setzt die Länge des Zuges, diese sollte bei Übergabepunkten nicht geändert werden

1. Klasse: Start (L0)(S), Bahnhof (L0)(S)
2. lesen: kein Parameter
3. schreiben: 1 Parameter (Ganzzahl)

aktiv

legt fest ob ein Zug überhaupt fährt oder nicht. Sobald ein Zug deaktiviert wurde, kann er an diesem Spieltag nicht reaktiviert werden

1. Klasse: Start (L0)(S)
2. lesen: kein Parameter
3. schreiben: 1 Parameter (J für aktiv, N für inaktiv)

anstunde

gibt die Stunde der ersten Ankunftszeit des Zuges zurück, entwerder für den ganzen Zuglauf (Klasse Start) oder im Stellwerk (Klasse Bahnhof)

1. Klasse: Start (L0)(:SB), Bahnhof (L0)(:SB)
2. lesen: kein Parameter

abstunde

gibt die Stunde der letzten Abfahrtszeit des Zuges zurück, entwerder für den ganzen Zuglauf (Klasse Start) oder im Stellwerk (Klasse Bahnhof)

1. Klasse: Start (L0)(:SB), Bahnhof (L0)(:SB)
2. lesen: kein Parameter

abstundev

gibt die Stunde der letzten Abfahrtszeit des Zuges für das vorherige Stellwerk zurück

1. Klasse: Bahnhof (L0)
2. lesen: kein Parameter

flag

prüft, ob ein Flag im Bahnhof gesetzt ist, dazu muß das zu prüfende Flag als Parameter übergeben werden, erlaubte Flags sind R, E, K, F, A, B1, B2

1. Klasse: Bahnhof (L)
2. lesen: 1 Parameter (Flag)

wurdegesteuert

gibt TRUE zurück, wenn das letzte Stellwerk des Zuges im Fahrplan gesteuert wird. Das bedeutet nicht zwingend, dass der Spieler den Zug auch gefahren hat!

1. Klasse: Bahnhof (L0)
2. lesen: kein Parameter

wirdgesteuert

gibt TRUE zurück, wenn das Stellwerk zu dem der Zug jetzt kommt gerade jetzt gesteuert wird. Das bedeutet nicht zwingend, dass der Spieler den Zug auch fahren wird!

1. Klasse: Bahnhof (L0)
2. lesen: kein Parameter

neuaid

gibt die ID des Stellwerks zurück, an das der Zug jetzt kommt

1. Klasse: Bahnhof (L0)
2. lesen: kein Parameter

altaid

gibt die ID des Stellwerks zurück, von dem der Zug kommt (laut Fahrplan) oder 0 beim 1. Stellwerk des Fahrplans

1. Klasse: Bahnhof (L0)
2. lesen: kein Parameter

thematag

legt den Spieltag für einen Zug fest, es kann nur ein Spieltag angegeben werden, die Spieltage werden hierbei mit A-Z bezeichnet Klasse: Start mögliche Befehle: bei Klasse Start (S), bei Klasse Bahnhof (L0)

1. Klasse: Start
2. schreiben: 1 Parameter (Buchstabe A-Z)

1. Klasse: Bahnhof
2. lesen: kein Parameter

simparam

mit dem simparam-Befehl können einige Details für jeden Zug eingestellt werden.

Setzen eines Wertes ergänzt die bestehenden Werte, das heisst die Werte werden nicht überschrieben. Betritt ein Zug ein neues Stellwerk ist der Befehl wieder leer. Achtung, das ändern der Werte kann das verhalten des Sim stark verändern! Alle änderungen gelten nur für den einen Zug und nur für das eine Stellwerk!
Syntax: wert,bedeutung,bahnsteig,simparam

Parameter:

1. Klasse: Bahnhof (S)
2. schreiben: 3 Parameter
   1. wert
      Der Wert ist eine Zahl, in der Regel eine Zeitangabe in Minuten oder ein Tempowert. Für JA/NEIN Werte ist 0 = Nein und 1 = Ja als Wert zu übergeben.

   2. bedeutung
      Die bedeutung ist einer von zur Zeit 7 möglichen folgenden Werten
      - maxrandom Obergrenze zufällige Wartezeit, Default 4 Minuten
      - minstop mindest Wartezeit, Default 30 Sekunden
      - maxstop maximale Wartezeit, Default 5 Minuten
      - randomdevisor Mittelwert für Faktor durch den die normale Haltezeit bei Verspätungen geteilt wird, Bereich 2 - 5, Default 2
      - soll_tempo Tempo welches der Zug in der Anlage fahren soll, Default maxtempo vom Zug. Damit kann auch Anlagen-vMax überschritten werden!
      - anrufwartezeit Wartezeit bis zum Anruf bei rotem Signal, Default 3 Minuten
      - gleisänderung Gleisänderung erlauben, Default JA (Zahl>0)

   3. bahnsteig
      Bahnsteig ist der nächste Bahnsteig laut Fahrplan des Zuges. Der Parameter gilt so lange, bis der Zug dort ab- oder durchgefahren ist. Soll ein Wert für alle gelten, so muss als bahnsteig "any" angegeben werden, kein Stern!