Molti plugin non funzionano in modo autonomo. I plugin premium verificano una chiave di licenza all'avvio, le integrazioni con Discord, Telegram o VK richiedono un token (una sorta di password per un bot o un'interfaccia), i plugin di chat vocale aprono una propria porta di rete e alcuni scaricano librerie o database da Internet. Se uno di questi elementi manca o viene rifiutato, il plugin scrive un messaggio nel log. Di solito smette di funzionare solo quel plugin; in un caso, però, il plugin arresta volutamente il server.

Ogni sezione qui sotto tratta un messaggio. Trovi il messaggio completo nella Console oppure in File, in logs/latest.log, mentre la configurazione dei plugin si trova in plugins/<Plugin>/. Prima di modificarla, crea un backup in Backup. Chiavi e token sono segreti: non mostrarli a nessuno e ritagliali dagli screenshot.

DonutShop rifiuta la chiave di licenza

Ecco come appare il messaggio:

[DonutShop]             DONUTSHOP ERROR
[DonutShop] The licensing server rejected this key.

Cosa significa: DonutShop è un plugin per negozi che all'avvio verifica la propria chiave di licenza sul server di licenze dell'autore. Questa verifica non è riuscita all'ultimo avvio. Anche un valore inserito e non vuoto può essere non valido, scaduto o emesso per un'altra installazione. Il server Minecraft può continuare a funzionare, ma DonutShop non è disponibile in modo affidabile: i giocatori non possono fare affidamento sul negozio.

Come risolvere:

  1. Ottieni o controlla la chiave di licenza gratuita tramite la pagina ufficiale del progetto DonutShop su Modrinth.
  2. In File, apri la configurazione di DonutShop (plugins/DonutShop/config.yml) e inserisci la chiave in license-key. Mettila tra virgolette, senza spazi prima o dopo.
  3. Salva il file e riavvia il server.
  4. Controlla nella Console: l'errore è risolto solo quando il banner «DONUTSHOP ERROR» non compare più al nuovo avvio.

Buono a sapersi: se hai ripreso la chiave da un altro server, procurane una apposita per questo server.

LibreLogin arresta il server: impossibile caricare una libreria

Ecco come appare il messaggio:

[LibreLogin] Failed to load libraries, stopping server to prevent damage
… Failed to download library <Bibliothek>

Cosa significa: LibreLogin è un plugin di autenticazione con cui i giocatori accedono tramite password. All'avvio scarica alcune librerie, cioè componenti software non inclusi nel plugin, tra cui PacketEvents. Se il download non riesce, LibreLogin arresta volutamente il server invece di lasciarlo funzionare solo in parte. Il server quindi non si avvia finché il problema non viene risolto.

Come risolvere:

  1. Riavvia il server una volta. Se la fonte del download era irraggiungibile solo per poco tempo, spesso il tentativo successivo va a buon fine.
  2. In Plugin, aggiorna LibreLogin alla versione più recente per il tuo software server. Se hai installato PacketEvents come plugin separato, aggiorna anche quello.
  3. Riavvia e controlla nella Console se ora le librerie vengono caricate.
  4. Se il messaggio compare a ogni avvio, il server non riesce a raggiungere l'indirizzo di download. La causa può essere la connessione a Internet, la risoluzione dei nomi (DNS, che traduce gli indirizzi in numeri IP) o l'indirizzo stesso. Se non riesci a venirne a capo, apri un ticket e indica l'orario del messaggio.

Buono a sapersi: come aggiornare e sostituire i plugin è spiegato nella guida Installare e gestire i plugin di Minecraft.

«Packet queue has … packets»: Simple Voice Chat non riesce a stare al passo

Ecco come appare il messaggio:

[voicechat] Packet queue has <Anzahl> packets
[voicechat] Dropping voice chat packets!

Cosa significa: Simple Voice Chat trasmette la voce tra i giocatori che si trovano vicini nel gioco. Il messaggio indica che la chat vocale non riesce a stare al passo con l'elaborazione: i pacchetti vocali si accumulano in una coda oppure vengono scartati. La causa è un server momentaneamente sovraccarico, con TPS bassi (tick al secondo, il ritmo di Minecraft; il valore normale è 20) o un carico elevato della CPU. I giocatori sentono quindi la voce a scatti o non la sentono affatto, mentre il server continua a funzionare.

