DE.3

Die wichtigsten XML-Tags und Attribute

gearboxMogliGlobals

Mit diesem Tag kann man einige globale Parameter des Getriebes steuern. Das Tag kann sowohl in der separaten Datei gearboxAddonConfig.xml, als auch in der XML-Datei des Vehicles verwendet werden.

Es gibt folgende XML-Attribute:

• torqueFactor: (1.1182) / Umrechnungsfaktor von realen Drehmomentwerten zur Angleichung an Giants Werte. Die Nennleistung des Traktor sollte bei der Giants-Standardkurve bei 72% des maximalen Drehmoments anliegen. Leider ist die Standardkurve hier aber nicht ganz korrekt, da bei 86% der Nenndrehzahl noch 88% des maximalen Drehmoments anliegen. Hier läge dann die Maximalleistung des Traktors, und wäre 5% über der Nennleistung. Das findet man zwar bei moderneren Traktoren. Die werden dann aber auch oft mit der Maximalleistung beworben. Außerdem beachtet Giants leider nirgends den Wirkungsgrad des Getriebes. (im AddOn 94%) Damit ergibt sich dieser Faktor als 0.86 * 0.88 / ( 0.72 * 0.94 )
• blowOffVentilVol: (0.14) / Grundlautstärke des TurboSounds
• blowOffVentilRpmRatio: (0.7) / Wie hoch muss die Drehzahl gewesen sein, damit der TurboSound abgespielt wird
• drawTargetRpm: (false) / Anzeige der Zieldrehzahl im Hud
• drawReqPower: (false) / Anzeige der verwendeten Leistung im Hud
• defaultOn: (false) / Steuert, ob das Getriebe am Anfang ein- oder ausgeschaltet ist
• disableManual: (false) / Unterdrückung des manuellen Modus beim Automatikgetriebe
• minTimeToShift: (0) / Solange dauert ein Gangwechsel mindestens in Millisekunden
• maxTimeToSkipGear: (251) / Bei Schaltzeiten von mehr als 251ms ist das Überspringen von Gängen nicht erlaubt; Beispiel: MAN
• shiftEffectTime: (251) / Bei Schaltzeiten von weniger als 251ms wird die Traktordrehzahl so modifiziert, dass man den Gangwechsel besser hören kann
• modifySound: (true) / Das GearboxAddon passt die Tonhöhe den geänderten Drehzahlwerten automatisch an
• modifyVolume: (true) / Das GearboxAddon verändert die Lautstärke des Motorklangs abhängig von der Motorlast
• modifyTransVol: (true) / Das GearboxAddon variiert die Tonhöhe des Getriebeklangs abhängig von der Gangzahl (gerade/ungerade)
• shiftTimeMsFactor: (1) / Mit diesem globalen Faktor kann man alle Schaltzeiten verlängern (>1) oder verkürzen (<1)
• playGrindingSound: (true) / Wird beim Schalten mit manueller Kupplung nicht die Kupplung gedrückt, dann gibt es einen Gruß vom Getriebe

gearboxMogli

Das ist das eigentliche Getriebe. Die XML-Tags , , , und sind mögliche Unter-Tags. Außerdem gibt es folgende XML-Attribute:

• swapGearRangeKeys: boolean (false) / veraltet, tauscht die Gänge mit der ersten Gruppe
• transmissionEfficiency: float (0.94) / Effizienz des Getriebes
• ptoRpm: integer / Drehzahl bei Eingeschalteter Zapfwelle
• clutchOpenRpm: integer (0) / Drehzahl unterhalb derer die Kupplung automatisch geöffnet wird; damit kann man eine Wandlerkupplung simulieren
• clutchCloseRpm: integer (~1200) / Drehzahl oberhalb derer die Kupplung geschlossen wird; das ist so zusagen die Überbrückungskupplung
• speedLimiter: boolean / mit Begrenzung der Maximalgeschwindigkeit
• maxForwardSpeed: float / damit kann man die Maximalgeschwindigkeit des Traktors überschreiben
• maxBackwardSpeed: float / dito für Rückwärts
• doubleClutch: boolean (false) / das komplette Getriebe ist nicht synchronisiert => Kuppeln mit Zwischengas
• minClutchRatio: float (0.002) / kleinster Wert für Kupplung
• maxClutchRatio: float (1) / größter Wert für Kupplung
• globalRatioFactor: float (1.025) / Gesamtübersetzung
• revUpMs: integer (2000) / Zeit in ms die der Motor von Leerlauf bis Maximaldrehzahl benötigt
• revDownMs: integer (1000) / dito für die andere Richtung
• disableManual: (false) / manuellen Modus ausblenden
• motorBrakeFx: (0.5) / Stärke der Motorbremse, wenn also kein Gas gegeben wird

gears

Hier werden die Gänge mit dem Unter-Tag gear definiert. Es gibt folgende Attribute:

• shiftTimeMs: integer (800) / Zeit fürs Schalten in ms; 0 für ein Lastschaltgetriebe; -1 für automatische Gänge beim stufenlosen Getriebe
• clutchRatio: float (0.5) / minimale Kupplung nach dem Schaltvorgang
• manualClutch: boolean / Kupplung muss im manuellen Modus betätigt werden
• doubleClutch: boolean (false) / die Gänge sind nicht synchronisiert => Kuppeln mit Zwischengas
• reverseReset: boolean (false) / Gang beim Wechsel zwischen vorwärts und rückwärts merken und zurücksetzen
• defaultGear: integer (1) / Gang beim Start
• automatic: boolean (false) / Automatik

gear

Das ist die Definition eines einzelnen Gangs. Es gibt folgende Attribute:

• speed: float / Geschwindigkeit bei Nenndrehzahl
• name: string / Text für die Ganganzeige
• reverseOnly: boolean (false) / sperrt den Gang für Vorwärtsfahrt
• forwardOnly: boolean (false) / sperrt den Gang für Rückwärtsfahrt

ranges

Hier werden die Stufen einer Gruppe mit dem Unter-Tag range definiert. Diese XML-Tag kann null bis zweimal in einem Getriebe auftauchen. Es gibt folgende Attribute:

• shiftTimeMs: integer (1000, 1200) / Zeit fürs Schalten in ms
• clutchRatio: float (0.5) / minimale Kupplung nach dem Schaltvorgang
• manualClutch: boolean / Kupplung muss im manuellen Modus betätigt werden
• doubleClutch: boolean (false) / die Gruppe ist nicht synchronisiert => Kuppeln mit Zwischengas
• reverseReset: boolean (false) / Gang beim Wechsel zwischen vorwärts und rückwärts merken und zurücksetzen
• defaultRange: integer / Stufe beim Start
• automatic: boolean (false) / Automatik, aber nur bei Gruppe 1 möglich

range

Das ist die Definition eines einzelnen Gangs. Es gibt folgende Attribute:

• ratio: float / Über- oder Untersetzung einer Stufe; normalerweise hat die höchste Gruppe den Wert “1“ und alle anderen Gruppen sind kleiner als 1
• name: string / Text für die Ganganzeige
• reverseOnly: boolean (false) / sperrt den Gang für Vorwärtsfahrt
• forwardOnly: boolean (false) / sperrt den Gang für Rückwärtsfahrt

reverse

Hier kann man den Rückwärtsgang oder die Wendeschaltung konfigurieren. Es gibt folgende Attribute:

• shiftTimeMs: integer (800) / Zeit fürs Schalten in ms
• clutchRatio: float (0.5) / minimale Kupplung nach dem Schaltvorgang
• manualClutch: boolean / Kupplung muss im manuellen Modus betätigt werden
• doubleClutch: boolean (false) / die Gruppe ist nicht synchronisiert => Kuppeln mit Zwischengas
• ratio: float (1) / Über- oder Untersetzung der Rückwärtsgänge

