Fonte ufficiale
Verifica xivdev/Penumbra e il relativo README.
Guida alle mod runtime di FFXIV
Guida a Penumbra FFXIV: installazione, configurazione e risoluzione dei problemi
Penumbra è un plugin di Dalamud che carica file mod compatibili di FFXIV in runtime senza sostituire i file originali del gioco. La procedura più sicura è usare il metodo del repository personalizzato documentato dal progetto, non estrarre manualmente un archivio ZIP di release.
Risposta rapida: installa tramite Dalamud, non con un file ZIP
Apri XIVLauncher, entra nel gioco, esegui /xlsettings e aggiungi l'URL repo.json ufficiale di Penumbra nella sezione Experimental custom plugin repositories. Poi installa Penumbra da /xlplugins, così Dalamud potrà gestire gli aggiornamenti.
Il README ufficiale avvisa esplicitamente di non estrarre manualmente uno ZIP di release dentro devPlugins. Le copie manuali possono non ricevere le notifiche di aggiornamento e andare in conflitto con l'installazione gestita dal repository.
Verifica di aggiornamento al 22 luglio 2026: l'ultima release su GitHub è testing_1.7.0.2, pubblicata il 20 luglio 2026. Questa guida non propone lo ZIP come download CTA perché il README mantenuto consiglia il metodo tramite repository.
Guida alle mod runtime di FFXIV
Come riconoscere il progetto ufficiale di Penumbra
Questa è l'icona conservata nel repository xivdev/Penumbra. Per verificare il progetto, controlla insieme il proprietario del repository, il README, l'issue tracker e l'indirizzo repo.json, invece di fidarti di un host di file con un nome simile.
Penumbra è un software della community, non una funzione ufficiale di Square Enix. Il suo approccio runtime evita di sovrascrivere in modo permanente gli archivi del gioco, ma non elimina i rischi legati a policy dell'account, privacy, compatibilità o provenienza delle mod.
Come installare Penumbra in FFXIV
- Parti da XIVLauncher e Dalamud ufficiali. Installa XIVLauncher dalla pagina release di Goatcorp, avvia FFXIV e verifica che /xlplugins apra il Dalamud Plugin Installer.
- Apri le impostazioni di Dalamud. Esegui /xlsettings e apri la scheda Experimental. Evita di modificare opzioni sperimentali non correlate.
- Aggiungi l'URL del repository ufficiale. Incolla https://raw.githubusercontent.com/xivdev/Penumbra/master/repo.json nell'elenco dei custom plugin repositories, usa il pulsante più, poi salva e chiudi.
- Installa da Available Plugins. Apri /xlplugins, trova Penumbra in Available Plugins, controlla la scheda del plugin e installalo dal gestore plugin.
- Scegli una cartella mod dedicata. Usa una cartella esterna alle directory protette di Windows o ai percorsi del programma FFXIV. Lascia spazio libero sufficiente e non puntare Penumbra alla cartella di installazione del gioco.
- Prova una mod alla volta. Importa una sola mod affidabile, attivala per una raccolta limitata, cambia zona oppure riapri la finestra interessata e verifica il risultato prima di aggiungerne altre.
Flusso di installazione supportato
Il percorso tramite repository rende più chiari gestione, aggiornamenti e rollback rispetto a una cartella plugin copiata manualmente.
Repository Dalamud
Aggiungi il repo.json ufficiale in /xlsettings.
Gestore plugin
Installa e aggiorna tramite /xlplugins.
Test controllato
Attiva una mod affidabile e controlla gli eventuali conflitti.
XIVLauncher + Dalamud + Penumbra
Dove si colloca Penumbra nella catena di avvio
XIVLauncher avvia FFXIV e inizializza Dalamud; Penumbra viene poi installato e gestito come plugin di Dalamud. Non ti serve un launcher separato, un pacchetto injector dedicato o un eseguibile di gioco modificato per usare la configurazione supportata di Penumbra.
Lo screenshot è un contenuto ufficiale di Goatcorp per XIVLauncher, non una schermata delle impostazioni di Penumbra. Serve a mostrare il livello del launcher visibile all'utente, così i lettori non confondono il plugin con un client di gioco standalone.
Problemi comuni di Penumbra e primo controllo sicuro
| Problema | Causa probabile | Primo controllo |
|---|---|---|
| Penumbra non compare in /xlplugins | L'URL del repository non è stato salvato oppure Dalamud non si è ancora aggiornato | Riapri /xlsettings, verifica l'URL repo.json esatto, salva e aggiorna l'elenco dei plugin |
| Plugin non disponibili dopo un aggiornamento del gioco | La compatibilità di Dalamud è temporaneamente bloccata per la nuova build di FFXIV | Attendi gli aggiornamenti mantenuti; non forzare vecchi binari dei plugin nel gioco |
| Una mod non appare | L'assegnazione della raccolta, la priorità o il percorso file non corrispondono al personaggio attuale | Controlla la raccolta attiva e usa gli strumenti di conflitto di Penumbra prima di reinstallare |
| Texture o modelli appaiono mescolati | Due mod attive sostituiscono gli stessi file | Controlla i conflitti e sposta più in alto nella priorità la mod che vuoi usare |
| Caricamenti lunghi o uso eccessivo del disco | Libreria mod troppo grande, crescita della cache o archiviazione lenta | Disattiva le aggiunte recenti, controlla i percorsi della cache e tieni la cartella mod su un'unità locale affidabile |
| Comportamento duplicato del plugin | Una copia manuale in devPlugins entra in conflitto con l'installazione dal repository | Rimuovi la copia manuale e mantieni solo l'installazione tramite gestore plugin |
Risolvi i problemi senza danneggiare l'installazione del gioco
Disattiva prima la mod aggiunta più di recente, poi prova con lo stesso personaggio, la stessa raccolta, la stessa zona e lo stesso equipaggiamento. Cambiare più variabili insieme rende più difficile isolare un conflitto.
Non eliminare gli archivi di FFXIV, non sostituire gli eseguibili del gioco, non disattivare l'antivirus a livello globale e non scaricare pacchetti di plugin ripacchettizzati. Penumbra è progettato per tenere i file mod separati dall'installazione originale; mantieni questo confine.
Dopo una patch importante di FFXIV, Dalamud e i plugin possono restare temporaneamente non disponibili finché il lavoro di compatibilità non è completato. Un messaggio di indisponibilità temporanea non prova che la tua installazione sia danneggiata. Controlla i canali ufficialmente mantenuti e aspetta, invece di forzare build vecchie.
Confini tra account, contenuti e privacy
XIVLauncher, Dalamud, Penumbra e le mod sono strumenti di terze parti. Square Enix non fornisce supporto per questi strumenti e nessuna guida può garantire la sicurezza dell'account. Usa il client ufficiale del gioco se vuoi il percorso a rischio più basso.
Importa solo file mod da fonti che conosci. Evita archivi che includono eseguibili, richieste di credenziali, esclusioni di sicurezza troppo ampie o proprietà poco chiara. Rispetta i permessi dei creatori e non usare modifiche visive per imitare contenuti ufficiali.
Penumbra è la stessa cosa di Dalamud?
No. Dalamud è il framework per plugin caricato tramite XIVLauncher; Penumbra è uno dei plugin che gestisce la sostituzione runtime delle mod.
Devo scaricare Penumbra.zip da GitHub Releases?
No, non per la configurazione standard. Il README ufficiale consiglia di aggiungere l'URL repo.json e installare tramite Dalamud, così gli aggiornamenti vengono gestiti automaticamente.
Perché i plugin di FFXIV non sono disponibili dopo un aggiornamento del gioco?
Dalamud può disattivare temporaneamente i plugin mentre viene verificata la compatibilità. Aspetta gli aggiornamenti mantenuti ed evita di forzare un binario precedente.
Dove dovrebbe trovarsi la cartella mod di Penumbra?
Usa una cartella dedicata e scrivibile fuori dall'installazione di FFXIV e dalle cartelle di sistema protette, su un'unità locale con spazio libero sufficiente.
Come risolvo il problema di due mod che cambiano lo stesso file?
Usa le informazioni sui conflitti di Penumbra e le priorità delle raccolte. Lascia attiva solo la sostituzione desiderata oppure spostala sopra la mod concorrente.
Penumbra è sicuro?
È un software open della community con un repository ufficiale, ma resta comunque di terze parti e i file mod introducono rischi separati legati a provenienza, privacy, compatibilità e policy dell'account.