Aggiorna LuckPerms con il file per la piattaforma su cui il plugin gira davvero. Un download Velocity non va installato su un server Paper. Prima salva i dati dei permessi e la configurazione, poi dopo l'aggiornamento verifica con un normale account giocatore che gruppi e permessi funzionino ancora come prima.
Verificare piattaforma e posizione
Per prima cosa annota dove è installato LuckPerms: sul server Minecraft, sul proxy o su più componenti. Controlla nel log la piattaforma avviata e la versione. Non fidarti solo del nome file di una JAR caricata in qualche momento.
Poi controlla il sistema di salvataggio configurato per i permessi. Se usi un database esterno, i dati effettivi non si trovano necessariamente nella cartella del plugin. Un semplice backup dei file di quella cartella può quindi essere incompleto. Tratta le credenziali presenti nella configurazione come dati riservati e non inserirle in segnalazioni di errore pubbliche.
Backup prima della sostituzione
Salva il file plugin attuale, la configurazione e l'insieme di dati dei permessi realmente usato. Per i dati usa una procedura di esportazione o backup database adatta e verifica di poter rileggere il backup. Annota l'orario e quali server o proxy usano lo stesso insieme di dati.
Per un piccolo test bastano esempi documentati in anticipo: un giocatore normale senza permessi speciali, un membro di un gruppo nominato e un account con un permesso aggiuntivo mirato. Annota il comportamento atteso. Per il test non assegnare permessi wildcard globali né permessi OP generici; così nasconderesti eventuali errori nei permessi.
Aggiornamento in una finestra di manutenzione
- Scegli il download per la tua piattaforma effettiva dalla pagina ufficiale di LuckPerms.
- Controlla i requisiti indicati e le note sul passaggio dalla tua versione attuale.
- Arresta correttamente il componente server o proxy interessato.
- Sostituisci il file del plugin; lascia invariati configurazione e sistema di salvataggio dei dati, a meno che la guida di aggiornamento specifica non richieda una migrazione.
- Avvia il componente e controlla nel log eventuali errori di caricamento e salvataggio.
- Testa i casi di permessi documentati in precedenza.
Se usi più componenti, aggiornali in modo controllato e documenta le rispettive versioni. Non dedurre da una nuova build del proxy un'istruzione di aggiornamento generica per tutti i server Minecraft.
Verificare il risultato
Non testare solo con il tuo account amministratore. Controlla con un giocatore normale se i comandi consentiti funzionano ancora e se le azioni vietate vengono ancora rifiutate. Se usi permessi diversi per server o mondo, ripeti il test esattamente in quei contesti.
Un avvio senza errori visibili non basta: il server può essere raggiungibile mentre una connessione al database o una regola di permessi si comporta diversamente dal previsto. Annota piattaforma, versione del plugin, risultato del test ed eventualmente il primo messaggio di errore rilevante.
Percorso di ripristino sicuro
Se noti permessi inattesi, interrompi ulteriori modifiche amministrative e controlla prima il file della piattaforma e il collegamento allo storage. Usa i dati salvati per un test di ripristino controllato. Non ripristinare alla cieca uno stato precedente del database se nel frattempo altri server hanno scritto modifiche corrette nello stesso insieme di dati.
FAQ
Il file pubblicato più di recente è sempre quello giusto? No. Piattaforma, requisiti e note di rilascio specifiche devono corrispondere.
La cartella del plugin basta come backup? Solo se contiene anche l'intero insieme di dati realmente utilizzato. Controlla il collegamento allo storage.
Devo ricreare i permessi dopo ogni aggiornamento? Un aggiornamento regolare non è un motivo per ricostruire preventivamente i tuoi gruppi. Controlla prima dati e messaggi di errore.