Come risolvere:

  1. Scopri cosa genera il carico, ad esempio con spark: spark: trovare e capire il lag sul server Minecraft.
  2. Riduci la distanza di visualizzazione (view-distance) e la distanza di simulazione (simulation-distance) in File, nel file server.properties. Salva e riavvia, così il server caricherà meno chunk (sezioni del mondo di 16 × 16 blocchi).
  3. Riduci il numero di entità (creature, animali, oggetti a terra) nei singoli punti e controlla i plugin che generano molto carico.
  4. Se non basta, passa a un piano più potente in Impostazioni e abbonamento → Piano.

Buono a sapersi: singoli messaggi subito dopo l'avvio o durante l'esplorazione di nuove aree non sono preoccupanti, purché poi cessino.

Simple Voice Chat non riesce a ottenere la sua porta UDP

Ecco come appare il messaggio:

[voicechat] Failed to run voice chat at UDP port <Port>
[voicechat] Disabling Simple Voice Chat

Cosa significa: Simple Voice Chat trasmette la voce attraverso una propria porta UDP. UDP è il protocollo di rete per dati veloci in tempo reale, come la voce. La porta impostata non appartiene al tuo server oppure è già occupata, ad esempio perché è ancora inserito il valore predefinito indicato nelle istruzioni del plugin. Senza porta la chat vocale si disattiva; il gioco continua a funzionare normalmente.

Come risolvere:

  1. In File, apri il file plugins/voicechat/voicechat-server.properties. Se usi Simple Voice Chat come mod, si trova in config/voicechat/voicechat-server.properties.
  2. Imposta port sul numero di porta del tuo server. La tua porta di gioco è abilitata sia per TCP sia per UDP.
  3. Salva il file e riavvia il server.
  4. Controlla nella Console che il messaggio non compaia più e prova la chat vocale nel gioco.

Per maggiori dettagli: Configurare Simple Voice Chat sul server Minecraft.

Buono a sapersi: una porta UDP può essere aperta da un solo programma alla volta. Se un altro plugin usa già la stessa porta, ad esempio Geyser per i giocatori Bedrock, uno dei due deve usare un'altra porta assegnata al tuo server.

«No bot token»: l'accesso a Discord non riesce

Ecco come appare il messaggio:

[DiscordSRV] No bot token has been set in the config; a bot token is required to connect to Discord.
[EssentialsDiscord] An error occurred while logging into Discord … No token provided!
[DiscordWhitelist] Edit plugins/DiscordWhitelist/config.yml and set discord.bot-token, then run /discordwhitelist reload.

Cosa significa: le estensioni per Discord accedono tramite un proprio bot. Per farlo hanno bisogno del suo token, una stringa segreta simile a una password; se manca o non è valido, il collegamento a Discord non si attiva, mentre Minecraft continua a funzionare; in questo caso EssentialsDiscord disattiva la propria estensione. Con voicechat-discord, inoltre, i tipi di dati possono essere errati: token deve essere un testo, vc_id un numero.

Come risolvere:

  1. Crea un bot nel Discord Developer Portal oppure scegli quello che hai già. Se necessario, genera un nuovo token.
  2. Inserisci il token nella configurazione tramite File: per DiscordSRV in plugins/DiscordSRV/config.yml alla voce BotToken, per DiscordWhitelist in plugins/DiscordWhitelist/config.yml alla voce discord.bot-token. Per le altre estensioni fai riferimento alle rispettive guide.
  3. Con voicechat-discord, token deve essere una stringa e vc_id il numero richiesto dalla guida.
  4. Se necessario, invita il bot sul tuo server Discord, poi salva e riavvia Minecraft.

Buono a sapersi: non condividere mai il token; se viene reso pubblico, reimpostalo. In caso di errori relativi agli intent, attiva nel Developer Portal i «Privileged Gateway Intents» richiesti.

«Could not download GeoLiteAPI database»: manca il database dei Paesi

Ecco come appare il messaggio:

[AuthMe] Could not download GeoLiteAPI database [FileNotFoundException]: plugins/AuthMe/GeoLite2-Country.mmdb (No such file or directory)
[DigitalClockRemastered] [DigitalClock] Error when downloading file GeoLiteCity.dat: java.net.UnknownHostException: <Domain>

