Common API

Tom said they will pay attention to mod compatibility in the next game, I think that will be a TPF2.0 not a completely new game. The fork may be after the performance patch so I think the principal change is on the parallelism calculation, they will design a new calculation core, since they find the people they were looking for.

The modding problem today, is too strong coupling between datas (partly what CommonAPI is dealing with), which was left from the era of TP, I don't think it will change too much. Since the game is design to first meet UG's spec for the game, not the requirements of modders (which is argumenting everyday)

Ich lese viel hierrüber, ich sehe viele Bildchens und höre von vielen Möglichkeiten. Aber ich muss gestehen - ich hab keinen blassen Schimmer, was diese CommonAPI eigentlich is Ist das "einfach nur ne Mod" die quasi Funktionen bereitstellt, die man nutzen kann? Quasi require "ComonAPI"? Oder wie muss man sich das vorstellen? Das soll kein schlechtgerede sein, aber bisher ist mir das ganze Gebiet viel zu undurchsichtig gewesen, um mich überhaupt näher damit zu beschäftigen - Asche auf mein Haupt

Ich muss @DarkMo 100%ig zustimmen.
Ich verfolge auch den thread, aber habe auch teilweise keinen blassen Schimmer davon .
Vielleicht wäre etwas mehr Dokumentation, Lexikonbeiträge, ausführliche Erklärungen sinnvoll, dass die breite Masse mehr von deiner Arbeit verstehen kann und sie dann würdigen kann.

Ich lese nur, dass du tolle Dinge aus dem Spiel herausholst, also nicht entmutigen lassen, unbedingt weitermachen .
Lg

Zitat von eis_os

Die CommonAPI soll auch immer so verwendet werden, das man Mods auch ohne Sie nutzen kann.

Ein großartiges Beispiel für eine solche Anwendung zeigt @yourgreatestfear in jüngerer Vergangenheit mit den Feldbahnbildern. Erst mit den stark verkleinerten Radien wirken diese wirklich glaubhaft. Deshalb vielen Dank dafür. Beim nächsten Update wird diese Möglichkeit auch prominenter beworben.

Mir erklärt sich halt immernoch nicht, wie man das überhaupt verwendet ><

Die Common API besteht (soweit ich im Bilde bin) aus 3 Komponenten.

• die Komponente im Hintergrund bietet den Mods weitreichende Schnittstellen. So können Bahnhöfe z.b. dynamisch mit allen verfügbaren Gleistypen versehen werden (also entsprechend ein Parameter im Baudialog bereitgestellt werden). Daneben bietet sie noch viele weitere Möglichkeiten, die Mods nutzen können.
• die GUI-Komponente bietet Spielern die Möglichkeit, gewisse Limits des Spiels zu verbiegen, also z.b. den minimalen Kurvenradius. Das kommt gerade bei Schmalspurbahnen gut rüber.
• die Konsole bietet entsprechend Debug-Möglichkeiten für Skriptmods, insbesondere war der Ansatz zuletzt, mehr Fehlermeldungen crashfrei abzufangen.

Man korrigiere mich, wenn ich da falsch liege.

Ich glaub ihr versteht mich völlig falsch - oder wollt, dass ich mich ectra öffentlich mit meiner Dummheit erniedrige WIE nutze ich diese Komponenten? WIE bekomm ich das ins Spiel? Man liest immer was von "das und das unterstützt die CAPI" - WIE wird diese Unterstützung gemacht? Wenn ich ne Mod im Spiel haben will, lade ich sie runter und schmeiß sie ins mod-Verzeichnis. Und das hier? Runterladen - check. Aber wie gehts weiter? Was ist das hier eigentlich? Ne Mod? Ein "Hack" der exe? Ne zusätzliche exe die ich nebenher starten muss? Mir fehlt das grundsätzliche Verständnis, was das hier überhaupt ist >< Ich hoffe, ich konnte mich einigermaßen deutlich ausdrücken - ohne irgendwen zu verärgern Ich tu nich so doof, ich hab echt keinen Schimmer.

Zitat von DarkMo

Ne Mod? Ein "Hack" der exe? Ne zusätzliche exe

