TFMM - Train Fever Mod Manager

Willkommen in der Transport Fever Community

Welcome to the fan community of Transport Fever and Train Fever, the economic simulators of Urban Games. The community is free for you to share and inform yourself about the game. We cultivate a friendly and objective interaction with each other and our team will be happy to answer any questions you may have.

 

Registration and use is of course free for you.

 

We wish you a lot of fun and hope for active participation.

The Team of the 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
    ValueBemerkung
    nameString
    • 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)
    versionInteger [.Integer]*
    • frei wählbare Versionsbezeichnung
    • Konvention: Durch Punkte getrennte Integer, oder ein Integer
    authorString [, 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
    idString [.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
    categoryString
    • Eine Liste von gültigen Kategorien findet sich weiter unten
    [online]
    • Gruppe für Links & andere Online-IDs
    tfnet_mod_idInteger
    • ID der Modifikation in der Downloaddatenbank auf Train-Fever.net
    tfnet_author_idInteger [, 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_idmod_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


    KategorieBemerkung
    toolTools
    packMod-Packs
    vehicleFahrzeuge (allgemein)
    vehicle/busBusse
    vehicle/tramStraßenbahnen
    vehicle/trainZüge/Lokomotiven (allgemein)
    vehicle/train/steamDampflokomotiven
    vehicle/train/dieselDiesellokomotiven
    vehicle/train/electricElektrolokomotiven
    vehicle/train/railcarTriebwagen
    vehicle/wagonWaggons (allgemein)
    vehicle/wagon/passengerPassagierwaggon
    vehicle/wagon/goodsGüterwaggons
    buildingGebäude (allgemein)
    building/stationBahnhöfe
    building/decoDekorationen
    building/townStadtgebäude
    building/depotDepots
    building/signalSignale & Wegpunkte
    otherAndere Modifikationen


    2.3.2 Beispiele für TFMM.ini


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

    Code
    1. id = xanos.tfmm
    2. name = TFMM
    3. version = 0.5
    4. author = Xanos
    5. category = tool
    6. [online]
    7. tfnet_author_id = 18122
    8. tfnet_mod_id = 5


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

    Code
    1. id = author2.author1.firstbus ;eine frei wählbare ID mit der die Mod in TFMM referenziert wird - nur Kleinbuchstaben ohne Sonderzeichen
    2. name = Our First Bus ;ein frei wählbarer Name
    3. version = 0.0.1 ;frei wählbare Version - möglichst Nummern durch Punkte getrennt
    4. author = author1, author2 ;Liste von allen Autoren, Autor des Grundmodells immer an erster Stelle, alle weiteren an das Ende der Liste anhängen
    5. category = vehicle/bus ;Kategorie - Liste mit möglichen Kategorien weiter oben
    6. [online] ;alle folgenden Einträge gehören zur "Online"-Gruppe
    7. tfnet_mod_id = 999 ;ID des Mods hier auf train-fever.net
    8. tfnet_author_id = 1, 2 ;ID der Autoren in gleicher Reihenfolge wie im Feld "author"
    9. [dependencies] ;Abhängigkeitsgruppe
    10. other_mod = any ;Zuweisung von "name = version" oder "id = version", "any" für eine beliebige Version


    2.4 Vorschaubild


    TFMM kann ein Vorschaubild im Format 16:9 anzeigen lassen. Dazu muss einfach nur eine Datei namens "preview.png" der Modifikation beigelegt werden. Alle Bilder werden automatisch skaliert, sodass Bilder mit anderen Größenverhältnissen korrekt angezeigt werden.


    3 Impressum


    TFMM wird entwickelt und gewartet von Xanos / Alexander Nähring.
    Bei Fragen meldet euch am besten hier im Forum, alternativ per PN oder Email

Share