hydrostatic

Beim stufenlosen Getriebe verändert ein Hydrostat die mechanische Übersetzung in einem gewissen Wertebereich. Die entsprechenden Werte kann man zusammen mit dem jeweiligen Wirkungsgrad im Unter-Tag efficiency angeben.

• correctGearSpeed: boolean / Die Übersetzung der Gänge wird so angepasst, dass die Ganggeschwindigkeit bei Nenndrehzahl und maximalem hydrostatischen Faktor erreicht wird
• profile: string / Anstelle einzelner efficiency-Werte kann man auch einfach ein Profil angeben. Es gibt derzeit diese 4 Profile
  • Input: Das Profile Input sollte möglichst mit einem automatischen 4-Gang Getriebe kombiniert werden. Das Verhältnis zwischen zwei aufeinander folgenden Gängen sollte 1:2 betragen. Der Hydrostat kann die Übersetzung von Faktor 0 bis 1,3333 variieren.
  • Output: Fendt kombiniert einen Hydrostaten mit einem 2-Gang Getriebe. Der Hydrostat übernimmt dabei auch den Rückwärtsgang, daher geht die Übersetzung von -0.7 bis 1.
  • Direct: Beim Profile Direct kann der Hydrostat auch den Rückwärtsgang übernehmen
  • Compound: In diesem Profil wird je nach Geschwindigkeit zwischen Eingangs- und Ausgangskopplung gewechselt.

efficiency

Mit diesem XML-Tag kann man ein eigenes Profil für den hydrostatischen Antrieb angeben. Es hat folgende Attribute:

• ratio: float / Über- oder Untersetzung; muss aufsteigend definiert werden
• factor: float / Wirkungsgrad

realEngine

Mit diesem XML-Tag kann man eine alternative Drehmomentkurve definieren. Die meisten Traktoren verwenden leider die Standardkurve von Giants, die ich persönlich für ungenügend halte. Die einzelnen Werte werden im Unter-Tag torque angegeben. Es gibt folgende Attribute:

• idleRpm: integer / Leerlaufdrehzahl in U/min
• ratedRpm: integer / Nenndrehzahl in U/min

engines

Seit Landwirtschafts-Simulator 2017 kann man für ein Fahrzeug mehrere Motorkonfigurationen hinterlegen. Analog dazu kann man im GearboxAddon mehrere Drehmomentkurven zu diesen Konfigurationen hinterlegen. Diese werden unter dem XML-Tag engines zusammengefasst. Pro Konfiguration wird dann ein XML-Tag engine in derselben Reihenfolge wie die Motorkonfigurationen im Fahrzeug erwartet.

engine

Dieses XML-Tag entspricht dem XML-Tag realEngine, nur eben unterhalb von engines für mehrere Motorkonfigurationen. Es gibt folgende Attribute:

• name: Name der Motorkonfiguration
• idleRpm: integer / Leerlaufdrehzahl in U/min
• ratedRpm: integer / Nenndrehzahl in U/min

torque

Dieses XML-Tag hat folgende Attribute:

• rpm: integer / Drehzahl in U/min
• motorTorque: float / Drehmoment in Nm
• motorTorqueEco: float / Drehmoment in Nm ohne Boost (optional)
• fuelUsageRatio: float / spezifischer Verbrauch in g/kWh
• ptoTorque: float / alternative zu motorTorque; Drehmoment in Nm an der Zapfwelle

blowOffVentilSound

Geht man oberhalb einer gewissen Drehzahl vom Gaspedal, dann kann das Getriebe einen so genannten TurboSound abspielen. Dazu gibt es zwei XML-Attribute

• file: string / Sollte die Konfiguration des Getriebes im Mod selber liegen, dann kann man hier die Sound-Datei innerhalb des Mods angeben
• volume: float / Lautstärke