Qual è la causa: alcuni plugin, come AuthMe, scaricano un database per associare gli indirizzi IP ai rispettivi Paesi, e questo download non è riuscito. Con FileNotFoundException e «No such file or directory» manca il file locale indicato o una cartella collegata. Con UnknownHostException non è possibile risolvere il nome host della fonte di download. Il plugin continua a funzionare, ma senza database le funzioni basate sul Paese restano inattive.

Come risolvere:

  1. Se il problema di download è temporaneo, al riavvio successivo il plugin riproverà.
  2. In caso di «No such file or directory», controlla in File il percorso indicato e quello specificato nella configurazione del plugin. Configura il database seguendo la guida della tua versione del plugin.
  3. In caso di UnknownHostException, verifica nella guida ufficiale del plugin che la tua build e la sua fonte di download siano ancora aggiornate. A server fermo, aggiorna il plugin a una build adatta.
  4. Se la tua versione del plugin richiede una chiave di licenza, inserisci la tua chiave valida nell'apposito campo della configurazione.
  5. Salva, riavvia e controlla la Console.

Buono a sapersi: se non usi funzioni basate sul Paese, puoi ignorare il messaggio. Tutte le altre funzioni continuano a lavorare normalmente.

DonutShop è bloccato senza chiave di licenza

Ecco come appare il messaggio:

[DonutShop]             DONUTSHOP LOCKED
[DonutShop] No license key is set in config.yml.
[DonutShop] Then run: /link <your-key>

Qual è la causa: DonutShop si avvia solo con una chiave di licenza. Nel suo config.yml non ne è stata inserita nessuna, quindi lo shop resta bloccato. La chiave è gratuita, ma devi richiederla una volta all'autore. Il server Minecraft in sé non è interessato dal problema.

Come risolvere:

  1. Richiedi la chiave gratuita all'autore del plugin. Il messaggio indica come raggiungerlo, tramite un link Discord, nelle righe intorno al banner.
  2. Esegui /link <dein-schlüssel> come indicato dal messaggio, oppure inserisci la chiave in plugins/DonutShop/config.yml.
  3. Riavvia il server.
  4. Controlla nella Console che il banner «DONUTSHOP LOCKED» sia scomparso.

Buono a sapersi: se in seguito compare «DONUTSHOP ERROR», la chiave è stata rifiutata. In quel caso ti aiuta la sezione dedicata alla licenza DonutShop rifiutata.

Il token VK del plugin viene rifiutato

Ecco come appare il messaggio:

com.vk.api.sdk.exceptions.ApiAuthException: User authorization failed (5): User authorization failed: invalid access_token (4).

Qual è la causa: alcuni plugin si collegano a VK, il social network VKontakte. Per farlo hanno bisogno di un token di accesso, una sorta di password per l'interfaccia. VK ha rifiutato il token inserito («invalid access_token»), quindi è non valido, scaduto o revocato. Le funzioni VK del plugin sono disattivate, mentre il resto del server funziona normalmente.

Come risolvere:

  1. Genera su VK un nuovo token di accesso con i permessi richiesti dal plugin. Li trovi elencati nella guida del plugin.
  2. Apri in File la configurazione del plugin in plugins/<Plugin>/ e sostituisci il vecchio token con quello nuovo.
  3. Salva il file e riavvia il server.
  4. Controlla nella Console che il messaggio non compaia più.

Buono a sapersi: lo stacktrace sottostante, cioè le righe rientrate con at …, mostra quale plugin è coinvolto. Accanto a com.vk.api compare infatti il nome del pacchetto del plugin.

Il plugin non riesce a distribuire il suo resource pack

Ecco come appare il messaggio:

java.io.IOException: HTTP 403 dla http://<Adresse>/<Pack>.zip
Failed to start resourcepack server: Server is not publicly reachable on <Adresse>:<Port>

Qual è la causa: alcuni plugin forniscono ai giocatori un resource pack personalizzato. Per farlo lo scaricano da un indirizzo, lo assemblano autonomamente o avviano un piccolo server web integrato da cui i giocatori possono scaricarlo. Uno di questi passaggi non è riuscito. I giocatori quindi non ricevono il pack e mancano le texture o le funzioni che dipendono da esso. Il server continua a funzionare.

