Offizielle Quelle
Prüfe xivdev/Penumbra und das zugehörige README.
FFXIV Runtime-Mod-Guide
Penumbra FF14 Guide: Installieren, Einrichten und Fehler beheben
Penumbra ist ein Dalamud-Plugin, das unterstützte FFXIV-Mod-Dateien zur Laufzeit lädt, ohne die originalen Spieldateien zu ersetzen. Die sauberere und sicherere Einrichtung erfolgt über die vom Projekt dokumentierte Methode mit dem benutzerdefinierten Plugin-Repository, nicht durch manuelles Entpacken einer Release-ZIP.
Kurzantwort: über Dalamud installieren, nicht per ZIP-Datei
Öffne XIVLauncher, starte das Spiel, führe /xlsettings aus und trage im Bereich für Experimental custom plugin repositories die offizielle Penumbra repo.json URL ein. Installiere Penumbra anschließend über /xlplugins, damit Dalamud Updates verwalten kann.
Das offizielle README warnt ausdrücklich davor, eine Release-ZIP manuell in devPlugins zu entpacken. Solche manuellen Kopien erhalten unter Umständen keine Update-Hinweise und können mit der über das Repository verwalteten Installation kollidieren.
Aktualitätsprüfung vom 22. Juli 2026: Das neueste GitHub-Release ist testing_1.7.0.2, veröffentlicht am 20. Juli 2026. Dieser Guide bietet die ZIP bewusst nicht als Download-CTA an, weil das gepflegte README die Repository-Methode empfiehlt.
FFXIV Runtime-Mod-Guide
So erkennst du das offizielle Penumbra-Projekt
Dies ist das Icon aus dem Repository xivdev/Penumbra. Prüfe Repository-Inhaber, README, Issue-Tracker und repo.json-Adresse immer gemeinsam, statt einer ähnlich benannten Datei- oder Download-Seite zu vertrauen.
Penumbra ist Community-Software und keine offizielle Funktion von Square Enix. Der Runtime-Ansatz verhindert ein dauerhaftes Überschreiben der Spielarchive, beseitigt aber keine Risiken in Bezug auf Kontorichtlinien, Datenschutz, Kompatibilität oder die Herkunft von Mods.
So installierst du Penumbra in FFXIV
- Mit offiziellem XIVLauncher und Dalamud beginnen. Installiere XIVLauncher von der Goatcorp-Release-Seite, starte FFXIV und prüfe, ob /xlplugins den Dalamud Plugin Installer öffnet.
- Dalamud-Einstellungen öffnen. Führe /xlsettings aus und öffne den Tab Experimental. Ändere dort keine experimentellen Optionen, die mit Penumbra nichts zu tun haben.
- Die offizielle Repository-URL eintragen. Füge https://raw.githubusercontent.com/xivdev/Penumbra/master/repo.json in die Liste der custom plugin repositories ein, nutze die Plus-Schaltfläche und speichere dann die Änderung.
- Über Available Plugins installieren. Öffne /xlplugins, suche Penumbra unter Available Plugins, prüfe den Eintrag und installiere es über den Plugin-Manager.
- Einen eigenen Mod-Ordner wählen. Nutze einen Ordner außerhalb geschützter Windows- oder FFXIV-Programmverzeichnisse. Achte auf genügend freien Speicherplatz und verweise Penumbra nicht auf den Spielinstallationsordner.
- Mods einzeln testen. Importiere zunächst nur einen vertrauenswürdigen Mod, aktiviere ihn für eine begrenzte Collection, wechsle das Gebiet oder öffne das betroffene Fenster neu und prüfe das Ergebnis, bevor du weitere Mods hinzufügst.
Unterstützter Installationsablauf
Der Weg über das Repository macht Herkunft, Updates und ein mögliches Rollback nachvollziehbarer als ein manuell kopierter Plugin-Ordner.
Dalamud-Repo
Füge die offizielle repo.json in /xlsettings hinzu.
Plugin-Manager
Installiere und aktualisiere über /xlplugins.
Kontrollierter Test
Aktiviere einen vertrauenswürdigen Mod und prüfe penumbra konflikte.
XIVLauncher + Dalamud + Penumbra
Wo Penumbra im Start-Stack einzuordnen ist
XIVLauncher startet FFXIV und initialisiert Dalamud; Penumbra wird danach als Dalamud-Plugin installiert und verwaltet. Für die unterstützte Penumbra-Einrichtung brauchst du keinen separaten Launcher, kein Injector-Bundle und keine modifizierte Spiel-EXE.
Der Screenshot ist offizielles Goatcorp-Material zu XIVLauncher und kein Bild der Penumbra-Einstellungen. Er zeigt die für Nutzer sichtbare Launcher-Ebene, damit Penumbra nicht mit einem eigenständigen Spielclient verwechselt wird.
Häufige Penumbra-Probleme und der erste sichere Check
| Problem | Wahrscheinliche Ursache | Erster Check |
|---|---|---|
| Penumbra fehlt in /xlplugins | Die Repository-URL wurde nicht gespeichert oder Dalamud hat noch nicht aktualisiert | /xlsettings erneut öffnen, die exakte repo.json URL prüfen, speichern und die Plugin-Liste aktualisieren |
| Plugins sind nach einem Spielupdate nicht verfügbar | Die Dalamud-Kompatibilität ist für den neuen FFXIV-Build vorübergehend gesperrt | Auf gepflegte Updates warten; keine alten Plugin-Binaries gewaltsam ins Spiel einbinden |
| Ein Mod erscheint nicht | Collection-Zuweisung, Priorität oder Dateipfad passt nicht zum aktuellen Charakter | Die aktive Collection prüfen und vor einer Neuinstallation die Penumbra-Konfliktwerkzeuge verwenden |
| Texturen oder Modelle wirken vermischt | Zwei aktive Mods ersetzen dieselben Dateien | Konflikte prüfen und den gewünschten Mod in der Priorität weiter nach oben setzen |
| Lange Ladezeiten oder hoher Speicherverbrauch | Zu große Mod-Bibliothek, gewachsener Cache oder langsamer Datenträger | Neu hinzugefügte Mods deaktivieren, Cache-Pfade prüfen und den Mod-Ordner auf gesundem lokalem Speicher halten |
| Doppeltes Plugin-Verhalten | Eine manuelle devPlugins-Kopie kollidiert mit der Repository-Installation | Die manuelle Kopie entfernen und nur die Installation über den Plugin-Manager behalten |
Fehler beheben, ohne die Spielinstallation zu beschädigen
Deaktiviere zuerst den zuletzt hinzugefügten Mod und teste dann mit demselben Charakter, derselben Collection, derselben Zone und demselben Ausrüstungszustand. Wenn du mehrere Variablen gleichzeitig änderst, lassen sich penumbra konflikte schwerer eingrenzen.
Lösche keine FFXIV-Archive, ersetze keine Spiel-EXE, deaktiviere Antivirus nicht global und lade keine neu gepackten Plugin-Bundles herunter. Penumbra ist darauf ausgelegt, Mod-Dateien getrennt von der Originalinstallation zu halten; diese Trennung sollte bestehen bleiben.
Nach einem größeren FFXIV-Patch können Dalamud und Plugins vorübergehend nicht verfügbar sein, bis die Kompatibilitätsarbeit abgeschlossen ist. Eine temporäre Nichtverfügbarkeit ist kein Beleg dafür, dass deine Installation defekt ist. Prüfe die gepflegten Projektkanäle und warte, statt alte Builds zu erzwingen.
Grenzen bei Konto, Inhalten und Datenschutz
XIVLauncher, Dalamud, Penumbra und Mods sind Tools von Drittanbietern. Square Enix bietet dafür keinen Support, und kein Guide kann Kontosicherheit garantieren. Wenn du den risikoärmsten Weg brauchst, verwende den offiziellen Spielclient.
Importiere Mod-Dateien nur aus Quellen, die du nachvollziehen kannst. Meide Archive mit ausführbaren Dateien, Anmeldedaten-Abfragen, weitreichenden Sicherheitsausnahmen oder unklarer Herkunft. Respektiere die Rechte von Creator:innen und nutze visuelle Änderungen nicht, um offizielle Inhalte nachzuahmen.
Ist Penumbra dasselbe wie Dalamud?
Nein. Dalamud ist das Plugin-Framework, das über XIVLauncher geladen wird; Penumbra ist ein einzelnes Plugin, das Mod-Ersetzungen zur Laufzeit verwaltet.
Sollte ich Penumbra.zip aus den GitHub Releases herunterladen?
Nicht für die normale Einrichtung. Das offizielle README empfiehlt, die repo.json URL hinzuzufügen und über Dalamud zu installieren, damit Updates automatisch verwaltet werden.
Warum sind FFXIV-Plugins nach einem Spielupdate nicht verfügbar?
Dalamud kann Plugins vorübergehend deaktivieren, während die Kompatibilität geprüft wird. Warte auf gepflegte Updates und erzwinge keine ältere Binary.
Wo sollte der Penumbra-Mod-Ordner liegen?
Nutze einen eigenen beschreibbaren Ordner außerhalb der FFXIV-Installation und geschützter Systemordner, auf lokalem Speicher mit genügend freiem Platz.
Wie behebe ich es, wenn zwei Mods dieselbe Datei ändern?
Nutze die Penumbra-Konfliktinformationen und die Collection-Prioritäten. Lass nur die gewünschte Ersetzung aktiv oder verschiebe sie über den konkurrierenden Mod.
Ist Penumbra sicher?
Es ist offene Community-Software mit offiziellem Repository, bleibt aber Drittanbieter-Software, und Mod-Dateien bringen eigene Risiken bei Quelle, Datenschutz, Kompatibilität und Kontorichtlinien mit.