Zum Inhalt springen

So fügst du Mods zu deinem Avorion Server hinzu

Avorion bringt ein eigenes Mod-System mit. Du musst die Mods nicht selbst hochladen — dein Server lädt sie beim Start eigenständig aus dem Steam Workshop herunter. Gesteuert wird das über eine einzige Datei: die modconfig.lua im Ordner deiner Galaxie.

Achtung

Stoppe deinen Server, bevor du Mods hinzufügst oder entfernst. Nach einem Spielupdate können Mods inkompatibel sein und Abstürze verursachen. Erstelle vorher außerdem ein Backup deiner Galaxie.

Workshop-ID herausfinden

  1. Mod im Steam Workshop öffnen
    Öffne den Steam Workshop für Avorion und suche die gewünschte Mod.

  2. ID aus der Adresse ablesen
    Die Workshop-ID ist die Zahl am Ende der URL. Bei https://steamcommunity.com/sharedfiles/filedetails/?id=1691539727 lautet die ID also 1691539727.

Mods eintragen

  1. Server stoppen
    Stoppe deinen Server über die Verwaltung.

  2. Per SFTP verbinden
    Verbinde dich per SFTP mit deinem Server oder nutze den Datei-Browser in der Verwaltung.

  3. modconfig.lua öffnen
    Wechsle in den Ordner deiner Galaxie – dort, wo auch server.ini und admin.xml liegen – und öffne die Datei:

    /galaxy/<Galaxie-Name>/modconfig.lua

    Hinweis

    Der Galaxie-Ordner heißt genauso wie der in der Verwaltung eingetragene Galaxie-Name (Galaxy Name). Existiert die Datei noch nicht, starte deinen Server einmal, damit die Ordnerstruktur angelegt wird, und stoppe ihn anschließend wieder.

  4. Mods eintragen
    Trage jede Mod mit ihrer Workshop-ID im Block mods ein:

    lua
    modLocation = ""
    forceEnabling = false
    mods =
    {
        {workshopid = "1691539727"},
        {workshopid = "1691591293"},
    }
    allowed =
    {
    }

    Den Block allowed kannst du leer lassen. Möchtest du zusätzlich clientseitige Mods erlauben, trägst du sie dort in derselben Schreibweise ein: {workshopid = "…"}.

  5. Speichern und starten
    Speichere die Datei und starte deinen Server. Beim Start lädt er die eingetragenen Mods herunter und aktiviert sie – der erste Start kann dadurch etwas länger dauern.

Die Blöcke im Überblick

BlockBedeutung
modsDie Mods, die dein Server lädt. Ein Eintrag pro Mod mit der jeweiligen Workshop-ID.
allowedOptionale Liste clientseitiger Mods (überwiegend UI-Mods), die auf deinem Server erlaubt sind. Kann leer bleiben.
forceEnablingErzwingt das Aktivieren der Mods. Der Wert bleibt auf false.
modLocationAlternativer Ort für den Mod-Ordner. Bleibt der Wert leer, nutzt dein Server den Standardordner mods.

forceEnabling auf false lassen

Die Entwickler von Avorion empfehlen ausdrücklich, forceEnabling deaktiviert zu lassen: Die Option richtet sich in erster Linie an Mod-Entwickler und kann zu beschädigten oder unbrauchbaren Spielständen führen.

Müssen Spieler etwas tun?

Beim Beitritt bekommen Spieler die Mod-Liste deines Servers angezeigt. Über die Schaltfläche connect & download lädt der Client die passenden Workshop-Mods automatisch herunter und installiert sie, bevor der Beitritt erfolgt.

Tipp

Heruntergeladene Workshop-Mods legt dein Server innerhalb der Galaxie unter workshop/content/445220/ ab. Daran kannst du prüfen, ob eine Mod tatsächlich geladen wurde.

Wichtig

Achte auf die Kommas und die geschweiften Klammern. Ist die modconfig.lua fehlerhaft, kann dein Server die Datei nicht einlesen und startet nicht sauber. Kommentiere Mods zum Testen lieber einzeln aus, statt mehrere auf einmal zu ändern.