Guida alle fonti dei plugin Dalamud

Come aggiungere in sicurezza un repository personalizzato di plugin Dalamud

Usa l'URL esatto pubblicato dall'autore del plugin, verifica chi gestisce la fonte e poi aggiungila e attivala nelle impostazioni di Dalamud. La presenza di una voce nell'installer di gioco non certifica l'autore, il comportamento o la compatibilità del plugin e non equivale a un'approvazione di Square Enix.

Risposta rapida

Avvia FFXIV con XIVLauncher e attendi che Dalamud sia caricato. Nella chat digita /xlsettings, apri la sezione Experimental e cerca Custom Plugin Repositories. Incolla l'URL esatto del manifest indicato nella documentazione aggiornata dell'autore, usa il comando per aggiungerlo, controlla che la fonte sia attiva e salva. Poi apri /xlplugins, cerca il plugin per nome, leggi le note e installalo da quella finestra.

Se non riesci a verificare chi possiede l'URL o perché il plugin richiede una fonte separata, fermati prima di aggiungerla. Non sostituire il flusso di installazione interno al gioco con un file DLL scaricato o con un URL copiato da un commento non pertinente.

Un giocatore confronta una fonte indipendente dell'autore del plugin con una directory gestita dal progetto prima di installare.
Illustrazione concettuale: verificare chi gestisce una fonte non ne certifica sicurezza o compatibilità.

Illustrazione concettuale

Una fonte personalizzata ha un proprio autore

Un repository è una fonte di pubblicazione che comunica a Dalamud quali plugin e informazioni sulle versioni rende disponibili un autore. Può essere gestito da un singolo sviluppatore o da un progetto della community. È distinto dalla directory predefinita gestita nell'ambito del progetto Dalamud, anche se entrambe le fonti compaiono nello stesso installer.

L'immagine è un'illustrazione editoriale, non una schermata ufficiale di XIVLauncher. Il controllo concreto consiste nel verificare l'identità dell'autore e l'URL esatto nelle sue istruzioni aggiornate. Un nome noto, una pagina curata o una voce in elenco non costituiscono una verifica di sicurezza.

Repository personalizzato, directory predefinita o build di prova?

Scegli il percorso descritto dall'autore. La maggior parte dei giocatori dovrebbe iniziare cercando nella directory predefinita di /xlplugins. Un repository personalizzato serve quando un autore specifico documenta una fonte aggiuntiva. Le build sperimentali sono un percorso diverso e non equivalgono all'aggiunta di un repository. Una build locale è destinata allo sviluppo di plugin, non all'installazione di tutti i giorni. In questa guida, «repository personalizzato di plugin Dalamud» indica la fonte aggiuntiva documentata da un autore, distinta dalla directory predefinita.

Scegli la fonte prima di modificare le impostazioni

Fonte Significato Primo controllo
Directory predefinita L'elenco normale nel gioco pubblicato attraverso il flusso del progetto Dalamud. Cerca in /xlplugins e leggi le note aggiornate del plugin.
Repository personalizzato Una fonte aggiuntiva gestita da un autore o da un progetto della community. Verifica il proprietario e l'URL esatto del manifest nella documentazione attuale.
Build sperimentale Una versione o un canale di prova che può essere incompleto o instabile. Attiva solo l'opzione di test documentata per uno scopo preciso.
File del plugin scaricato Un file ottenuto al di fuori del normale percorso dell'installer. Non usare un mirror DLL sconosciuto come scorciatoia per configurare un repository.

Verifica l'autore prima di aggiungere l'URL

L'URL di un repository personalizzato è un dato fornito da terzi. Verifica la fonte prima di aprire le impostazioni, tenendo a portata di mano la documentazione dell'autore.

