TFMM - Train Fever Mod Manager - Transport Fever Community

Alles wissenswerte über den TFMM - sowohl für Nutzer als auch Modder

[Blocked Image: http://ftp.train-fever.net/flaggen/gb.png] Please find the english version here.

[Blocked Image: http://ftp.train-fever.net/flaggen/de.png] Der Train Fever Mod Manager (kurz TFMM) wurde bereits während der Beta von Train Fever entwickelt, um die bereits zu diesem Zeitpunkt aufkommenden Modifikationen schnell und effizient in das Spiel zu integrieren und vor allem, diese auch wieder einfach aus dem Spiel entfernen zu können. Das Hauptaugenmerk lag bei der Entwicklung dadrauf, einfache Handhabung mit Funktionalität zu kombinieren.

Im Laufe der Zeit hat sich gezeigt, dass der TFMM sich sehr schnell verbreitet hat - mittlerweile wurde TFMM bereits über 10.000 Mal heruntergeladen. Auch wenn der TFMM darauf ausgelegt ist auch ohne Einarbeitung voll bedienbar zu sein, bietet dieser Lexikoneintrag alle wichtigen Hintergrundinformationen für euch zusammen.

1 Nutzung

Hier beschäftigen wir uns mit der Nutzung des TFMM für alle Spieler von Train Fever, die sich eine oder mehrere Modifikationen heruntergeladen haben und diese nun in das Spiel bringen wollen.

1.1 Download & Installation

Die aktuellste stabile Version erhaltet ihr immer direkt hier in der Downloaddatenbank auf Train-Fever.net. Nach dem Download der aktuellsten Version entpackt ihr die Dateien in einen beliebigen Ordner und startet TFMM per Doppelklick. für Unterstützung von RAR und RAR5 Archiven muss die unrar.dll im selben Verzeichnis vorhanden sein.

1.2 Der Erste Start

Beim ersten Start wird euch die Einstellung von TFMM präsentiert. Hier könnt ihr den Pfad zu der Train Fever Installation festlegen. TFMM versucht diesen automatisch zu erkennen, er kann aber auch manuell eingetragen werden. TFMM wird euch sofort Rückmeldung geben, ob der Pfad korrekt ist. Sollte Train Fever in einem geschützten Verzeichnis liegen (zB.: C:\Program Files\...) werden eventuell Administrationsprivilegien benötigt. Diese können TFMM durch einen Start per "Rechtsklick->als Administrator starten" zugeteilt werden.
Nach einem Klick auf "Save" werden die Einstellungen übernommen und ihr könnt sofort loslegen.
Der Installationspfad wurde von euch bei der Installation festgelegt. Bei Steam lässt sich der Installationspfad leicht herausfinden: In der Steam-Bibliothek rechtsklick auf Train Fever -> Eigenschaften -> Lokale Dateien -> Ordner durchsuchen.

1.3 Das Hauptfenster

Das Hauptfenster ist der zentrale Anlaufpunkt für die Verwaltung von Modifikationen für Train Fever.

Präsent in der Mitte befindet sich die Liste aller installierten Modifikationen. Die Liste kann nach Name, Autor, Kategorie und Version sortiert werden. Nach einem Neustart wird die Sortierung nach Installationsdatum wieder übernommen.
Am rechten Rand findet ihr die Modifikationsverwaltung. Hier könnt ihr die ausgewählten Modifikationen aktivieren (in das Spiel bringen), deaktivieren (aus dem Spiel heraus nehmen) und auch ganz deinstallieren (aus der Liste entfernen). Unterhalb der Verwaltung befindet sich ein Knopf mit dem ihr euch weitere Informationen zu einer Modifikation einblenden lassen könnt - dazu später mehr.
Am unteren Rand können neue Modifikationen hinzugefügt (Add New Mod), die Downloaddatenbank von Train-Fever.net geöffnet (Download Mods) oder aber Train Fever gestartet (nur die offizielle Steam-Version wird unterstützt) werden. Ganz rechts befindet sich noch die Versionsinformation der genutzten TFMM Version.
Am oberen Bildschirmrand befindet sich das Menü:
- File
  - Settings (Strg + S) - öffnet die Einstellungen von TFMM
  - Close (Alt + F4) - schließt TFMM
- Mods
  - Add Modification (Strg + O) - eine neue Modifikation einbinden.
  - Export Mod List
    - Export List of Activated Mods (Strg + E) - eine Liste von allen aktivierten Mods als TXT oder HTML exportieren
    - Export List of All Mods (Alt + E) - eine Liste von allen angezeigten Mods als TXT oder HTML exportieren
- About
  - Homepage (Strg + H) - öffnet die TFMM Homepage
  - Update (Strg + U) - prüft ob eine neue TFMM Version verfügbar ist
  - License (Strg + L) - Zeigt die Versions- und Lizenzinformationen an

1.4 Neue Modifikationen Hinzufügen

Um neue Modifikationen in Train Fever zu integrieren, können als zip & rar (nur Windows) gepackte Modifikationen einfach per Drag & Drop auf das TFMM Fenster gezogen werden, oder über das Menü, den Knopf am unteren Rand, oder die Tastenkombination Strg + O ausgewählt werden.
Hinzugefügte Modifikationen werden sofort automatisch aktiviert und können direkt im Spiel genutzt werden.

1.5 Modifikationen Aktivieren und Deaktivieren

Sobald eine oder mehrere Modifikationen in der Liste vorhanden sind können diese ganz einfach markiert werden. Auch das markieren von mehreren Modifikationen auf einmal wird unterstützt. Aktive Modifikationen sind durch [Blocked Image: http://ftp.train-fever.net/lexikon/TFMM/yes.png] gekennzeichnet, deaktivierte Modifikationen durch [Blocked Image: http://ftp.train-fever.net/lexikon/TFMM/no.png]. Alle markierten Modifikationen können nun mittels den Funktionen am Rechten Bildschirmrand aktiviert, deaktiviert oder deinstalliert werden. Beim deinstallieren von aktivierten Modifikationen werden diese natürlich zuerst deaktiviert.

1.6 Informationen

Wenn einzelne Modifikationen markiert sind, können Informationen über diese Mod eingeblendet werden (Mod Information). Außerdem wird - soweit vorhanden - das unter "preview.png" im Mod hinterlegte Bild im Hauptfenster angezeigt.
Im Informationsfenster werden die ausgewerteten Einträge der TFMM.ini (falls diese der Mod beigelegt wurde) angezeigt. Soweit vom Mod-Ersteller angegeben können hier der Download-Link sowie die Profile aller Autoren direkt aufgerufen werden.
Weiter Anzeigeoptionen sowie die Möglichkeit Einträge zu ändern folgen mit kommenden TFMM Versionen.

1.7 Fehler und Konflikte

Im Fall von Konflikten zwischen Modifikationen oder Fehlern versucht TFMM Hilfestellungen zur Lösung zu geben. bei unlösbaren Problemen stehen wir in diesem Forum gerne mit einer helfenden Hand zur Seite.

2 Modder

In diesem Abschnitt werden alle Informationen bereitgestellt, die Modder brauchen um ihre Modifikation kompatibel zu TFMM zu gestalten.

2.1 Format

TFMM für Windows kann zip, rar und rar5 lesen. TFMM für Linux ist momentan auf zip beschränkt.

2.2 Ordnerstruktur

Um von TFMM als valide Modifikation erkannt zu werden muss innerhalb der gepackten Ordnerstruktur ein "res/" Ordner existieren. Alle Dateien in diesem Ordner müssen 1:1 mit der Ordnerstruktur in Train Fever übereinstimmen!

2.3 TFMM.ini

Der Modifikation kann eine Datei namens "TFMM.ini" beigelegt werden, welche weitere Informationen über die Mod bereitstellen kann. Das ini-Format wurde ursprünglich aus Gründen der extremen Einfachheit gewählt, allerdings sind in diesem Format keine komplexen Datenstrukturen möglich. Das ini-Format basiert auf einfachen Zuweisen nach dem Schema "key = value", wobei diese Zuweisungen noch in Gruppen zusammengefasst werden können. Im folgenden findet ihr eine Übersicht über alle gültigen Informationen sowie ein Beispiel einer TFMM.ini

Key	Value	Bemerkung
name	String	frei wählbarer Name der Modifikation Aus Kompatibilitätsgründen dürfen zwei Modifikationen nicht den selben Namen haben (außer es handelt sich um eine andere Version der selben Modifikation)
version	Integer [.Integer]*	frei wählbare Versionsbezeichnung Konvention: Durch Punkte getrennte Integer, oder ein Integer
author	String [, String]*	Konvention: durch Komma getrennte Liste der Autoren einer Modifikation Bei repaints o.ä. hängt sich der neue Author immer an das Ende der Liste an
id	String [.String]+	frei wählbare einzigartige Identifikation der Modifikation verschiedene Versionen der selben Modifikation müssen die selbe ID benutzen wenn nicht vorhanden, wird diese aus "author" und "name" automatisch generiert: "author.name" Konvention: Mindestens 2 durch Punkt getrennte Strings, nur Kleinbuchstaben
category	String	Eine Liste von gültigen Kategorien findet sich weiter unten
[online]		Gruppe für Links & andere Online-IDs
tfnet_mod_id	Integer	ID der Modifikation in der Downloaddatenbank auf Train-Fever.net
tfnet_author_id	Integer [, Integer]*	IDs der Authoren auf Train-Fever.net Durch Komma getrennte Integer selbe Reihenfolge wie im Feld "author"
[dependencies]		Gruppe für Abhängigkeiten von anderen Mods
mod_id	mod_version	In der Gruppe für Abhängigkeiten können alle unbedingt benötigten Modifikationen aufgelistet werden key = ID der benötigten Mod value = Version der benötigten Mod, leer oder "any" für eine beliebige Version

2.3.1 gültige Kategorien

Kategorie	Bemerkung
tool	Tools
pack	Mod-Packs
vehicle	Fahrzeuge (allgemein)
vehicle/bus	Busse
vehicle/tram	Straßenbahnen
vehicle/train	Züge/Lokomotiven (allgemein)
vehicle/train/steam	Dampflokomotiven
vehicle/train/diesel	Diesellokomotiven
vehicle/train/electric	Elektrolokomotiven
vehicle/train/railcar	Triebwagen
vehicle/wagon	Waggons (allgemein)
vehicle/wagon/passenger	Passagierwaggon
vehicle/wagon/goods	Güterwaggons
building	Gebäude (allgemein)
building/station	Bahnhöfe
building/deco	Dekorationen
building/town	Stadtgebäude
building/depot	Depots
building/signal	Signale & Wegpunkte
other	Andere Modifikationen

2.3.2 Beispiele für TFMM.ini

Beispielhafte TFMM.ini für den "TFMM" als Mod:

Code

id = xanos.tfmm
name = TFMM
version = 0.5
author = Xanos
category = tool
[online]
tfnet_author_id = 18122
tfnet_mod_id = 5

Beispielhafte, kommentierte TFMM.ini für eine fiktive Mod: