Fahrzeuge (PAR)

Egal ob Auto, Zug, Schiff oder Flugzeug - alle Verkehrsmittel in Simutrans lassen sich mit den gleichen Parametern erstellen.
== Parameterliste ==
Parameter 	Beispielwert	Bedeutung 	Format/Erlaubte Angaben
obj 	vehicle 	Art des Objektes 	Text
name 	ICE1 	Eindeutiger Name zur referenzierung des Objekts 	Text
copyright 	Max Muster 	Name des Erstellers, wird im Spiel angezeigt 	Text
intro_month 	1 	Erscheinungsmonat 	Zahlen von 1 bis 12
intro_year 	1989 	Erscheinungsjahr 	Jahreszahl
retire_month	1 	Ausführungsmonat 	Zahlen von 1 bis 12
retire_year 	1989 	Ausführungsjahr 	Jahreszahl
waytype 	track 	Art des benutzten Verkehrsweg 	Siehe #waytype
engine_type 	electric 	Art des Antriebs 	Siehe #engine_type
cost 	100000 	Einkaufspreis des Fahrzeuges 	Zahl in 1/100 Credits
runningcost 	1000 	Monatliche Betriebskosten des Fahrzeuges 	Zahl in 1/100 Credits
speed 	300 	Höchstgeschwindigkeit in km/h 	Zahl
power 	200 	Leistung in KW 	Zahl
gear 	125 	Prozentangabe der im Spiel genutzten Leistung. Ermöglicht eine Anpassung des Fahrzeugsverhalten im Spiel bei naturgetreuer Wiedergabe von Leistung, Geschwindigkeit und Gewicht	Zahl
weight 	10 	Gewicht des Fahrzeugs in (metrischen) Tonnen 	Zahl
payload 	2 	Ladekapazität in der für die definierte Fracht verwendeten Einheit 	Zahl
freight 	none 	Vom Fahrzeug befördertes Ladegut 	Siehe #freight
smoke 	steam 	Vom Fahrzeug ausgestoßene Emission (Dampf, Rauch,...) 	Siehe #smoke
sound 	bell 	Vom Fahrzeug bei der Abfahrt verursachtes Geräusch (Pfeiffen, Klingeln,...) 	Siehe #sound
length 	8 	Länge des Fahrzeuges - insbesonders wichtig zur korrekten Ausrichtung im Verbund 	Zahlen von 0 bis 32, siehe #length
constraint 	 	Mögliche Zusammenstellungen zu einem Fahrzeug verband 	Siehe #constraint
== Grafikparameter==
Die verschiedenen Grafikparameter für Fahrzeuge gibt es jeweils in 8 Richtungen Himmelsrichtungen, welche abgekürzt genannt werden:
[SE],[S],[SW],[W],[NW]*,[N]*,[NE]*,[E]*
*Wird diese Himmelsrichtung nicht definiert, so wird Ersatzweise die Gegenrichtung genutzt. Dies ist für Schienenfahrzeuge der Länge 8 vorgesehen und kaum anderweitig nutzbar.
In folgender Tabelle gilt "S" stellvertretend für alle Himmelsrichtungen.
EmptyImage[x] 	Standardgrafik des Fahrzeuges
FreightImage[x] 	Grafik, welche bei beliebig beladenen Fahrzeug genutzt wird.
FreightImagetype[0]	Mit diesem Parameter kann einer Fracht ein Index zugewiesen werden, um spezielle Grafiken pro Fracht zu ermöglichen
FreightImage[0][S] 	Grafik, welche bei beladenem Fahrzeug genutzt wird, wobei die verwendete Index-Zahl mit FreightImagetype definiert werden muss.
Die einfachste Version ist ein Fahrzeug, das unbeladen, wie beladen die selbe Grafik verwendet. Hier reicht der Parameter "EmptyImage".
Soll ein Fahrzeug beladen anders aussehen, als unbeladen sind zusätzlich die Parameter "FreightImage" und "FreightImagetype" erforderlich. Ein Fahrzeug kann in einer dat mit mehreren Ladungsgrafiken beschrieben werden. Die erste wird mit [0] bezeichnet.
Der Parameter "FreightImagetype" definiert, welche Grafik für welche Fracht benutzt wird.
Bei den Parameter "EmptyImage" und "FreightImage" sind jeweils 8 Einträge (Zeilen), für die verschiedenen Ansichten nötig.
"FreightImagetype" ist nur jeweils ein Einzeiler, der die Fracht mit der Grafik verknüpft.
bei "EmptyImage"und FreightImage" folgt hinter dem = der Name der Grafikdatei, ohne die Endung (.png), danach die Koordinaten der Ansicht in der Grafikdatei.
Bei "FreigtImagetype" steht der Name einer Fracht, die in der goods.dat definiert ist.
Das ganze sieht dann in der dat folgendermassen aus:
 EmptyImage[W]=LKW.0.0
 EmptyImage[NW]=LKW.0.1
 EmptyImage[N]=LKW.0.2
 EmptyImage[NE]=LKW.0.3
 EmptyImage[E]=LKW.0.4
 EmptyImage[SE]=LKW.0.5
 EmptyImage[S]=LKW.0.6
 EmptyImage[SW]=LKW.0.7
 
 FreightImagetype[0]=Eisenerz
 
 FreightImage[0][W]=LKW.1.0
 FreightImage[0][NW]=LKW.1.1
 FreightImage[0][N]=LKW.1.2
 FreightImage[0][NE]=LKW.1.3
 FreightImage[0][E]=LKW.1.4
 FreightImage[0][SE]=LKW.1.5
 FreightImage[0][S]=LKW.1.6
 FreightImage[0][SW]=LKW.1.7
 
 FreightImagetype[1]=Kohle
 
 FreightImage[1][W]=LKW.2.0
 FreightImage[1][NW]=LKW.2.1
 FreightImage[1][N]=LKW.2.2
 FreightImage[1][NE]=LKW.2.3
 FreightImage[1][E]=LKW.2.4
 FreightImage[1][SE]=LKW.2.5
 FreightImage[1][S]=LKW.2.6
 FreightImage[1][SW]=LKW.2.7