Questo controllo breve aiuta a individuare incongruenze; riduce errori evitabili ma non dimostra che un software sia innocuo.

  • Trova l'URL nella documentazione aggiornata dell'autore o nella pagina delle pubblicazioni del proprietario del repository, non in una ripubblicazione senza attribuzione.
  • Confronta nome dell'autore, nome del progetto e proprietario del repository tra le istruzioni e la pagina della fonte. Fermati se nomi o domini non corrispondono.
  • Copia l'URL completo esattamente. Non correggere un collegamento non funzionante indovinando un nome file, cambiando dominio o rimuovendo una parte del percorso.
  • Leggi cosa fa il plugin, quali dati o funzioni locali usa, quali dipendenze richiede e quali note di compatibilità ha pubblicato l'autore.
  • Controlla se il progetto è ancora mantenuto e dove segnala i problemi. Un repository può essere obsoleto anche se l'URL continua a rispondere.
  • Annota la fonte e il plugin aggiunto, così potrai riconoscere la modifica se l'elenco diventa difficile da interpretare.

Aggiungi un repository personalizzato e installa un plugin

  1. 1. Verifica che Dalamud sia in esecuzione. Avvia FFXIV con la configurazione XIVLauncher che usi normalmente. Entra nel gioco e attendi che l'interfaccia di Dalamud abbia terminato il caricamento prima di provare /xlsettings. Se il comando non è disponibile, verifica prima l'avvio del launcher o di Dalamud.
  2. 2. Apri la sezione delle impostazioni indicata. Digita /xlsettings nella chat e seleziona Experimental. Cerca il campo Custom Plugin Repositories. Le etichette possono cambiare, quindi segui l'interfaccia corrente e le istruzioni dell'autore invece di basarti su uno screenshot datato.
  3. 3. Aggiungi e attiva l'URL dell'autore. Incolla l'URL che hai verificato, usa il comando di aggiunta vicino al campo e conferma che la nuova fonte sia attiva. Se la finestra segnala un indirizzo non valido o un avviso che non comprendi, non aggirarlo usando un altro mirror.
  4. 4. Salva e trova il plugin desiderato. Salva e chiudi le impostazioni, poi apri /xlplugins. Cerca il nome esatto indicato dall'autore. Controlla autore, descrizione, dipendenze e note di compatibilità prima di scegliere Install.
  5. 5. Fai una sola modifica e osserva il risultato. Installa solo il plugin previsto e segui eventuali istruzioni di riavvio di Dalamud o del suo autore. Annota cosa è cambiato. Se compare un altro problema, saprai quale fonte e quale plugin erano coinvolti.
Un flusso concettuale in quattro parti verifica un autore, aggiunge un collegamento, attiva la fonte e installa un plugin.
Flusso concettuale: i simboli mostrano l'ordine, non un'interfaccia ufficiale o una certificazione di sicurezza.

Sequenza di configurazione

Mantieni il flusso breve e reversibile

La sequenza utile è verificare l'autore, copiare l'URL esatto, attivare la fonte, controllare il plugin e installarne uno solo. Ogni passaggio risponde a una domanda diversa: chi pubblica la fonte, se l'indirizzo è quello giusto, se Dalamud riesce a leggerlo e se il plugin soddisfa la tua necessità.

Se il plugin non compare dopo il salvataggio, non aggiungere più URL inventati. Controlla prima lo stato della fonte e le istruzioni aggiornate, poi consulta i casi di risoluzione dei problemi qui sotto.

Disattiva una fonte e disinstalla un plugin separatamente

Se non vuoi più usare un repository, riapri /xlsettings e torna all'elenco delle fonti personalizzate. Usa i comandi attuali per disattivare o rimuovere la fonte e salva. Rimuoverla cambia dove Dalamud cerca le voci; non disinstalla necessariamente un plugin già installato da quella fonte.

Apri /xlplugins e controlla separatamente i plugin installati. Se non vuoi più usarne uno, utilizza il comando di disinstallazione o disattivazione dell'installer. Segui le note aggiornate dell'autore se il plugin salva configurazioni o richiede un riavvio. Non eliminare cartelle a caso né rimuovere per prima cosa i dati di altri plugin.

Se vuoi solo capire se la fonte ha causato un problema, disattiva una fonte o un plugin alla volta e annota il risultato. Una modifica piccola e reversibile fornisce indizi più chiari che rimuovere tutti i plugin o reimpostare l'intero launcher.

Se il repository o il plugin non compare

