I plugin salvano di solito le loro impostazioni in file YAML nella cartella plugins/<Plugin>/. YAML è un formato di testo che definisce la propria struttura tramite l'indentazione con gli spazi. Basta un tabulatore o una virgoletta mancante perché un plugin non riesca più a leggere un file. Ogni sezione qui sotto tratta un messaggio. Se arrivi qui da «Scopri di più» nella sezione Salute del server, sei già nel posto giusto.

Il testo completo si trova nella Console oppure in File, in logs/latest.log. Indica quasi sempre il file e spesso anche la riga e la colonna. Sotto compare spesso uno stack trace, un elenco di righe at indentate che mostra in quale punto del programma si è verificato l'errore. Prima di modificare file di configurazione o del mondo, crea un backup in Backup. È meglio modificare i file a server fermo, perché alcuni plugin sovrascrivono la propria configurazione durante lo spegnimento.

Errore di sintassi YAML in un file di un plugin

Ecco come appare il messaggio:

Cannot load plugins/<Plugin>/<Datei>.yml
Cannot load configuration from stream
could not find expected ':'

Cosa c'è dietro: il plugin non riesce a leggere la propria configurazione YAML; YAML è un formato di testo la cui struttura dipende dall'indentazione. while parsing a block mapping e expected <block end> indicano una struttura errata, mentre sequence entries are not allowed here segnala una voce di elenco nella posizione sbagliata. Con could not find expected ':' potrebbero mancare i due punti tra chiave e valore oppure lo spazio che li segue. A seconda del plugin, possono mancare alcune impostazioni o l'intero plugin.