Come risolvere:

  1. Leggi lo stato HTTP nel messaggio: 403 significa accesso negato, 404 significa file non trovato.
  2. Apri nel browser l'indirizzo del pack indicato nella configurazione del plugin. Deve avviare direttamente il download del file ZIP, senza mostrare pagine di anteprima o di accesso.
  3. Correggi l'indirizzo oppure carica il pack in una posizione che lo renda disponibile pubblicamente.
  4. Se il plugin usa un server web integrato, inserisci soltanto una porta assegnata al tuo server nel pannello e raggiungibile pubblicamente.
  5. Riavvia il server.

«accessToken=MISSING»: manca la chiave API o il token

Ecco come appare il messaggio:

Please set your <Dienst> API key
accessToken=MISSING
[BedrockVoiceChat] Config validation failed: useEmbeddedServer=false, bvcServer=MISSING, accessToken=MISSING

Qual è la causa: il plugin lavora con un servizio esterno e per questo ha bisogno di una chiave API o di credenziali di accesso. Una chiave API o un token identificano il plugin presso il servizio. Senza questi dati il plugin non funziona, mentre il resto del server continua a girare. Con BedrockVoiceChat, useEmbeddedServer=false indica la modalità operativa esterna: con bvcServer=MISSING manca anche l'indicazione del server per il servizio vocale.

Come risolvere:

  1. Leggi il messaggio completo e la guida del plugin: indicano i campi necessari e il servizio utilizzato.
  2. Ottieni la chiave o il token seguendo la guida del servizio. Per i servizi che gestisci in autonomia, usa le credenziali generate durante la loro configurazione.
  3. Apri in File la configurazione del plugin indicata e inserisci i valori mancanti. Con BedrockVoiceChat in modalità operativa esterna ti servono sia bvcServer sia accessToken. Mantieni il formato del file e l'indentazione previsti.
  4. Salva il file e riavvia il server.

Buono a sapersi: se in seguito il plugin segnala di non riuscire a leggere il file, consulta Il file di configurazione di un plugin contiene errori.

Il plugin premium non trova una chiave di licenza valida

Ecco come appare il messaggio:

No License Key Found!
Please enter a valid key in license.yml
Authentication failed! API key is invalid

Cosa c'è dietro: il plugin è un plugin premium o richiede una chiave del fornitore e non ne trova una valida nella sua configurazione. Di conseguenza si disattiva del tutto o disabilita alcune funzioni. Il server continua a funzionare, ma senza le funzioni di questo plugin.

Come risolvere:

  1. Recupera la chiave del tuo acquisto, ad esempio dal tuo account sul sito in cui hai comprato il plugin, oppure chiedila al fornitore.
  2. In File apri il file indicato dal messaggio, di solito plugins/<Plugin>/license.yml o plugins/<Plugin>/config.yml, e inserisci la chiave.
  3. Salva il file e riavvia il server.
  4. Se non hai una chiave, rimuovi il plugin in Plugin invece di lasciarlo in funzione con errori permanenti.

Buono a sapersi: scarica i plugin premium solo dal sito di vendita ufficiale. Le versioni provenienti da fonti non ufficiali, in cui il controllo della licenza è stato rimosso, contengono spesso malware.

Il bot Telegram del plugin non si avvia

Ecco come appare il messaggio:

Error removing old webhook

Cosa c'è dietro: all'avvio, un plugin con integrazione Telegram accede a Telegram tramite un bot. Prima rimuove un vecchio webhook, cioè un indirizzo salvato a cui Telegram invierebbe i nuovi messaggi. Questa operazione non è riuscita, di solito perché il token del bot non è valido o perché Telegram non era raggiungibile in quel momento. La funzione Telegram resta disattivata, mentre il server Minecraft continua a funzionare normalmente.

Come risolvere:

  1. In Telegram apri la chat con @BotFather e fatti mostrare il token del tuo bot oppure generane uno nuovo.
  2. In File apri la configurazione del plugin in plugins/<Plugin>/ e sostituisci il token. Copialo per intero: un token del bot inizia con un numero seguito da due punti.
  3. Salva il file e riavvia il server.
  4. Controlla nella Console che il messaggio non compaia più.