==Koordinaten==
Hinter dem Namen der Grafikdatei stehen die Koordinaten der einzelnen Ansichten. Beispiel von oben: EmptyImage[W]=LKW.0.0
Bei Fahrzeugen sind 8 Ansichten erforderlich. Diese werden der Einfachheit wegen nebeneinander angeordnet. 
Sind eine oder mehrere Ladungsgrafiken für das Fahrzeug vorhanden, werden diese jeweils darunter angeordnet.
Die Grafik links, oben hat die Koordinaten .0.0
Von links nach rechts wird mit .0.1 bis .0.7 durch nummeriert. Die Reihe darunter ist dann .1.0 bis .1.7
Als Beispiel ein Lkw aus dem pak96.comic.
 
In der ersten Reihe (.0.x) ist die Ansicht ohne Ladung (EmptyImage). Die anderen zeigen die Ladungsgrafiken (FreightImage) für Kohle (.1.x), Erz (.2.x) und Getreide(.3.x).
Die nächste Grafik zeigt die Fahrtrichtung inkl. der Himmelsrichtung an. Die mitangegebenen Koordinaten sind nur ein Beispiel
==Mögliche Werte==
===waytype===
Der Parameter "waytype" definiert die Art des Weges, also ob es sich um Straße, Schiene oder Fluss - beziehungsweise Auto, Bahn oder Schiff handelt.
Wert 	Bedeutung
road 	Straßenfahrzeug
track 	Eisenbahn
tram_track 	Straßenbahn*
water 	Schiff
air 	Flugzeug
monorail_track 	Einschienenbahn**
maglev_track 	Magnetschwebebahn**
narrowgauge_track	Schmalspurbahn**
*Straßenbahnfahrzeuge teilen sich die Fahrwege mit Eisenbahnfahrzeugen, tauchen jedoch in einem gesonderten Depot auf.
**Monorail, Maglev und Schmalspur sind funktional identisch und werden in manchen Paksets anders oder gar nicht verwendet.
===engine_type===
Der Parameter "engine_type" definiert die Antriebsart eines Fahrzeugs. Diese wird im Spiel angezeigt, hat aber - mit Ausnahme von "electric" - keine Auswirkung.
Fahrzeuge, welchen der engine_type "electric" zugewiesen ist, können nur auf elektrifizierten Strecken fahren. Es muss also eine Oberleitung oder eine Stromschiene vorhanden sein.
Wert 	Bedeutung
bio 	Tiere
sail 	Segel
steam 	Dampf
diesel 	Diesel
electric 	Elektro
hydrogene	Wasserstoff
fuel_cell	Brennstoffzelle
battery 	Akkumulator
===freight===
Der Parameter "freight" gibt an, welches Gut mit einem Fahrzeug transportiert werden kann.
Paksetübergreifend funktionieren die Parameter "None", "Passagiere" sowie "Post".
Sämtliche anderen Warenarten können vom jeweiligen Pakset frei definiert werden.
* Güter des Pak192.comic
===smoke===
Der Parameter "smoke" legt die vom Fahrzeug ausgestoßene Emission fest. Dazu wird ein weiteres Objekt benötigt, welches Rauch oder Dampf darstellt - siehe Parameter der Smoke-Objekte
Paksets verfügen über untschiedliche Smoke-Dateien.
* Smoke-Dateien des Pak192.comic
===sound===
Der Parameter "sound" ermöglicht es, dem Fahrzeug eine Sounddatei zuzuweisen, welche beim abfahren abgespielt wird.
Die Sounddatei muss dazu im WAV-Format im Order "Sound" des Paksets vorliegen.
Verwendet wird entweder der Name der Datei ohne Endung oder eine ID, welche ihr im gleichen Ordner in einer Sound.tab zugewiesen werden kann.
* Sounds des Pak192.comic
===length===
Mit dem Parameter "length" wird dem Fahrzeug eine Länge zugewiesen. Damit wird bestimmt, wieviel Abstand zu anderen Fahrzeugen eingehalten werden muss. Besonders bei gekuppelten Fahrzeugen ist es sehr wichtig, dass "length"-Parameter und Grafik übereinstimmen.
Die Längenangabe erfolgt in Sechzehntel einer Kachellänge. Bei der Standardlänge 8 passen somit zwei Fahrzeuge auf eine Kachel.
===constraint===
Mit dem Parameter "constraint" ist es möglich, bestimmte Fahrzeugreihungen vorzugeben oder zu verhindern.
Wird der Parameter nicht verwendet, so ist das Fahrzeug sowohl vorne als auch hinten mit jedem anderen Fahrzeug des gleichen Typs kuppelbar.
Den Parameter "constraint" gibt es in zwei Ausführungen:
constraint[prev][x] gibt an, welche Fahrzeuge vor demjenigen mit diesem Parameter gereiht werden dürfen.
constraint[next][x] gibt an, welche Fahrzeuge nach demjenigen mit diesem Parameter gereiht werden dürfen.
Das x wird als fortlaufender Index verwendet, beginnend bei 0.
=====Beispiel=====
Erstellt wurden eine Dampflokomotive "Lok1" und ein dazugehöriger Tender "Tender1". Die Lokomotive ist nicht für Schubverkehr geeignet und darf nur in Kombination mit dem Tender verwendet werden. Lok1 erhält daher folgende Parameter:
*constraint[prev][0]=none
*constraint[next][0]=Tender1
Damit kann Lok1 nur noch als vorderstes Fahrzeug verwendet werden. Wird Lok1 im Depot ausgewählt, so wird automatisch Tender1 angehängt.
Passend zu Lok und Tender gibt es Passagierwagen erster, zweiter und dritter Klasse (genannt: Pax1, Pax2, Pax3). Diese sollen hinten an den Tender kuppelbar sein, aber Lok und Tender sollen auch alleine fahren dürfen. Dazu erhält der Tender folgende Parameter:
*constraint[prev][0]=Lok1
*constraint[next][0]=Pax1
*constraint[next][1]=Pax2
*constraint[next][2]=Pax3
*constraint[next][3]=none
Da nun auch der Tender auf die Lok verweist bilden diese beiden Fahrzeuge eine untrennbare Einheit. Alternativ könnte der gleiche Tender natürlich auch einer weiteren Lok angehängt werden, diese müsste dann ebenfalls eingetragen werden.
Der Wert "none" muss stets den höchsten Index tragen, also nach allen anderen möglichen Fahrzeugen angeführt werden. Die Reihenfolge der anderen Fahrzeuge macht ansonsten keinen Unterschied.