Mods für Vintage Story installieren und Fehler beheben

Vor dem Herunterladen einer Mod

Die offizielle Vintage Story Mod DB ist die zentrale Plattform zum Finden und Verteilen von Mods und wird vom in der offiziellen Vintage-Story-Infrastruktur gehosteten Community-Wiki empfohlen. Eine beliebte Mod ist nicht automatisch für deine aktuelle Konfiguration geeignet. Lies ihre Beschreibung und prüfe Abhängigkeiten, Ausführungsseite, unterstützte Spielversionen, Dateiversionen und aktuelle Problemberichte.

Prüfung	Was du für Version 1.22.5 bestätigen solltest
Spielkompatibilität	Die ausgewählte Datei nennt 1.22.5 oder einen laut Autor kompatiblen Bereich innerhalb von 1.22.x
Abhängigkeiten	Alle benötigten Bibliotheken und ergänzenden Mods sind in einer kompatiblen Version installiert
Client-/Serverseite	Die Mod ist dort installiert, wo sie laut Mod-DB-Seite ausgeführt werden muss
Überschneidungen	Keine andere aktive Mod ersetzt dieselben Mechaniken, Ressourcen oder Registrierungen
Auswirkungen auf die Welt	Du weißt, ob beim späteren Entfernen der Mod Blöcke, Gegenstände, Entitäten oder Weltdaten verschwinden könnten
Sicherung	Eine Kopie des betroffenen Spielstands liegt außerhalb des aktiven Spielstandordners

Gehe nicht davon aus, dass die neueste Mod-Datei automatisch die richtige ist. Der offizielle Leitfaden zur Fehlerbehebung warnt ausdrücklich davor, dass eine neuere Mod-Version für eine andere Spielversion bestimmt sein kann. Die Registerkarte „Dateien“ ist die maßgebliche Stelle, um eine Mod-Version mit der tatsächlich installierten Spielversion abzugleichen.

Eine Mod im Einzelspieler installieren

Lade die gewünschte Mod-Datei von ihrer offiziellen Mod-DB-Seite herunter.
Belasse sie als .zip-Datei, sofern der Autor nicht ausdrücklich andere Anweisungen gibt. Bei der Standardinstallation wird das Archiv nicht entpackt.
Starte Vintage Story und öffne im Hauptmenü den Mod-Manager.
Wähle Mods-Ordner öffnen. So musst du nicht raten, welchen Benutzerdatenordner deine Installation derzeit verwendet.
Kopiere oder verschiebe die .zip-Datei der Mod in diesen Ordner.
Kehre zum Mod-Manager zurück und wähle Mods neu laden, oder beende das Spiel und starte es neu.
Prüfe, ob die Mod angezeigt wird und aktiviert ist. Lasse die integrierten Einträge Essentials, Survival und Creative Mode aktiviert; zusammen bilden sie das Standardspiel.
Teste die Änderung in einer neuen Welt oder einer entbehrlichen Kopie, bevor du eine wertvolle, lange gespielte Welt damit öffnest.

Unter Windows lautet der standardmäßige benutzerspezifische Mod-Pfad %appdata%\VintagestoryData\Mods. Für Linux nennt der offizielle Leitfaden ~/.config/VintagestoryData/Mods. Wenn du den Datenpfad angepasst oder die Installation verschoben hast, ist die Schaltfläche im Mod-Manager die sicherere Wahl.

Sicherungen und Updates

Der offizielle Mod-Leitfaden empfiehlt eine Sicherung der Spielstände, bevor du eine Mod hinzufügst oder entfernst oder Vintage Story aktualisierst. Wende diese Gewohnheit auch auf größere Mod-Updates an. Eine Sicherung sollte eine getrennte Kopie sein und nicht nur eine weitere Datei im selben aktiven Spielstandordner.

So aktualisierst du eine Mod:

Beende das Spielen und schließe das Spiel beziehungsweise den Server.
Lies das Änderungsprotokoll der Mod und achte auf Migrationshinweise oder inkompatible Änderungen.
Sichere die Welt und alle wichtigen Konfigurationsdateien.
Entferne das alte doppelte Archiv, wenn die neue Datei einen anderen Namen verwendet.
Installiere den kompatiblen Ersatz und vergewissere dich, dass nur eine aktive Kopie vorhanden ist.
Lade zuerst eine Testkopie und prüfe mod-spezifische Blöcke, Inventare, Entitäten und Rezepte.