Im Grunde ist es von allem ein bisschen. Es ist primär eine Mod (deswegen auch der typische Aufbau mit autor_modname_1. Die Installation erfolgt also so wie bei jeder anderen Mod. Um sie im Spiel zu aktivieren, wählst du sie beim Spielstart/Laden eines Spielstandes konventionell aus. Ein bisschen was lädt aber bereits bei Spielstart im Hintergrund. Tatsächlich solltest du dann eben im Spiel oben noch einen kleinen zusätzlichen Reiter haben (Screenshots siehe vergangene Seiten dieses Themas).

Die erste von mir beschriebene Komponente oben können Modder tatsächlich scriptseitig einbinden und eben checken, ob die commonapi aktiv ist. Die enthaltenen und dann verfügbaren (auch in einem entsprechenden HTML-Doc beschriebenen) Pakete umfassen:

• Filter zum Filtern von definierten Brücken und versteckten/sichtbaren Constructions
• ModInterface zum Prüfen der vorhandenen aktiven Mods (gut für Dependency-Checks sollte ich in meine Mods wohl mal einbauen )
• Repositories, die alle aktiven Gleise, Straßen, Brücken, Tunnel und Bahnübergänge bereithalten (gut für Parameter)
• Settings aus der Mod-settings.lua (ähnlich wie das modutil von Merk)
• UI-Parameter, Paket zum Beeinflussen der Parameter basierend auf den Repositories und eventuell angewendeten Filtern
• Utils mit verschiedenen Hilfsfunktionen

Zur Konsole schrieb @eis_os eine Seite weiter vorne:

Zitat von eis_os

Die Konsole bietet den direkten Draht zu stdout.txt und zur TPF LUA Runtime.(Die LUA Runtime wird beim Laden eines Spiel erstellt und ist daher zum Beispiel im Hauptmenü noch nicht verfügbar und somit ist keine Eingabezeile vorhanden).

Mit print oder commonapi.dmp(<Lua Befehl>) kann man sich das Ergebnis anzeigen.
Des weiteren werden Exceptions von Befehlen abgefangen. D.h. schreibst du dort game.interface.getEntites() würde TPF bei so einen Fall meckern, es fehlen Parameter und das Spiel wird beendet.
In meiner Konsole wird zwar auch die MsgBox angezeigt, nach Bestätigung der Fehlermeldung läuft das Spiel aber weiter.

stdout.txt Ausgabe (auch im Hauptmenü beim Laden eine Spiels)

LUA Befehszeile

Exceptions werden abgefangen, Spiel läuft weiter
Das ist also Primär für die Modentwicklung interessant.

Für die Zukunft:
Ich habe dazu auch Idee um die Konstruktionsfunktion damit auch abzusichern, sprich sollte es einen Fehler in einer updateFn geben, würde dies nicht mehr zum Spielabbruch führen.

Alles anzeigen

AAAAH! Danke, genau sowas erleuchtet mich etwas. Gerade das Repository klingt sehr spannend aktuell, da das für die Gleiswahl im Menü vom Tunnel eigentlich dufte is

Schau dir am Besten den ein oder anderen Bahnhof (z.b. den von @Inselschreck) an. Da ist der CommonAPI-Support mit Gleisparameter eingebaut. Vielleicht steigst du da durch.

Das klingt doch gut. Ein Backlink zum Downloadeintrag wäre ggf noch eine gute Ergänzung. Aber die Basis deckt er auf jeden Fall gut ab, das sind ja die von mir erwähnten Checks.

Zitat von eis_os

Da das Board gerade fast den ganzen Beitrag zerstört hat

Ach ja, dieses Board gehört zu den wenigen, bei dem es angebracht ist, vor dem Verfassen eines längeren Beitrags Notepad++ zu starten und den kompletten Inhalt da rein zu kopieren vor dem Absenden ...

So ganz wird mir immer noch nicht nach lesen aller Beiträge klar, was der mod wirklich kann - ich kann weder engere Radien bauen, noch habe ich oben im Bild (Spiel) den Reiter, der hier auf einigen Bildern zu sehen ist.

Welche Version hast du denn?

eis_os_commonapi_1_20171021

Allerdings noch nicht den aktuellen Patch von UG!

Dann hast du auch keine Chance, an die Features der Dev-Versionen aus 201812 zu kommen...

Diese Versionen gibt es nur hier im Thread.

Ok, dass ohne den aktuellen Patch einige Mods nicht funktionieren finde ich nach und nach raus... - aber wo gibt es den API 201812?

Zitat von Yoshi

Diese Versionen gibt es nur hier im Thread.

In den Posts auf den vorigen Seiten:
Common API
und ein paar weiter vorne...