CommonAPI2 Schnelleinstieg

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

  • CommonAPI2 für TPF2

    1 CommonAPI2

    Die CommonAPI2 besteht intern aus zwei Teilen:

    • Ein normaler Script-Mod
    • Eine nativer Teil

    Der native Teil ermöglicht erhebliche Änderungen außerhalb der normalen Spielmöglichkeiten, da es neuen Programmcode in einer dll bzw so enthält.



    2 Funktionen

    • Schnittstellen für Mod Autoren
    • Lua Console
    • Crash Debug (nur Windows)
    • Modgleise über den Bahnhofsadapter bauen.
    • Beseitigung von Script Fehlern, Benutzerdaten/mods und stageing_area werde als mod erkannt.
    • Mod Einstellungen ändern (settings.lua von Mods)
    • Modlisten exportieren und importieren
    • Überprüfen ob es neue Versionen von Mods auf transportfever.net gibt
    • Upgrade von Mods auf transportfever.net


    3 Ist CommonAP2 geladen?


    Der native Teil wird immer geladen, sobald Ihr CommonAPI2 im mods oder per Steam abonniert habt.
    Ihr seht in der oberen linken Ecke das CommonAPI Menü schon im Hauptmenü.


    Die API Funktionen für Modautoren werden in einem Spiel erst aktiv, wenn die CommonAPI2 auch in der Modliste aktiv ist.


    Ihr könnt die CommonAPI nur einmal installieren, solltet Ihr nicht die Steam Version nutzen und die CommonAPI2 in modsVerzeichnis installieren, so muss das Verzeichnis eis_os_commonapi2_1 heißen, sonst gibt es einen Crash oder Fehlverhalten!!! In den Zip Dateien ist immer der richtge Verzeichnisnamen enthalten.
    Gleichzeitiges abonnieren des Mods unter Steam und installieren im mods Ordner funktioniert nicht.


    Für Testzwecke kann in den Einstellungen der native Teil abgeschaltet werden. Also die DLL bzw. SO Datei.

    Dieses führt aber zu erheblichen Problemem in Bezug von Modlisten im Spiel und sollte für CommonAPI2 in TPF2 nicht genutzt werden.

    Solltet das Spiel nicht richtig funktionieren, so schreibt einen Bugreport.


    4 Abhängigkeiten

    Die Upgrade Funktion benötigt curl. (Curl wird ab Windows 10 1803 von MS mitgeliefert)

    Desweiteren wird eine 7-zip Installation benötigt: https://www.7-zip.org/ um zip/rar/7z Dateien zu entpacken, solltet Ihr die Modinstallationsfunktion oder Upgrade Funktion nutzen.

    (Für Linux benötigt Ihr auch curl und p7zip-full)


    5 CommonAPI Menü


    Das CommonAPI Menü könnt Ihr per AltGr + C ein und abschalten.
    Hier findet Ihr weitere Funktionen:


    6 Verzeichnisse

    Hier kommt Ihr schnell an das Spielverzeichnis und auch an das Benutzerdatenverzeichnis des Spiels.


    7 Lua Console


    Die Lua Console zeigt euch direkt die letzten Meldungen der stdout.txt an.

    Darüber hinaus könnt Ihr direkte Befehl in der LUA Runtime des Spiel bzw. der CommonAPI ausführen. ">>>" bedeutet Spiel LUA (dafür muss CommonAPI2 im Spielstand als Mod aktiv sein)

    Es gibt links unten eine Drop Down Box wo Ihr die verschiendenen Script Umgebungen auswählen könnt.


    8 Mod Einstellungen


    Viele Mods beinhalten die Möglichkeiten Einstellungen per settings.lua im jeweiligen mod Verzeichnis zu ändern.
    Sobald Ihr im Lademenü eines Spiel seid, könnt Ihr über CommonAPI Mods -> Mod Einstellungen, alle aktiven Mods sehen bzw. auch einstellen.


    Im "Mod Einstellungen" Fenster:
    Sobald eine Mod settings.lua unterstützt, gibt es rechts neben der Modifikation einen Button "Einstellungen"


    Sobald Ihr einen Eintrag auswählt, zeigt CommonAPI2 weitere Informationen an (untere Tabs), außerdem werden Mods hervorgehoben sobald es ein Update gibt.

    Dafür müsst Ihr die neusten Daten von TransportFever.net herunterladen, das geht über den obere Knopf "Update Informationen herunterladen")



    Veränderungen während des Spiels sind meist erst nach dem (Neu-)Laden eines Spielstands aktiv. (Ggf. Spielstand sichern und laden)


    Ein Upgrade eines Mods ist während eines Spiel nicht möglich.


    Hat die Mod Abhängigkeiten definiert, so könnt Ihr diese unter "Dep" nachschauen.
    CommonAPI2 zeigt euch Links an, damit Ihr diese per Steam oder Forum Download installieren könnt.


    Darüber hinaus überprüft CommonAPI2 auch Mod Abhängigkeiten, sofern diese vom Mod bereitgestellt werden und warnt euch wenn ein Mod inaktiv oder nicht installiert ist.


    9 Modlisten Export & Import


    Im Lademenü von Spielständen und den erweiterten Einstellungen für ein neues Spiel könnt Ihr die aktive Modliste exportieren und importieren.


    Dafür im CommonAPI2 Mods Menü -> Modliste exportieren bzw. importieren klicken


    Beispiel: Alter Spielstand im Spiel Laden Menü auswählen, das Spiel nicht starten, im CommonAPI2 Mods Menü -> Modliste exportieren klicken und Abspeichern.


    Im Hauptmenü -> Freies Spiel -> Erweitert ... (Nun sieht Ihr eine Modliste). Dann CommonAPI2 Mods Menü -> Modliste importieren klicken.



    10 Verschiedene Versionen


    Meisten ist die Steam Version eine alte aber recht stabile Version, dieses gilt auch für die Webdisk.
    Im CommonAPI Forum Thema gibt es regelmäßig -dev Versionen zum testen der neusten Funktionen.


    11 Weiterführende Informationen

    CommonAPI2


    12 Downloads

    CommonAPI2

    CommonAPI2 - Modulare Bahnhofsadapter

    CommonAPI2 - Train Depot Adapter

Share

Comments 1

  • Vielen Dank, jetzt wird mir das Eine oder Andere klar ;)