So fügst du Mods zu deinem Eco Server hinzu

Eco bringt ein eigenes Mod-System mit. Mods werden ausschließlich auf dem Server installiert – deine Mitspieler müssen nichts herunterladen, der Client bekommt alles Nötige beim Beitreten vom Server.

Achtung

Stoppe deinen Server, bevor du Mods hinzufügst oder entfernst. Der Server liest den Mod-Ordner nur beim Start ein.

Mods herunterladen

Die offizielle Plattform für Eco-Mods ist mod.io.

1. mod.io öffnen
   Rufe mod.io/g/eco auf und suche dir die gewünschte Mod aus.

2. Version prüfen
   Achte darauf, dass die Mod zur Version deines Servers passt. Nach einem Spielupdate können ältere Mods Fehler verursachen oder den Serverstart verhindern.

3. Mod herunterladen
   Lade die Mod herunter. In der Regel erhältst du eine ZIP-Datei mit einer oder mehreren .dll-Dateien und gegebenenfalls eigenen Konfigurationsdateien.

4. Anleitung der Mod lesen
   Sieh dir die Beschreibung der Mod an. Dort steht, in welchen Ordner die Dateien gehören und ob die Mod weitere Mods voraussetzt.

Mods hochladen

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

2. Per SFTP verbinden
   Verbinde dich per SFTP mit deinem Server.

3. Mod entpacken
   Entpacke die heruntergeladene ZIP-Datei auf deinem PC. Hochgeladen werden die entpackten Dateien – eine ZIP-Datei wird vom Server nicht ausgewertet.

4. Dateien hochladen
   Lade die Dateien in folgendes Verzeichnis hoch:

   /Mods/

   Unterordner beachten

   Die meisten Mods gehören direkt in den Ordner Mods. Manche Mods verlangen laut ihrer Anleitung stattdessen den Unterordner Mods/UserCode/. Halte dich immer an die Angaben der jeweiligen Mod.

5. Server starten
   Starte deinen Server. Beim Start werden die Mods geladen.

Übersetzungen

Übersetzungsdateien gehören nicht in den Hauptordner, sondern nach /Mods/Translations/.

Mods entfernen

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

2. Dateien löschen
   Lösche die Dateien beziehungsweise den Ordner der Mod aus /Mods/.

3. Server starten
   Starte deinen Server neu, damit die Mod vollständig entladen wird.

Wichtig

Mods können Gegenstände, Rezepte und Weltobjekte hinzufügen. Entfernst du eine Mod aus einer laufenden Welt, verschwinden alle davon abhängigen Inhalte. Erstelle vorher ein Backup.

Mods über die Konfiguration steuern

Die Datei /Configs/ModKit.eco bestimmt, wie der Server mit Mods umgeht:

Einstellung	Bedeutung
WhitelistEnabled	Legt fest, ob nur ausgewählte Mods geladen werden. Ist die Option deaktiviert, lädt der Server alle vorhandenen Mods
Whitelist	Liste der .dll-Dateinamen, die geladen werden sollen
SubscribedMods	Liste der mod.io-IDs, die dieser Server abonniert hat
MaxNumberOfDownloadRequests	Wie viele Clients gleichzeitig Mods herunterladen dürfen

Datei existiert nicht?

In /Configs/ liegt zu jeder Konfiguration zusätzlich eine Datei mit der Endung .eco.template. Diese Vorlage enthält nur die Standardwerte und wird vom Server nicht gelesen. Fehlt ModKit.eco, kopiere ModKit.eco.template und benenne die Kopie in ModKit.eco um.

Achtung

Änderungen an den Konfigurationsdateien werden erst mit einem Neustart des Servers übernommen.

Müssen Spieler die Mods installieren?

Hinweis

Nein. Mods, die auch den Client betreffen – etwa neue Gegenstände oder Modelle –, müssen ausschließlich auf dem Server installiert sein. Der Client erhält die nötigen Informationen beim Verbinden automatisch. Der erste Beitritt kann dadurch etwas länger dauern.

Einzelne Mods können laut eigener Beschreibung trotzdem eine Client-Komponente benötigen. Prüfe dazu die Anleitung der jeweiligen Mod.