Come risolvere:

  1. Apri in File il file indicato. In caso di Cannot load configuration from stream, cerca il plugin e la sua configurazione nelle righe di log circostanti.
  2. Controlla la riga segnalata e le voci precedenti. line e column indicano riga e colonna; la causa può trovarsi più in alto.
  3. Usa gli spazi invece dei tabulatori per l'indentazione. Allinea allo stesso modo le voci di pari livello; le voci di elenco con - vanno su righe proprie.
  4. Separa chiavi e valori semplici con due punti e uno spazio, ad esempio admin-only: false. Metti tra virgolette i valori di testo che iniziano con caratteri speciali come &, { o backtick. Chiudi le virgolette e rimuovi eventuali delimitatori Markdown di tre backtick copiati per errore.
  5. Controlla il file con un validatore YAML e riavvia. Rimuovi i valori segreti prima di un controllo online.

«Could not deserialize» o «unknown world»: voce illeggibile in un file di un plugin

Ecco come appare il messaggio:

[org.bukkit.configuration.serialization.ConfigurationSerialization] Could not call method 'public static org.bukkit.Location org.bukkit.Location.deserialize(java.util.Map)' of class org.bukkit.Location for deserialization
java.lang.IllegalArgumentException: unknown world

Cosa c'è dietro: i plugin salvano oggetti (kit, articoli dei negozi, item dei menu) e posizioni (home, warp, punti di spawn) come blocchi di dati nei loro file YAML. A volte un oggetto salvato con una versione precedente di Minecraft non può più essere letto nel formato attuale («Could not deserialize found primitive»). Se sotto il messaggio compaiono Location e unknown world, una posizione salvata punta a un mondo che non esiste più o che non era ancora caricato al momento della lettura. Il server continua a funzionare, mancano solo queste voci.

Come risolvere:

  1. Individua il plugin interessato. Le righe immediatamente prima e dopo il messaggio indicano di solito il plugin o il suo file.
  2. Arresta il server, crea un backup in Backup, apri il file in File e rimuovi o rinnova le voci degli oggetti interessati. Poi riavvia il server.
  3. Ricrea gli oggetti nel gioco, ad esempio il kit o l'articolo del negozio.
  4. In caso di unknown world: elimina o reimposta la posizione con i comandi del plugin. Se il mondo esiste ancora, assicurati che sia caricato.
  5. Dopo il riavvio successivo, controlla la Console.

Buono a sapersi: se hai eliminato o rinominato un mondo, le vecchie home e i vecchi warp puntano a una destinazione inesistente. Il messaggio scompare solo quando queste voci vengono rimosse.

«open_command … already exists»: DeluxeMenus salta un menu

Ecco come appare il messaggio:

[DeluxeMenus] open_command specified for menu: <Menü> already exists for another menu!
Skipping menu: <Menü>

Cosa c'è dietro: in DeluxeMenus ogni menu può avere un proprio comando con cui i giocatori lo aprono. Si trova nel file del menu sotto open_command. Se due file di menu riportano lo stesso comando, DeluxeMenus salta il secondo menu, che non è quindi raggiungibile nel gioco. La riga «Skipping menu» indica il menu saltato. Tutti gli altri menu e il server continuano a funzionare normalmente. La causa più frequente è un file di menu copiato come modello senza modificare il comando.

Come risolvere:

  1. Apri in File la cartella plugins/DeluxeMenus/gui_menus.
  2. Cerca il file del menu saltato e il file che usa lo stesso open_command.
  3. Assegna al menu saltato un comando proprio, non ancora utilizzato.
  4. Salva e ricarica DeluxeMenus con /dm reload, con la barra nel gioco e senza barra nella Console.
  5. Prova ad aprire il menu con il suo nuovo comando.

Buono a sapersi: se un menu viene aperto solo da un altro menu, di solito non ha bisogno di un comando proprio. In tal caso puoi anche omettere open_command in quel file.

«Failed to autoload world …»: Multiverse non carica un mondo

Ecco come appare il messaggio:

[Multiverse-Core] Failed to autoload world '<Welt>': Failure{reason=WORLD_FOLDER_INVALID}
[Multiverse-Core] Failed to import world <Welt>: Failure{reason=WORLD_FOLDER_INVALID}
[Multiverse-Core] Failed to autoload world '<Welt>': Failure{reason=BUKKIT_NAMESPACED_KEY_MISMATCH}: Namespace mismatch detected! …

Cosa c'è dietro: Multiverse-Core gestisce i mondi in plugins/Multiverse-Core/worlds.yml; se manca una cartella del mondo valida, non può caricare il mondo. Con BUKKIT_NAMESPACED_KEY_MISMATCH il mondo è già caricato, ma con un identificatore interno diverso da quello previsto da Multiverse. Anche i mondi Nether/End registrati due volte o i mondi importati ma non caricati (WORLD_EXIST_UNLOADED) causano problemi di caricamento; il server e gli altri mondi continuano a funzionare.

Come risolvere:

  1. In caso di WORLD_FOLDER_INVALID, controlla in File che la cartella del mondo sia completa e corrisponda alla struttura di cartelle del software del tuo server. Ripristina i dati mancanti da un backup.
  2. Se il mondo non esiste più, rimuovi la voce obsoleta con /mv remove <Welt>.
  3. Se esiste ma non è caricato, usa /mv load <Welt>.
  4. In caso di BUKKIT_NAMESPACED_KEY_MISMATCH, confronta i due identificatori nel messaggio. Allinea l'associazione di Multiverse seguendo le istruzioni per la versione del tuo server.
  5. Non registrare anche Nether ed End se il server li carica già tramite server.properties o bukkit.yml.
  6. Riavvia e controlla la Console.

Buono a sapersi: al posto dei vecchi consigli su Chunkster, ripristina i dati dai backup; consulta Dati del mondo danneggiati, obsoleti o non salvabili.

DeluxeMenus: il file del menu non è valido

Ecco come appare il messaggio:

[DeluxeMenus] Detected invalid configuration in file: <Menü>.yml
org.bukkit.configuration.InvalidConfigurationException: while scanning a simple key
 in 'reader', line <Zeile>, column <Spalte>:

Cosa significa: DeluxeMenus non riesce a elaborare il file di menu indicato e non carica quel menu. Con il comando associato i giocatori non vedono alcuna interfaccia, mentre tutti gli altri menu continuano a funzionare. Il motivo esatto è riportato nelle righe subito sotto il messaggio, di solito un errore YAML con riga e colonna. Un caso tipico è lo spazio mancante dopo i due punti, cioè hide_attributes:true invece di hide_attributes: true.

Come risolvere:

  1. Leggi le righe sotto il messaggio e annota riga e colonna.
  2. Apri il file del menu in File, di solito nella cartella plugins/DeluxeMenus/gui_menus.
  3. Correggi il punto indicato: uno spazio dopo ogni due punti, solo spazi per l'indentazione e testi con & o # tra virgolette.
  4. Se non compare alcun errore YAML, confronta le opzioni con la guida di DeluxeMenus, ad esempio i nomi dei materiali o la sintassi delle condizioni.
  5. Ricarica con /dm reload e apri il menu per provarlo.

Buono a sapersi: In YAML un # dopo uno spazio introduce un commento. Senza virgolette il resto della riga va perso, ad esempio con i colori esadecimali.

«FileNotFoundException»: un file del plugin manca o non può essere creato

Ecco come appare il messaggio:

java.io.FileNotFoundException: plugins/DigitalClockRemastered/terrainbackups/<Datei> (No such file or directory)
java.io.FileNotFoundException: plugins/AuctionHouse/auctions.dat (No such file or directory)
java.io.FileNotFoundException: plugins/MagicSpells/spellbooks/<Datei> (No such file or directory)

Cosa significa: Un plugin non riesce a leggere o a creare un file necessario in plugins/. La causa può essere un file eliminato oppure una sottocartella mancante o rinominata; al primo avvio alcuni file di dati non esistono ancora. FileOutputStream o FileWriter nello stack trace sotto l'errore indicano un tentativo di scrittura, che fallisce anche quando manca la cartella superiore. A seconda del plugin, il file viene creato in seguito, una singola funzione smette di funzionare oppure il plugin si disattiva.

Come risolvere:

  1. Riavvia il server una volta e controlla se il messaggio ricompare.
  2. In File controlla l'intero percorso, sottocartelle comprese. I nomi devono corrispondere a quelli del messaggio, anche per maiuscole e minuscole.
  3. Se mancano ancora cartelle di dati o file, arresta il server e ripristinali da un backup in Backup.
  4. Se non basta, salva una copia della cartella del plugin e reinstalla il plugin seguendo la sua guida.

Buono a sapersi: Un file appena creato parte con dati vuoti o valori predefiniti. Puoi recuperare i dati dei giocatori persi da un backup adatto.

Il generatore di mondi impostato non è installato

Ecco come appare il messaggio:

Could not set generator for default world '<Welt>': Plugin '<Plugin>' does not exist

Cosa significa: Un generatore di mondi è il programma che crea nuovi paesaggi. In bukkit.yml o nella configurazione del mondo è impostato per quel mondo un generatore fornito da un plugin, ma questo plugin non è installato o non è stato caricato. Il server crea quindi le nuove aree con il generatore normale. Le zone già esplorate restano invariate, ma ai bordi il paesaggio può proseguire in modo incoerente.

Come risolvere:

  1. In File apri bukkit.yml e cerca la sezione worlds:. Sotto il nome del mondo trovi generator: <Plugin>.
  2. Se vuoi mantenere il generatore, installa il plugin indicato in Plugin in una versione compatibile.
  3. Se non ti serve più, rimuovi la voce generator.
  4. Riavvia il server e controlla nella Console se il messaggio è scomparso.

Buono a sapersi: Il nome dopo generator: deve corrispondere esattamente al nome del plugin. Un errore di battitura causa lo stesso messaggio, anche se il plugin è installato.

«Loading a newer configuration than is supported»: la configurazione è più recente del software

Ecco come appare il messaggio:

Warning: This command deletes or removes game content. Create a backup first and check the command’s target.

[Configurations] Loading a newer configuration than is supported (<Dateiversion> > <unterstützte Version>)! You may have to backup & delete your global config file to start the server.

Cosa significa: La configurazione è stata scritta da una versione più recente di quella ora in esecuzione. Il caso tipico è un downgrade, cioè il passaggio a una versione precedente di un plugin o di Minecraft. Il primo numero tra parentesi è la versione del file, il secondo è la più alta riconosciuta dal programma installato. Le impostazioni più recenti vengono ignorate. Se il messaggio parla di «global config file», proviene da Paper stesso e di solito si riferisce a config/paper-global.yml.

Come risolvere:

  1. Controlla se di recente hai effettuato il downgrade di un plugin o, in Versione, della versione del server.
  2. Prima soluzione: aggiorna di nuovo alla versione compatibile con la configurazione.
  3. Seconda soluzione: in Backup ripristina la configurazione da un backup risalente alla vecchia versione.
  4. Se non hai un backup adatto, scarica il file da File, eliminalo e riavvia il server. Verrà creato un nuovo file, in cui dovrai poi riportare a mano le tue modifiche.

Buono a sapersi: Come cambiare versione in sicurezza è spiegato in Cambiare in sicurezza la versione di Minecraft e il modloader.

MinecraftWarriors3 non trova la cartella della mappa

Ecco come appare il messaggio:

[MinecraftWarriors3] [Offizielle Map] Quell-Ordner der Map nicht gefunden: ./plugins/MinecraftWarriors3/maps/<Map-Ordner>

Cosa significa: MinecraftWarriors3 prende la mappa ufficiale da una cartella di origine indicata nella sua configurazione. Questa cartella manca. La mappa quindi non può essere né copiata né avviata e tutto ciò che si svolge su di essa smette di funzionare. Il server, invece, continua a funzionare.

Come risolvere:

  1. In File apri il percorso indicato nel messaggio. Il punto iniziale (./) rappresenta la directory principale del server.
  2. Se la cartella manca, carica lì la mappa. I file del mondo devono trovarsi direttamente nella cartella, non in un'ulteriore sottocartella come quella che spesso si crea estraendo un archivio.
  3. Se la mappa si trova altrove o la cartella ha un altro nome, correggi il percorso nella configurazione in plugins/MinecraftWarriors3/. Maiuscole e minuscole contano.
  4. Riavvia il server e controlla la Console.

Buono a sapersi: Come caricare un mondo per intero è spiegato in Caricare un mondo Minecraft e cambiarlo in sicurezza.

«Failed to load …»: il plugin non riesce a caricare un menu o la configurazione

Ecco come appare il messaggio:

[DeluxeMenus] Failed to load menu items for menu: <Menü>
[GrimAC] Failed to reload config: java.lang.RuntimeException: Failed to load config
Could not load messages.yml!

Cosa significa: Un plugin non è riuscito a leggere uno dei suoi file, ad esempio un menu, una configurazione, un file di lingua, un ologramma o un NPC (un personaggio controllato dal server). Di solito la causa è un errore di formato, un nome duplicato o una condizione scritta male. Con DeluxeMenus il menu interessato viene saltato; con GrimAC non riesce il caricamento o il ricaricamento della configurazione. A seconda del plugin, mancano singole funzioni oppure il plugin non si avvia completamente.

Come risolvere:

  1. Leggi le righe sotto il messaggio. Spesso indicano file, riga e motivo.
  2. Apri il file in File e confrontalo con l'esempio della guida del plugin. Per le condizioni dei menu controlla anche la sintassi delle espressioni.
  3. Se non trovi l'errore, salva una copia del file e arresta il server. Rinomina il file invece di eliminarlo. Fai generare un nuovo file predefinito solo se la guida prevede questa procedura.
  4. Riporta poco per volta i tuoi testi e le tue impostazioni dal vecchio file e riavvia il server.

Buono a sapersi: un nuovo file non contiene i tuoi menu, ologrammi o NPC precedenti. Se necessario, ripristina queste voci dai Backup.

«InvalidConfigurationException»: file YAML di un plugin non valido

Ecco come appare il messaggio:

[<Plugin>] Failed to load <Datei>; the original file will not be replaced.
[BMenu] Errors in <Datei>
org.bukkit.configuration.InvalidConfigurationException: while parsing a block mapping

Cosa c'è dietro: YAML è un formato di file che definisce la propria struttura tramite indentazione e due punti. «mapping values are not allowed here» indica spesso la presenza di due punti seguiti da uno spazio in un valore di testo senza virgolette, oppure un'indentazione errata. «while parsing a block mapping» ed «expected <block end>» segnalano una struttura non valida, ad esempio una voce di elenco con - indentata male. In questi casi il plugin non usa il file e torna ai valori predefiniti, oppure non si avvia affatto; EssentialsX rinomina il file danneggiato e ne crea uno nuovo.

Come risolvere:

  1. Fai una copia di backup del file indicato e aprilo in File. Controlla le righe citate nel messaggio e quelle precedenti.
  2. Indenta usando solo spazi e allinea esattamente allo stesso livello le chiavi di pari grado. Controlla anche l'indentazione delle voci di elenco.
  3. Metti tra virgolette i testi che contengono due punti, ad esempio message: "Achtung: Neustart".
  4. Un validatore YAML online ti mostra il punto esatto dell'errore. Dopo la correzione, riavvia il server.

Buono a sapersi: se EssentialsX ha rinominato il file, troverai la tua vecchia versione nella stessa cartella. Riporta le tue modifiche nel nuovo file, invece di ricopiare quello danneggiato.

Formula di calcolo non valida nella configurazione di un plugin

Ecco come appare il messaggio:

net.objecthunter.exp4j.tokenizer.UnknownFunctionOrVariableException: Unknown function or variable '<Ausdruck>' …

Cosa c'è dietro: alcuni plugin calcolano determinati valori tramite formule presenti nella loro configurazione, ad esempio prezzi, ricompense o tempi di ricarica. La libreria di calcolo usata a questo scopo, exp4j, riconosce solo numeri, operatori, funzioni integrate e le variabili messe a disposizione dal plugin. Se la formula contiene altro, ad esempio «100t» invece di «100», il calcolo si interrompe. La funzione corrispondente del plugin non si comporta quindi come previsto. Il server continua a funzionare.

Come risolvere:

  1. Annota l'espressione tra apici riportata nel messaggio.
  2. Individua il plugin grazie allo stacktrace, cioè le righe at indentate subito sotto. Lì trovi di solito il nome del file del plugin, ad esempio <Plugin>.jar//.
  3. Cerca l'espressione nei file di configurazione di quel plugin. Se i file sono molti, ti conviene scaricare la cartella via SFTP e fare la ricerca sul tuo computer.
  4. Sostituiscila con un numero o una formula valida. Le variabili consentite sono indicate nella guida del plugin.
  5. Ricarica il plugin o riavvia il server.

Buono a sapersi: per configurare l'accesso SFTP, consulta la guida: Modificare i file del server nel pannello e connettersi via SFTP.

FancyNpcs: azione dell'NPC con intervallo casuale vuoto

Ecco come appare il messaggio:

Exception in thread "FancyNpcs-ActionExecutor" java.lang.IllegalArgumentException: bound must be positive

Cosa c'è dietro: un'azione di un NPC di FancyNpcs deve scegliere qualcosa a caso, ad esempio una tra più azioni successive. Se la selezione è vuota o l'intervallo numerico è negativo, non è possibile generare un numero casuale e l'azione si interrompe. I giocatori se ne accorgono perché, cliccando sull'NPC, non succede nulla o solo una parte di ciò che dovrebbe accadere. Il server e gli altri NPC continuano a funzionare.

Come risolvere:

  1. Aggiorna FancyNpcs alla versione più recente per la versione del tuo server.
  2. Controlla le azioni dell'NPC interessato. Ogni selezione casuale richiede almeno una voce e i limiti numerici devono essere positivi.
  3. I dati degli NPC si trovano in File, nella cartella plugins/FancyNpcs. Prima di apportare modifiche crea un backup e modifica i file solo a server fermo.
  4. Avvia il server e clicca sull'NPC per provarlo.

Buono a sapersi: il messaggio non indica quale sia l'NPC. Se hai più NPC con azioni casuali, provali uno alla volta tenendo d'occhio la Console.

Testo con vecchi codici colore in un campo MiniMessage

Ecco come appare il messaggio:

Legacy formatting codes have been detected in a MiniMessage string …

Cosa c'è dietro: MiniMessage è una sintassi per formattare il testo con tag tra parentesi angolari, ad esempio <red> o <bold>. Molti plugin attuali la usano per chat, titoli e menu. MiniMessage non riconosce i vecchi codici colore con & o §. Se un testo contiene uno di questi codici, viene visualizzato con una formattazione errata o non appare affatto. Il server continua a funzionare.

Come risolvere:

  1. Individua il plugin. Di solito è indicato nella riga prima del messaggio o nello stacktrace sottostante.
  2. Apri in File il suo file di configurazione o di lingua e sostituisci i vecchi codici con i tag:
    • &c diventa <red>, &a diventa <green>, &e diventa <yellow>
    • &l diventa <bold>, &o diventa <italic>, &r diventa <reset>
    • &#37FF00 o §x§3§7… diventa <#37FF00>
  3. Se il plugin offre nelle impostazioni una modalità legacy per i vecchi codici, puoi attivare quella.
  4. Ricarica il plugin o riavvia il server e controlla il testo in gioco.

Buono a sapersi: non mescolare mai le due sintassi nello stesso testo. Basta una sola & rimasta per far comparire il messaggio.

Paxel: manca un valore per un livello dello strumento

Ecco come appare il messaggio:

[Paxel] Setting "<Einstellung>" for tier "<Stufe>" is not defined in the config!

Cosa c'è dietro: un paxel è uno strumento che riunisce piccone, ascia e pala. Il plugin Paxel lo offre in diversi livelli e ogni livello richiede determinati valori obbligatori nella configurazione. Per il livello indicato ne manca uno. Quel paxel non può quindi essere fabbricato né distribuito. Succede spesso dopo un aggiornamento, quando la nuova versione richiede un'impostazione non ancora presente nel vecchio file.

Come risolvere:

  1. Apri in File la configurazione nella cartella plugins/Paxel.
  2. Cerca il livello indicato nel messaggio e aggiungi l'impostazione mancante. Puoi usare come modello un livello completo presente nello stesso file.
  3. In alternativa, rinomina il file e riavvia. Il plugin creerà la configurazione predefinita della versione attuale, in cui potrai riportare le tue personalizzazioni.
  4. Riavvia il server e controlla la Console.

Buono a sapersi: quando aggiungi il valore, usa la stessa indentazione degli altri valori del livello, altrimenti si verificherà un errore YAML.

«Permission node … is invalid»: definizione dei permessi del plugin non valida

Ecco come appare il messaggio:

Permission node '<Plugin>.<Recht>' in plugin description file for <Plugin> v<Version> is invalid
java.lang.IllegalArgumentException: Data cannot be null
java.lang.IllegalArgumentException: 'default' key contained unknown value

Cosa c'è dietro: ogni plugin descrive i permessi che introduce nel proprio plugin.yml, un file contenuto all'interno del JAR del plugin. Una di queste descrizioni non è stata caricata. Il nome indicato può essere del tutto corretto. Le righe successive Data cannot be null e 'default' key contained unknown value indicano dati di definizione mancanti o un valore non valido per default. Di solito il plugin si avvia comunque, ma questo permesso non viene creato con i suoi valori predefiniti.

Come risolvere:

  1. Leggi nel messaggio quale plugin è interessato.
  2. Aggiornalo a una build compatibile con la versione del tuo server. Sostituisci il JAR a server fermo.
  3. Se è un plugin tuo, controlla l'intero blocco permissions del plugin.yml confrontandolo con il formato Bukkit, non solo il nome. Ogni voce è una sezione con proprietà come description, default (true, false, op o not op) e children.
  4. Riavvia il server.

Buono a sapersi: se assegni comunque i permessi da solo con un plugin come LuckPerms, il messaggio di solito ha poco effetto sui tuoi giocatori.

SuntexSocial: proxy SOCKS5 senza indirizzo

Ecco come appare il messaggio:

[SuntexSocial] … SOCKS5 proxy is enabled, but telegram.proxy.host is empty

Qual è la causa: SuntexSocial collega il tuo server a un bot di Telegram. Nella configurazione è impostato che il bot acceda a Internet tramite un proxy SOCKS5. Un proxy è un server intermediario attraverso cui passa la connessione. L'indirizzo di questo proxy (telegram.proxy.host) però è vuoto. Per questo il bot di Telegram non si avvia, mentre il server Minecraft continua a funzionare normalmente.

Come risolvere:

  1. Apri in File la configurazione nella cartella plugins/SuntexSocial.
  2. Se ti serve il proxy, inserisci sotto telegram e proxy, alla voce host, il nome host e la porta corrispondente. Entrambi ti vengono forniti dal provider del proxy.
  3. Se non ti serve un proxy, disattiva il proxy SOCKS5 nella stessa configurazione.
  4. Riavvia il server e controlla che il bot risponda.

Buono a sapersi: un proxy è necessario solo se Telegram non è raggiungibile direttamente dalla rete del server. Se non è questo il caso, lascialo disattivato.

Il plugin del generatore di mondi si avvia troppo tardi

Ecco come appare il messaggio:

Could not set generator for default world '<Welt>': Plugin '<Plugin>' is not enabled yet

Qual è la causa: per il mondo principale è impostato un generatore fornito da un plugin, ma il plugin si avvia solo dopo che il server ha caricato i mondi. Il mondo usa quindi il generatore normale, perciò le nuove aree avranno un aspetto diverso da quello previsto. Per le aree già generate non cambia nulla. Il server funziona normalmente.

Come risolvere:

  1. Leggi nella guida del plugin del generatore come configurarlo per il mondo principale.
  2. Di solito il generatore va inserito in bukkit.yml, sotto worlds:, in corrispondenza del nome del mondo principale.
  3. Il plugin deve caricarsi all'avvio del server, quindi prima dei mondi. Questo viene stabilito dallo sviluppatore nel plugin.yml con load: STARTUP. Se il messaggio compare comunque, controlla che la versione installata sia compatibile con la versione del tuo server.
  4. Riavvia il server e controlla la Console.

Buono a sapersi: le aree già create con il generatore normale restano così. Se vuoi che l'intero mondo venga creato con il nuovo generatore, ti serve un mondo nuovo. Prima salva quello vecchio in Backup.

LuckPerms non riesce a leggere il file di importazione

Ecco come appare il messaggio:

[LuckPerms] Error whilst reading from the import file

Qual è la causa: con l'importazione, LuckPerms acquisisce gruppi, permessi e dati dei giocatori da un file creato in precedenza con l'esportazione, ad esempio quando ti trasferisci da un altro server. LuckPerms non è riuscito a leggere il file selezionato o a elaborarne il formato. L'importazione si interrompe. Il server continua a funzionare.

Come risolvere:

  1. Controlla in File che il file si trovi nella cartella plugins/LuckPerms e che il suo nome corrisponda esattamente a quello indicato nel comando.
  2. Carica il file senza modifiche, così come è stato generato dall'esportazione, quindi senza estrarlo, rinominarlo o modificarlo.
  3. Leggi il messaggio di errore subito sotto questa riga. Indica il punto esatto in cui la lettura non è riuscita.
  4. Poi riavvia l'importazione con /lp import <Datei>.

Buono a sapersi: come creare e controllare gruppi e permessi in LuckPerms te lo spiega la guida Configurare LuckPerms: permessi e gruppi.

Un'impostazione di Paper contiene un valore sconosciuto

Ecco come appare il messaggio:

Encountered an unexpected exception
org.spongepowered.configurate.serialize.SerializationException: [<Pfad der Einstellung>] <unbekannter Wert> …

Qual è la causa: Paper legge le sue impostazioni da config/paper-global.yml, config/paper-world-defaults.yml e, per ogni mondo, dal file paper-world.yml nella cartella del mondo. In uno di questi file è presente un valore che la versione del tuo server non riconosce, ad esempio un oggetto o un componente dati che esiste solo in una versione più recente o che è stato rinominato. L'impostazione non viene applicata. Succede spesso dopo il passaggio a una versione precedente o quando i file sono stati copiati da un altro server.

Come risolvere:

  1. Leggi il messaggio: tra parentesi quadre trovi il percorso dell'impostazione, cioè le chiavi dall'esterno verso l'interno, seguito dal valore sconosciuto.
  2. Apri il file corrispondente in File, nella cartella config o nella cartella del mondo, e segui il percorso.
  3. Sostituisci il valore con un nome riconosciuto dalla tua versione oppure rimuovilo.
  4. Riavvia il server.

Buono a sapersi: se rimuovi un'intera impostazione, al successivo avvio Paper inserirà di nuovo il valore predefinito.

«key already exists …»: BMenu carica più volte un identificatore di menu

Ecco come appare il messaggio:

[BMenu] key already exists <Bereich>:<Menü>

Qual è la causa: BMenu gestisce i menu tramite identificatori univoci. Se un identificatore già in uso viene registrato di nuovo, il plugin scarta la nuova voce e mantiene quella esistente. Di conseguenza, le modifiche alla seconda definizione del menu possono mancare oppure può comparire un menu diverso da quello previsto. Il server continua a funzionare.

Come risolvere:

  1. Crea in Backup un backup delle tue impostazioni prima di modificare i file dei menu.
  2. Leggi l'identificatore completo nella Console. Confronta in File gli identificatori delle definizioni dei menu di BMenu e controlla anche che i menu importati non contengano definizioni doppie.
  3. Rimuovi la copia superflua o assegna al secondo menu un identificatore univoco. Aggiorna anche gli eventuali riferimenti a un identificatore modificato.
  4. Riavvia completamente il server e prova i menu interessati. Se il messaggio persiste nonostante le definizioni siano univoche, segnala la procedura all'autore di BMenu allegando il log di avvio completo.

Buono a sapersi: l'ordine di registrazione determina quale voce viene mantenuta. Per questo non fare affidamento su un determinato ordine dei file.

SCore: l'identificatore della testa viene rifiutato dal database delle teste

Ecco come appare il messaggio:

[SCore] Error when creating the Head: <Kopfwert> invalid head database id ! (<Kopfwert>)

Qual è la causa: SCore deve creare una testa personalizzata, ma non riesce a risolvere il valore impostato tramite il database delle teste. Un identificatore del database rimanda a una testa memorizzata al suo interno, mentre un valore texture ne descrive l'aspetto. La testa interessata manca, mentre il server continua a funzionare.

Come risolvere:

  1. Controlla nella Console quale plugin SCore sta caricando la testa. Apri la sua definizione della testa in File.
  2. Confronta il formato impostato con la guida di quel plugin. Usa un identificatore di testa valido; inserisci un valore texture solo nel campo documentato a tale scopo.
  3. Se è integrato un database di teste, controlla i suoi messaggi di avvio e attendi che sia completamente caricato. Dopodiché prova di nuovo la testa.
  4. Riavvia il server dopo la correzione e controlla la visualizzazione o l'oggetto interessato.

Multiverse: il nome del mondo predefinito è in conflitto con un altro mondo

Ecco come appare il messaggio:

[Multiverse-Core] Unable to migrate default world's name caused by level-name change.
[Multiverse-Core] We have detected a clash between the default name '<Welt>' and an existing non-default world in your worlds.yml file.
[Multiverse-Core] Please change the level-name in server.properties to something else and restart the server.

Cosa significa: dopo una modifica di level-name, Multiverse deve adottare il nome del mondo predefinito. Nella sua configurazione dei mondi, però, il nuovo nome è già assegnato a un altro mondo. Per questo l'operazione viene interrotta e l'associazione del mondo predefinito deve essere corretta.

Come risolvere:

  1. Crea un backup in Backup e arresta il server prima di apportare modifiche.
  2. In File, confronta la voce level-name in server.properties con il file worlds.yml di Multiverse. Verifica quale mondo esistente debba essere effettivamente quello predefinito.
  3. Se la modifica non era intenzionale, ripristina il nome precedente del mondo predefinito. Se invece vuoi davvero rinominarlo, risolvi prima il conflitto seguendo la guida di Multiverse.
  4. Avvia il server e controlla nella Console se l'associazione va a buon fine. Verifica poi di entrare nel mondo desiderato.

UltimateDonutSmp: il comando di ricompensa di una cassa non riesce

Ecco come appare il messaggio:

[UltimateDonutSmp] Failed to grant crate reward <Belohnung> from crate <Kiste> to <Spieler>
org.bukkit.command.CommandException: Unhandled exception executing <Befehl>

Cosa significa: UltimateDonutSmp esegue un comando per assegnare la ricompensa di una cassa. Questo comando termina con un errore, quindi l'azione di ricompensa interessata non riesce. Il server continua a funzionare; la configurazione della cassa e la traccia completa dell'errore indicano quale comando è coinvolto.

Come risolvere:

  1. Apri il messaggio completo nella Console oppure in File, nel file logs/latest.log. Leggi anche le righe successive che indicano la causa.
  2. In File, controlla il comando di ricompensa della cassa interessata. Confronta la sua sintassi e i segnaposto del giocatore con la guida della tua versione di UltimateDonutSmp.
  3. Aggiorna il plugin a una versione adatta in Plugin e riavvia il server dopo la correzione.
  4. Prova la ricompensa in modo controllato. Prima di assegnarla di nuovo, verifica se una parte sia già stata pagata o consegnata, così da non distribuire nulla due volte.

Configurare in sicurezza la dashboard di NovaSync e sostituire le credenziali predefinite

Ecco come appare il messaggio:

[NovaSyncPlugin] [CRITICAL] dashboard.creds: no OWNER account configured AND defaults still in vault

Cosa significa: nella dashboard di NovaSync manca un account proprietario, cioè l'account per l'amministrazione della dashboard. Inoltre, nell'archivio delle credenziali del plugin sono ancora presenti le credenziali predefinite. La configurazione iniziale sicura è quindi incompleta e deve essere portata a termine. Il server di gioco continua a funzionare; l'avviso riguarda l'accesso alla dashboard del plugin.

Come risolvere:

  1. Leggi il messaggio completo nella Console oppure in File, nel file logs/latest.log.
  2. Apri nella tua dashboard di NovaSync il percorso indicato /dashboard e completa tutta la procedura guidata di configurazione. Durante la procedura, crea il tuo account proprietario.
  3. Sostituisci le credenziali predefinite con credenziali tue, usando una password robusta utilizzata solo qui. Verifica poi se NovaSync mostra di nuovo l'avviso.

Buono a sapersi: le credenziali non vanno inserite in un ticket né in un estratto di log condiviso pubblicamente. Se non riesci a proseguire, apri un ticket e indica l'orario del messaggio.

DonutShop: il comando di acquisto non riesce e gli Shard vengono rimborsati

Ecco come appare il messaggio:

[DonutShop] Shard shop command failed for <Spieler> ("<Befehl>"); refunding <Betrag> Shard.

Cosa significa: DonutShop tenta di assegnare ciò che è stato acquistato tramite un comando configurato. Questo comando non riesce e il plugin segnala il rimborso degli Shard. Il server continua a funzionare; il problema riguarda solo questo acquisto.

Come risolvere:

  1. Nella Console, leggi i messaggi immediatamente precedenti al comando di acquisto. Possono indicare un comando sconosciuto o un parametro non valido.
  2. Apri la voce del negozio interessata in File. Confronta il nome del comando, gli argomenti e i segnaposto del giocatore con la documentazione del plugin responsabile.
  3. Verifica che il plugin che esegue il comando sia installato in Plugin e che, secondo la Console, sia stato caricato correttamente.
  4. Applica la correzione seguendo la guida di DonutShop. Prova poi un singolo acquisto e controlla la ricompensa e il saldo degli Shard.

ExecutableItems: manca true o false nel comando speciale

Ecco come appare il messaggio:

[ExecutableItems] INVALID COMMAND A SCommand contains an invalid boolean: <Wert> for command: <Befehl>

Cosa significa: ExecutableItems controlla gli argomenti di un comando speciale. Un valore booleano è un'indicazione sì/no che si scrive true o false. Nella posizione prevista si trova invece un altro valore. L'azione dell'item interessata risulta quindi non valida; il server continua a funzionare.

Come risolvere:

  1. Apri il messaggio nella Console e cerca il comando indicato nella configurazione dell'item interessato in File.
  2. Salva una copia del file prima di modificarlo. Confronta l'intera sequenza di argomenti con la documentazione della versione di ExecutableItems che hai installato.
  3. Inserisci true o false nella posizione prevista. Se alcuni argomenti sono stati spostati, controlla anche la posizione dei comandi successivi.
  4. Dopo aver salvato, riavvia il server e prova proprio questa azione dell'item.

ExecutableItems: il mondo in disableItemsPerWorld non è valido

Ecco come appare il messaggio:

[ExecutableItems] Invalid world: <Welt> in the option disableItemsPerWorld

Cosa significa: ExecutableItems deve bloccare determinati item per ogni mondo. Un mondo inserito a questo scopo non viene riconosciuto dal plugin come mondo caricato valido. La regola di blocco di questa voce non può quindi essere associata correttamente. Il server continua a funzionare.

Come risolvere:

  1. Controlla nella Console se il mondo desiderato è stato caricato correttamente. Risolvi prima eventuali errori di caricamento segnalati lì.
  2. Fai un backup della configurazione di ExecutableItems in File e cerca l'opzione disableItemsPerWorld.
  3. Confronta la voce con il nome effettivo del mondo caricato. Correggi la grafia e rimuovi le voci relative ai mondi eliminati definitivamente.
  4. Riavvia completamente il server. Controlla la Console e verifica che gli item previsti siano bloccati nel mondo interessato.

BAirDropFNV: il mondo del punto di lancio fisso non è caricato

Ecco come appare il messaggio:

[BAirDropFNV] World error in airdrop default static location not loaded!

Qual è la causa: per un airdrop, BAirDropFNV usa un punto fisso definito nella sua configurazione. Il mondo associato non è caricato, quindi il punto non può essere utilizzato. Questo airdrop viene saltato, mentre il server continua a funzionare.

Come risolvere:

  1. Controlla nella Console quali mondi vengono caricati all'avvio e se prima compare un errore di caricamento per il mondo desiderato.
  2. Arresta il server e fai un backup della configurazione di BAirDropFNV tramite File.
  3. Confronta il mondo indicato per il punto di lancio fisso con il nome effettivo di un mondo caricato. Correggi la voce impostando il mondo esistente desiderato.
  4. Se ti serve un mondo aggiuntivo, risolvi il suo errore di caricamento. Poi riavvia e controlla di nuovo l'airdrop.

Un plugin legge un archivio come file di configurazione

Ecco come appare il messaggio:

Cannot load plugins/<Plugin>/<Ordner>/<Archiv>.tar.gz
InvalidConfigurationException: unacceptable code point

Qual è la causa: un plugin tenta di leggere come configurazione YAML un archivio compresso presente nella sua cartella dati. Il lettore di testo rifiuta i dati binari e il file non viene caricato. YAML è un formato di testo per le impostazioni. Rinominare semplicemente un archivio non ne converte il contenuto in questo formato.

Come risolvere:

  1. Arresta il server e crea un backup in Backup prima di spostare i file nella cartella dati del plugin.
  2. Individua tramite File l'archivio indicato nella console e spostalo dalla cartella di configurazione letta dal plugin in una posizione separata.
  3. Lascia i file di configurazione validi nella cartella prevista, riavvia e verifica che i kit o le voci del plugin interessati vengano caricati.

Purpur salta i blocchi sconosciuti nelle impostazioni dell'ascia

Ecco come appare il messaggio:

Invalid block for `tools.axe.weatherables`: <Block>
Invalid block for `tools.axe.waxables`: <Block>

Qual è la causa: qui Purpur legge le regole per rimuovere ossidazione e cera con un'ascia. Un ID blocco inserito non esiste nella versione di Minecraft in uso. Purpur salta questa regola e continua a elaborare le altre impostazioni. Può succedere, ad esempio, dopo aver importato una configurazione da un'altra versione.

Come risolvere:

  1. Controlla la Versione in uso e fai un backup di purpur.yml tramite File prima di apportare modifiche.
  2. Arresta il server. Cerca le voci segnalate in tools.axe.weatherables e tools.axe.waxables, incluse eventuali impostazioni diverse per singolo mondo.
  3. Rimuovi i blocchi sconosciuti o correggili consultando la documentazione di Purpur per la tua versione. Mantieni le altre impostazioni.
  4. Avvia il server e controlla nella Console che i messaggi siano scomparsi.

Il tuo messaggio non è nell'elenco?

Leggi l'intero messaggio nella Console o in logs/latest.log, comprese le righe immediatamente precedenti. Spesso lì è indicato quale plugin sta caricando i propri file. Nello stack trace sottostante puoi riconoscere il plugin dal nome del file JAR o dalla cartella plugins/<Plugin>/ nel percorso. Se il messaggio indica un file con riga e colonna, si tratta quasi sempre di un errore di formato come quelli descritti nelle sezioni precedenti. Crea un backup prima di ogni modifica. Se non riesci a risolvere, apri un ticket e indica l'ora in cui è comparso il messaggio.