Buono a sapersi: se il messaggio compare una sola volta e sparisce all'avvio successivo, Telegram è stato irraggiungibile per poco tempo. In questo caso non devi cambiare nulla.

Il plugin non riesce a ottenere una propria porta di rete

Ecco come appare il messaggio:

Failed to bind to /<Adresse>:<Port>
[PlasmoVoice] Failed to start the udp server

Cosa c'è dietro: alcuni plugin aprono una propria porta di rete, ad esempio per una chat vocale come Plasmo Voice o per una pagina web con mappa o statistiche. L'indirizzo o la porta impostati non sono disponibili sul tuo server: la porta non gli è assegnata, è già occupata oppure nella configurazione è presente un indirizzo IP fisso che il server non può usare. La funzione del plugin resta disattivata, mentre il resto del server continua a funzionare.

Come risolvere:

  1. In File apri la configurazione del plugin in plugins/<Plugin>/ e cerca le voci relative a porta e indirizzo.
  2. Inserisci una porta assegnata al tuo server nel pannello e ancora libera.
  3. Lascia vuoto l'indirizzo oppure imposta 0.0.0.0. Significa: raggiungibile su tutte le interfacce di rete del server.
  4. Salva il file, riavvia il server e controlla nella Console che il messaggio non compaia più.

Buono a sapersi: una porta può essere aperta da un solo programma alla volta. Se due plugin usano la stessa porta, ciascuno deve averne una propria. Per saperne di più sulle porte: Porte di Minecraft e controllo degli errori di connessione.

“Address already in use”: porta occupata per la chat vocale, RCON o un servizio aggiuntivo

Ecco come appare il messaggio:

Unable to initialise RCON on <Adresse>:<Port>
Failed to start the udp server … Address already in use
[voicechat] Voice chat server error … java.net.BindException: Address already in use

Cosa c'è dietro: un plugin o un servizio aggiuntivo, come una chat vocale, una pagina web propria, Query o RCON, cerca di aprire una porta già occupata. Spesso nella sua configurazione è indicata la porta di gioco. Il problema può riguardare anche le mod di chat vocale su Fabric. Il server continua a funzionare e i giocatori possono entrare, solo questa funzione resta disattivata.

Come risolvere:

  1. Leggi nella Console le righe che precedono l'errore. Indicano il plugin o il servizio, ad esempio RCON o la chat vocale.
  2. In File apri la configurazione del plugin o della mod indicati. Per Query e RCON, query.port e rcon.port si trovano in server.properties.
  3. Inserisci una porta assegnata al tuo server che non sia la porta di gioco e che non sia usata da altri servizi aggiuntivi.
  4. Per Simple Voice Chat e altri plugin supportati, le procedure guidate in Plugin configurano automaticamente una porta libera.
  5. Salva, riavvia il server e controlla la Console.

Buono a sapersi: un semplice riavvio non basta finché resta impostata la stessa porta occupata. Per saperne di più: Porte di Minecraft e controllo degli errori di connessione.

DonatePay: carattere non valido nell'indirizzo della richiesta

Ecco come appare il messaggio:

java.net.URISyntaxException: Illegal character in query at index <Position>: <Adresse mit entferntem Token>

Cosa c'è dietro: l'integrazione DonatePay vuole controllare se ci sono nuove donazioni, ma non riesce a elaborare l'indirizzo creato per la richiesta. Un URI è un indirizzo strutturato; in questo caso la sua parte di query contiene un carattere non consentito. Di conseguenza il controllo delle donazioni non riesce, mentre il server Minecraft continua a funzionare.

Come risolvere:

  1. Apri la Console oppure logs/latest.log in File e controlla se lo stack trace menziona l'integrazione DonatePay.
  2. Verifica la configurazione del plugin in File. Confronta le credenziali inserite con le istruzioni e rimuovi eventuali spazi o virgolette copiati per errore.
  3. Aggiorna l'integrazione in Plugin oppure sostituisci in File il file che hai caricato tu. Riavvia completamente il server.
  4. Se il messaggio persiste, invia all'autore del plugin lo stack trace ripulito. Rimuovi tutti i valori dei token prima di condividerlo.