Cosa vedi Primo controllo Passaggio successivo
L'URL viene rifiutato Confrontalo carattere per carattere con le istruzioni aggiornate dell'autore. Chiedi l'indirizzo attuale al maintainer; non indovinarne uno sostitutivo.
La fonte è presente ma disattivata Controlla il suo stato in /xlsettings. Attiva solo la fonte verificata, salva e riapri /xlplugins.
La fonte è attiva ma vuota Verifica lo stato, la connessione di rete e gli avvisi aggiornati dell'autore. Attendi o contatta il maintainer se il manifest o il servizio non è disponibile.
Manca un plugin Cerca il nome esatto e confronta le note di rilascio aggiornate dell'autore. Conferma che il plugin usi ancora questo repository e supporti la tua configurazione.
Il plugin non si carica Controlla compatibilità, dipendenze e il primo errore segnalato. Disattiva il plugin e segui le istruzioni aggiornate prima di reinstallarlo.
La directory di plugin gestita dal progetto e un repository di un autore indipendente sono rappresentati come fonti separate per l'installer di gioco.
Illustrazione concettuale: due autori possono pubblicare nello stesso installer senza condividere controlli o approvazione.

Confine tra le fonti

Un installer condiviso non significa un autore condiviso

La directory predefinita e un repository indipendente possono entrambi fornire voci all'installer nel gioco, ma non devono per forza condividere proprietario, controlli, pratiche di rilascio o assistenza. Tieni associato il nome dell'autore alla fonte che stai valutando.

Questa illustrazione mostra percorsi di pubblicazione distinti che convergono in un solo installer. Non è una classifica, un'approvazione o l'affermazione che sia stato svolto un audit di sicurezza. La directory ufficiale Dalamud indica che i plugin si installano nel gioco; non scaricare manualmente i file del plugin solo perché esiste un repository.

Limiti, privacy e considerazioni sull'account

Aggiungere una fonte rende semplicemente reperibili le sue voci. Non dimostra che un plugin sia sicuro, compatibile con la versione attuale del gioco, mantenuto o approvato dal produttore del gioco. Prima di installarlo, esamina il proprietario del progetto, la documentazione, il comportamento del plugin, i permessi o i dati descritti dall'autore e le note di compatibilità aggiornate.

Segui le istruzioni ufficiali del progetto per il metodo di installazione supportato e consulta autonomamente le regole attuali del gioco e del servizio. Una pagina di repository, un'etichetta open source o un'installazione riuscita non sono un'autorizzazione di Square Enix e non garantiscono nulla per il tuo account. Non condividere mai password, codici monouso o registri non oscurati quando chiedi aiuto per un plugin di terzi.

Che cos'è un repository personalizzato di plugin Dalamud?

È una fonte di plugin aggiuntiva gestita da un autore o da un progetto della community. Dalamud può mostrarne le voci accanto alla directory predefinita, ma ogni fonte ha un proprio autore e proprie procedure di controllo.

Dove si aggiunge l'URL di un repository personalizzato?

Nel gioco apri /xlsettings, seleziona Experimental e usa Custom Plugin Repositories. Incolla l'indirizzo esatto dell'autore, aggiungi e attiva la fonte, salva e poi cerca il plugin in /xlplugins.

Posso usare qualsiasi URL di repository trovato online?

No. Verifica il proprietario del progetto e l'URL attuale nella documentazione del maintainer. Non incollare collegamenti senza attribuzione né indovinare l'indirizzo del manifest dal nome di un file.

La presenza in /xlplugins significa che il plugin è sicuro o ufficiale?

No. Significa che l'installer riesce a leggere una voce da quella fonte. Non è un audit di sicurezza, una garanzia di compatibilità o un'approvazione di Dalamud o Square Enix.

Rimuovere un repository disinstalla i suoi plugin?

Non necessariamente. Rimuovi o disattiva la fonte in /xlsettings, poi controlla separatamente in /xlplugins i plugin già installati e disinstallali o disattivali se serve.

Perché il mio repository personalizzato è vuoto o non disponibile?

L'URL potrebbe essere obsoleto, il manifest dell'autore fuori servizio, la fonte disattivata o il plugin spostato. Controlla le istruzioni e lo stato aggiornati prima di cambiare l'indirizzo.