Checkliste zur Fehlerbehebung

Problem	Erste Prüfungen	Sichere nächste Maßnahme
Mod wird nicht angezeigt	Falscher Mods-Pfad, ungültiges Archiv, veraltete benutzerdefinierte `modPaths`	Öffne den Ordner über den Mod-Manager. Hat sich der Benutzername des Betriebssystems geändert, prüfe bei geschlossenem Spiel die Pfade in `clientsettings.json` und `serverconfig.json`
Spiel funktioniert nach einem Update nicht	Mod unterstützt 1.22.5 nicht	Deaktiviere alle Nicht-Standard-Mods und installiere ausdrücklich mit der aktuellen Spielversion kompatible Versionen
Fehlende Blöcke oder Ausnahmen beim Start	Mehrere Versionen derselben Code-Mod	Durchsuche alle konfigurierten Mod-Pfade und behalte nur die gewünschte Kopie
Absturz tritt nur mit mehreren Mods auf	Konflikt zwischen zwei Mods	Reproduziere das Problem in einer Testwelt und deaktiviere jeweils die Hälfte der Mods, bis du den Verursacher eingegrenzt hast
Welt funktioniert ohne, aber nicht mit Mods	Falsche Abhängigkeit, Version oder Ausführungsseite	Prüfe in der Mod DB die Registerkarte „Dateien“, die Abhängigkeiten und die Anforderungen für Client und Server
Modifizierter Server behält eine alte Datei	Zwischengespeicherte serverspezifische Mod hat denselben Dateinamen	Verlasse den Server, lösche dessen Ordner unter `ModsByServer` und verbinde dich erneut, damit der Serversatz neu heruntergeladen wird

Führe Konflikttests in einer neuen Welt oder einer Kopie durch. Wenn du Inhalts-Mods in der einzigen Kopie einer wertvollen Welt wiederholt aktivierst und deaktivierst, können Daten entfernt oder neu zugeordnet werden. Das erschwert zusätzlich die Suche nach der ursprünglichen Ursache.

Mods im Mehrspieler

Aktuelle Vintage-Story-Clients erstellen beim Beitritt zu einem modifizierten Server einen serverspezifischen Ordner unter ModsByServer. Vom Server bereitgestellte serverseitige oder universelle Mods können so für genau diesen Server heruntergeladen werden, ohne sie mit dem normalen Mods-Ordner des Einzelspielers zu vermischen. Je nach Mod und Serverregeln müssen reine Client-Mods weiterhin manuell installiert werden.

Serverbetreiber sollten Server, Mods und verbundene Clients auf kompatiblen Versionen halten. Nimm Änderungen an Mods nur bei abgeschaltetem Server vor, sichere zuerst die Welt und teste die vollständige Zusammenstellung lokal, bevor du einen öffentlichen Server wieder öffnest. Im Mehrspieler-Leitfaden findest du weitere Informationen zu Datenpfaden, Ports und sicheren Updates.

Häufig gestellte Fragen

Muss ich eine Mod für Vintage Story entpacken?

Normalerweise nicht. Laut offizieller Installationsanleitung werden die meisten Mods als .zip-Dateien heruntergeladen und direkt im Mods-Ordner abgelegt.

Kann eine Mod für eine ältere Version mit 1.22.5 funktionieren?

Möglicherweise, aber du solltest nicht raten. Nutze die Kompatibilitätsangaben auf der Registerkarte „Dateien“ und die Hinweise des Autors.

Warum werden Essentials, Survival und Creative Mode als Mods aufgeführt?

Vintage Story baut auch das Standardspiel mit seinem eigenen Mod-System auf. Diese drei Einträge bilden das unveränderte Grundspiel und sollten normalerweise aktiviert bleiben.

Wie finde ich die Mod, die einen Absturz verursacht?

Erstelle einen zuverlässig wiederholbaren Test in einer neuen Welt oder einer Kopie des Spielstands. Deaktiviere die Hälfte aller Nicht-Standard-Mods und halbiere die verdächtige Gruppe immer weiter. Diese binäre Suche ist deutlich schneller, als eine lange Liste planlos einzeln durchzuprobieren.

Mods für Vintage Story installieren

Sichern, Paket behalten, Konflikt eingrenzen

Welt sichern

.zip behalten

Eingrenzen