Il plugin degli zaini non riesce a usare il suo pacchetto di risorse

Ecco come appare il messaggio:

[ᴠᴢʙᴀᴄᴋᴘᴀᴄᴋ] Die URL der Datei '<Datei>.zip' ist ungültig!

Cosa c'è dietro: il plugin non riesce a usare un file del pacchetto di risorse impostato. L'indirizzo non è valido oppure il pacchetto esterno viene riconosciuto come danneggiato. Di conseguenza, gli zaini mostrano texture e font errati o mancanti; il server continua a funzionare.

Come risolvere:

  1. In File controlla nella configurazione del plugin quali file del pacchetto e indirizzo sono impostati.
  2. Confronta il file con le istruzioni della tua versione del plugin. Usa un indirizzo di download diretto valido e un archivio completo e compatibile.
  3. Riavvia completamente il server. Fai scaricare di nuovo al client il pacchetto corretto e controlla le texture degli zaini e i font.

libdatachannel: la connessione del canale dati o l'invio non riescono

Ecco come appare il messaggio:

[tel.schich.libdatachannel.LibDataChannel] SCTP connection failed
[tel.schich.libdatachannel.LibDataChannel] {anonymous}::wrap@320: Sending failed, errno=2
{anonymous}::wrap@320: Sending failed, errno=104

Cosa c'è dietro: libdatachannel è una libreria per le connessioni dati. SCTP indica il protocollo di trasmissione utilizzato. Una connessione non si stabilisce o non riesce più a inviare dati; la connessione del plugin o della mod interessati si interrompe. Il server di gioco continua a funzionare.

Come risolvere:

  1. Riprova la connessione interessata. Controlla se non riesce un singolo accesso o se falliscono più connessioni.
  2. Nella Console leggi le righe prima e dopo il messaggio. Associa la libreria al plugin o alla mod indicati lì.
  3. Confronta le relative impostazioni di rete e i requisiti con la documentazione. Controlla in particolare le porte previste e la raggiungibilità del sistema remoto.
  4. Controlla in Plugins o Mods se è disponibile un aggiornamento adatto. Se l'errore persiste, apri un ticket indicando l'orario e i messaggi correlati.

Netty: una notifica di rete raggiunge un executor già terminato

Ecco come appare il messaggio:

Failed to submit a listener notification task. Event loop shut down?
java.util.concurrent.RejectedExecutionException: event executor terminated

Cosa c'è dietro: Netty elabora le attività di rete in un ciclo di eventi. In questo caso il ciclo è già terminato mentre una notifica deve ancora essere messa in coda, quindi la notifica viene scartata. Durante l'arresto può comparire come errore secondario; a server avviato, invece, una funzione di rete potrebbe non funzionare correttamente.

Come risolvere:

  1. Controlla l'orario nella Console e confrontalo con l'avvio o l'arresto del server.
  2. Se l'errore si verifica durante il normale funzionamento, salva il messaggio completo da logs/latest.log insieme agli errori precedenti. Le righe di chiamata successive si chiamano stack trace e possono indicare il componente coinvolto.
  3. Controlla il componente associato in Plugins e la Versione del server per trovare aggiornamenti compatibili tra loro. Sostituisci i file a server fermo.
  4. Riavvia completamente il server e riprova la connessione interessata. Se l'errore persiste, apri un ticket indicando l'orario e il messaggio completo.

Lavalink non riesce a caricare un brano di YouTube senza accesso

Ecco come appare il messaggio:

dev.lavalink.youtube.AllClientsFailedException: All clients failed to load the item.
Client [<Client>] failed: This video requires login.

Cosa c'è dietro: la funzione musicale usa Lavalink, un servizio per caricare e riprodurre audio. La sua estensione per YouTube riceve come risposta che per il brano richiesto è necessario l'accesso. Il brano non viene caricato, ma il server di gioco continua a funzionare.

Come risolvere:

  1. Controlla se il brano è disponibile su YouTube senza accesso. Per fare un confronto, prova un altro brano disponibile pubblicamente.
  2. Leggi il messaggio completo nella Console o in logs/latest.log. Annota le versioni della mod musicale e della sua integrazione con YouTube.
  3. Consulta la documentazione di questi componenti per trovare aggiornamenti adatti. Ferma il server prima di sostituirli in Mods e poi riavvialo.
  4. Se il recupero continua a non funzionare, segnala la traccia dell'errore all'autore. Rimuovi dal rapporto i dati personali e le credenziali di accesso.

