Plugin sui server Minecraft; Gestisce il sistema di autorizzazione, economia, protezione, mercato, evento, reclamo, anti-cheat e molti sistemi speciali. Se uno dei plugin non è installato, una parte significativa del server potrebbe non funzionare.

Gli errori del plugin di solito si verificano nella console o logs/ultimo.log appare nel file. Gli errori più comuni; Impossibile caricare il plug-in, Versione API non supportata, dipendenza sconosciuta, Plugin.yml non valido e incompatibilità della versione Java.

1. Dove puoi vedere l'errore del plugin?

Se il plug-in non viene caricato, il primo posto in cui cercare è la console del server e il file latest.log.

tail -n 200 logs/latest.log

Per il monitoraggio in tempo reale:

tail -f logs/latest.log

Per cercare per nome del plugin:

grep -i "pluginadi" logs/latest.log

2. Errore di versione API non supportata

Questo errore indica che la versione dell'API Minecraft supportata dal plug-in non è compatibile con la versione del server.

Unsupported API version 1.20

Ad esempio, il plug-in potrebbe essere preparato per la versione 1.20, ma il tuo server potrebbe eseguire la versione 1.16.5. In questo caso il plugin potrebbe non essere caricato o funzionare in modo non corretto.

Soluzione:

• Controlla la versione di Minecraft supportata dal plugin.
• Scarica la versione del plugin compatibile con la versione del tuo server.
• Non aspettarti che i nuovi plugin funzionino su server molto vecchi.
• Se necessario, trova la versione appropriata dall'archivio della vecchia versione del plugin.

3. Errore di dipendenza sconosciuto

Alcuni plugin non funzionano da soli. Richiede prima l'installazione di un altro plugin. Questa si chiama dipendenza.

Unknown dependency Vault
Could not load plugin because dependency LuckPerms was not found

Ad esempio, i plugin economici spesso Volta se...o. I plugin di autorizzazione o di mercato potrebbero richiedere anche altri plugin di libreria.

Soluzione:

• Leggi i requisiti nella pagina del plugin.
• Scarica il plug-in delle dipendenze mancante.
• Assicurati che il plug-in delle dipendenze sia compatibile anche con la versione del tuo server.
• Riavviare completamente il server.

4. Errore plugin.yml non valido

All'interno del file jar del plugin plugin.yml Se il file è danneggiato, mancante o errato, non è possibile installare il plug-in.

Invalid plugin.yml
Plugin does not contain a plugin.yml

Questo di solito si verifica quando:

• È stato scaricato il file sbagliato.
• Al posto del plugin, il codice zip è stato inserito nella cartella dei plugin.
• Il file Jar è danneggiato.
• Il plugin è stato confezionato in modo errato dallo sviluppatore.

Come soluzione, il plugin è corretto. .vaso Il file dovrebbe essere scaricato. Il source-code.zip scaricato da GitHub non deve essere inserito direttamente nella cartella dei plugin.

5. Incompatibilità della versione Java

La versione e i plugin di Minecraft richiedono versioni Java specifiche. Se viene utilizzata la versione Java errata, il plug-in o il server potrebbero non aprirsi affatto.

java -version

Errore comune:

UnsupportedClassVersionError

Questo errore indica che il plugin è stato compilato con Java più recente, ma sul server viene utilizzato Java precedente.

Logica generale:

• Le versioni precedenti di Minecraft spesso richiedono Java precedente.
• Le versioni più recenti di Minecraft richiedono Java più recente.
• È necessario verificare i requisiti Java nella descrizione del plug-in.
• La versione Java selezionata nel pannello hosting deve essere verificata.

6. Il file del plugin è nella cartella corretta?

File plugin sui server Bukkit, Spigot e Paper plugin viene gettato nella cartella.

ls plugins/

Il file del plugin dovrebbe essere così:

plugins/PluginAdi.jar

I plugin lasciati in zip, rar, codice sorgente o cartelle spesso non funzionano.

7. Conflitti tra plugin

Due plugin che svolgono lo stesso lavoro potrebbero entrare in conflitto tra loro. Ad esempio, due diversi plugin di chat, due diversi plugin di economia o due diversi sistemi di reclamo potrebbero tentare di gestire gli stessi eventi.

Sintomi del conflitto:

• Il plugin è installato ma i suoi comandi non funzionano.
• Un plugin sovrasta l'impostazione di un altro.
• Si verifica un conflitto o un'eccezione di eventi nella console.
• I giocatori non possono utilizzare i comandi anche se hanno l'autorizzazione.
• Il server si comporta diversamente dopo il riavvio.

Per trovare una soluzione, è possibile testare i plugin disabilitandoli uno per uno. Tuttavia, prima di farlo sul server live, è necessario effettuare un backup e preferire orari di gioco bassi.

8. L'errore di configurazione può impedire l'apertura del plugin

Alcuni plugin non si apriranno se è presente un errore YAML nel file di configurazione. I rientri degli spazi bianchi sono particolarmente importanti nei file YAML.

Errori comuni:

• Utilizzo del carattere di tabulazione
• Non lasciare uno spazio dopo i due punti
• Scrivere testo che richiede virgolette senza virgolette
• Corruzione del file dovuta a caratteri turchi o simboli speciali
• Salvataggio del file di configurazione mancante

Se è presente un file di configurazione errato, la cartella del plugin può essere temporaneamente rinominata per eseguire il backup della cartella del plugin e ricreare la configurazione.

Errori comuni

• Installazione di plugin non compatibili con la versione del server
• Non installare i plugin delle dipendenze mancanti
• Confondere il file zip sorgente GitHub come un plugin
• Non controllo della versione Java
• Tentativo di installare un plugin con /reload
• Utilizzo delle schede nei file di configurazione YAML

Domande frequenti

Il plugin è nella cartella plugins ma non funziona, perchè?
Potrebbe trattarsi di incompatibilità di versione, dipendenza mancante, incompatibilità Java o errore di configurazione. È necessario esaminare il file latest.log.

Cosa significa UnsupportedClassVersionError?
Il plugin è appena stato compilato con Java. La versione Java utilizzata sul server è obsoleta.

È sicuro usare/ricaricare?
Non è consigliato per molti plugin. Un riavvio completo è più sicuro per l'installazione, la rimozione e le modifiche importanti della configurazione dei plug-in.

Raccomandazioni per la sicurezza e il funzionamento

• Scarica plugin da fonti affidabili.
• Prima di aggiungere il plugin al server live, provalo sul server di prova.
• Eseguire il backup della cartella dei plugin prima di ogni aggiornamento del plugin.
• Riduci la superficie di attacco rimuovendo i plugin non necessari.
• Controlla regolarmente i log dei plugin.

Questo articolo è stato preparato appositamente per PvPServer.