CommonAPI Unterstützung einbauen/nachrüsten

  • CommonAPI in ein Mod einbauen/nachrüsten
    [h1]CommonAPI in ein Mod einbauen/nachrüsten[h1]

    Ist CommonAPI geladen?


    Wichtig: Baut eure Mods immer so, das eure Mods auch ohne die CommonAPI funktioniert. Um herauszufinden ob die CommonAPI geladen ist, überprüft die globale Variable commonapi

    Beispiel:

    Source Code

    1. if (commonapi ~= nil) then
    2. -- Wird nur ausgeführt wenn die CommonAPI vorhanden ist
    3. end
    4. -- In der Regel müsst Ihr Unterfunktionen auch testen:
    5. if (commonapi ~= nil and commonapi.uiparameter ~= nil) then
    6. end

    Gleisauswahl



    Die CommonAPI bietet euch die Möglichkeit an, alle vom Nutzer aktivierten Gleise abzufragen und auch in eurer Konstruktion anzuzeigen.

    Die einfachste Möglichkeit solltet ihr eine Liste mit trackTypes und eure ui parameter dafür definiert haben, diese durch commonapi.uiparameter.modifyTrackCatenary modifizieren zu lassen.

    commonapi.uiparameter.modifyTrackCatenary(params, {
    selectionlist = config.trackTypes
    })

    Der Aufruf dieser Funktion verursacht:
    • Interne Erstellung eines TrackCatenarySelector mit den optionalen Parametern (grün)
    • Die Modifikation der config.trackTypes (orange)
    • Änderung der params (rot)
    Solltet Ihr eure Oberleitung oder Gleisauswahl nicht trackType und catenary nennen, so könnt Ihr in den optionalen Parametern diese mit key = "trackType", catenary_key = "catenary", ggf. anpassen.

    Bitte beachtet:
    Eine Liste, die via selectionlist übergeben wird muss eindeutig sein und darf nicht von einem anderen Parameter mit genutzt werden.
    Solltet Ihr mehr als ein trackType (Beispiel Überholgleis) in eurer Konstruktion unterstützen, so muss auch eine Referenz zur eine neuen Liste von Gleistypen angeben werden


    Lua Source Code

    1. commonapi.uiparameter.modifyTrackCatenary(params, {
    2. key = "trackType2",
    3. catenary_key = "catenary2",
    4. selectionlist = config.trackTypes2
    5. })



    Weiterführende Informationen


    CommonAPI in der Webdisk
    CommonAPI Forum Beitrag


    Eine komplette API Dokumentation findet Ihr im doc Ordner in der CommonAPI.[/h1]

    841 times viewed