ForcePack: controlla il link al pacchetto di risorse

Ecco come appare il messaggio:

[ForcePack] Your URL has an invalid or unknown format.
URLs must have no redirects and use the .zip extension.

Cosa c'è dietro: ForcePack controlla il link di download impostato per il pacchetto di risorse. Il link non corrisponde al formato ZIP diretto previsto oppure il controllo non lo riconosce. ForcePack si avvia comunque, e il controllo può segnalare anche un link funzionante. Ciò che conta è se un client riesce davvero a scaricare il pacchetto.

Come risolvere:

  1. Prova il link configurato senza effettuare l'accesso. Deve fornire direttamente il file ZIP, senza pagine di anteprima né reindirizzamenti.
  2. Ferma il server e fai un backup della configurazione di ForcePack tramite File.
  3. Inserisci un link di download diretto adatto e riavvia il server. Poi prova a scaricare il pacchetto di risorse con un client.
  4. Se il download funziona già con il link segnalato, comunica all'autore del plugin il tipo di link e la versione di ForcePack.

e4mc non riesce a configurare la connessione tunnel

Ecco come appare il messaggio:

error in e4mc
bind(..) failed: Address family not supported by protocol

Cosa c'è dietro: e4mc non riesce ad aprire un socket di rete necessario perché la famiglia di indirizzi scelta non è supportata nell'ambiente di esecuzione. La connessione tunnel di e4mc non riesce, ma il server Minecraft vero e proprio può continuare a funzionare. Un socket è il punto di accesso alla rete di un programma. Questo messaggio è diverso da quello di una porta già occupata.

Come risolvere:

  1. Controlla nella Console che Address family not supported by protocol compaia direttamente nell'errore di e4mc.
  2. In Mods cerca una versione di e4mc adatta al tuo loader e le relative indicazioni per i server dedicati; prima di apportare modifiche, crea un backup in Backup.
  3. Se non usi il tunnel di e4mc, rimuovi la mod a server fermo e riavvia; se invece ti serve, apri un ticket indicando il messaggio di errore e l'orario.

La funzione musicale non riesce a recuperare un brano

Ecco come appare il messaggio:

Error in loading item <Musikanfrage>
FriendlyException: Something went wrong when looking up the track

Cosa c'è dietro: la libreria musicale Lavaplayer non riesce a individuare o caricare il brano richiesto. Questa richiesta musicale non va a buon fine, ma il server Minecraft e le altre funzioni di gioco continuano a funzionare. La traccia dell'errore mostra le chiamate di programma coinvolte. Spesso i dettagli sul provider si trovano nei messaggi precedenti della stessa richiesta.

Come risolvere:

  1. Nella Console controlla i messaggi immediatamente precedenti alla traccia dell'errore e se è stata inviata una ricerca o un link multimediale diretto.
  2. Prova un altro brano raggiungibile da una fonte supportata dalla mod musicale; controlla anche se il brano originale è disponibile pubblicamente.
  3. In Mods verifica che la mod musicale e le sue dipendenze abbiano versioni compatibili e, dopo ogni modifica, riavvia completamente il server.

Il link musicale non fornisce un formato audio supportato

Ecco come appare il messaggio:

URL resolution failed [UNKNOWN] url=<Medienlink> detail=FriendlyException: Unknown file format.

Cosa c'è dietro: la funzione musicale non riconosce alcun formato audio supportato nel link fornito. Il brano richiesto o la raccolta collegata non vengono quindi caricati, ma il server di gioco continua a funzionare. Una pagina web raggiungibile non è necessariamente un file audio riproducibile direttamente. Il provider deve poter essere gestito dall'integrazione musicale installata.

Come risolvere:

  1. Controlla il link e le fonti supportate dalla tua mod musicale; pagine di artisti, pagine di album e link abbreviati richiedono un'integrazione adatta.
  2. Prova un singolo brano raggiungibile pubblicamente con un formato di link esplicitamente supportato, invece di una pagina di panoramica.
  3. In Mods cerca aggiornamenti adatti della mod musicale e delle integrazioni delle sue fonti; dopo le modifiche riavvia il server e riprova il recupero.

Plasmo Voice non ha i dati della chiave per una connessione alla chat vocale

Ecco come appare il messaggio:

[PlasmoVoice] Failed to encode encryption data: <Fehler>
VoiceServerPlayerEntity(<Sitzungsdaten>) has empty public key

Cosa c'è dietro: Quando configura una connessione alla chat vocale, Plasmo Voice scambia dati delle chiavi. Una chiave pubblica è la parte con cui i dati di connessione vengono cifrati per il destinatario. In questa sessione manca, quindi il plugin non può preparare i dati. Il problema riguarda la chat vocale di questa connessione; Minecraft continua a funzionare.

Come risolvere:

  1. Fai uscire dal server il giocatore interessato e fallo rientrare. Controlla poi se la connessione vocale viene stabilita.
  2. Confronta le edizioni di Plasmo Voice su client e server con le indicazioni di compatibilità dell'autore. Aggiorna il plugin del server in Plugin a server fermo e aggiorna di conseguenza anche il client.
  3. Se l'errore persiste, leggi la traccia completa dell'errore in logs/latest.log tramite File. Comunica all'autore del plugin le versioni e i passaggi che portano all'errore, anonimizzando i dati di sessione.

ChunkVeil interrompe l'avvio perché la sua protezione non è attiva

Ecco come appare il messaggio:

[ChunkVeil] Strict startup policy is stopping the server because ChunkVeil could not protect it.

Cosa c'è dietro: ChunkVeil non riesce a configurare la sua protezione per la trasmissione delle sezioni del mondo. La sua regola di avvio rigorosa arresta quindi l'intero server. I giocatori potranno rientrare solo quando il server si avvierà correttamente. I messaggi di ChunkVeil precedenti spiegano quale parte della configurazione non riesce.

Come risolvere:

  1. Leggi i messaggi di ChunkVeil che precedono l'arresto nella Console o in logs/latest.log sotto File. Esegui /chunkveil verify se il server accetta ancora comandi.
  2. Controlla in Plugin e Versione se ChunkVeil e ProtocolLib sono compatibili con la versione del server in uso. Risolvi il problema con la dipendenza o l'impostazione indicata e fai un backup dei file prima di apportare modifiche.
  3. Riavvia completamente il server e controlla se ChunkVeil segnala che la protezione è attiva. Non aggirare la regola di protezione al posto di risolvere il problema.

ChunkVeil: la protezione runtime non è attiva

Ecco come appare il messaggio:

[ChunkVeil] Runtime protection is INACTIVE.

Cosa c'è dietro: ChunkVeil segnala che la sua protezione non è attiva durante il funzionamento del server. Manca quindi la protezione prevista per il traffico dei pacchetti relativi alle sezioni del mondo. La causa specifica è indicata nei messaggi diagnostici vicini. Se viene segnalata anche una regola di avvio rigorosa, questa può arrestare il server.

Come risolvere:

  1. Leggi nella Console o in logs/latest.log sotto File i messaggi di ChunkVeil prima e dopo questo avviso. Usa /chunkveil verify se il server accetta comandi.
  2. Confronta le versioni supportate di ChunkVeil e ProtocolLib in Plugin con la Versione del server. Correggi la causa indicata nel report diagnostico e fai un backup dei file prima di apportare modifiche.
  3. Riavvia completamente il server e controlla di nuovo lo stato della protezione. Se resta inattiva, comunica all'autore del plugin i messaggi diagnostici ripuliti dai dati sensibili e le versioni coinvolte.

Il tuo messaggio non è nell'elenco?

Leggi l'intero messaggio nella Console o in logs/latest.log, comprese le righe precedenti. Il nome tra parentesi quadre all'inizio della riga, ad esempio [DiscordSRV], di solito indica il plugin. Se manca, ti aiuta lo stacktrace: nelle righe rientrate con at … trovi nomi di pacchetti e cartelle che rimandano al plugin o alla mod. Quali chiavi, token o porte servano a un plugin è spiegato nella sua pagina del progetto. Prima di modificare la configurazione, crea un backup. Se non riesci a venirne a capo, apri un ticket e indica l'ora del messaggio.