Installazione

Questa pagina copre ciò di cui Verité ha bisogno per funzionare, i plugin opzionali con cui può lavorare e cosa succede al primo avvio. Per i passaggi di download e una breve panoramica, vedi la pagina iniziale. Il materiale qui approfondisce requisiti, dipendenze e comportamento al primo avvio.

Requisiti

Verité è pensato per i server Minecraft moderni e i loro fork comuni.

Verité non distribuisce una build separata per piattaforma oltre alla versione appropriata per il tuo server. Installa il file corretto per la tua versione di Minecraft e il software del tuo server, mettilo nella directory plugins/ e riavvia.

Su qualsiasi versione di Minecraft al di fuori dell'intervallo supportato, Verité si disabilita all'avvio e registra la versione in esecuzione insieme all'intervallo supportato. Verité 1.2.8 è l'ultima versione per Minecraft dalla 1.19 alla 1.21.5.

Libreria di runtime

Verité memorizza i suoi dati in un database H2 incorporato. H2 è dichiarato come libreria del plugin in plugin.yml:

libraries:
  - com.h2database:h2:2.4.240

Il tuo server risolve e scarica questa libreria automaticamente al caricamento su un class loader di libreria isolato. Non è richiesto alcun download manuale. Se la libreria non può essere risolta, Verité si disabilita anziché funzionare senza archiviazione, quindi tieni d'occhio la console al primo avvio.

Il database viene eseguito in modalità file incorporata senza socket di rete. È descritto in maggior dettaglio nella pagina Privacy e dati.

Dipendenze opzionali

Verité dichiara quattro dipendenze opzionali:

softdepend: [floodgate, PlaceholderAPI, LuckPerms, Skript]

Una dipendenza opzionale non è mai obbligatoria. Quando uno di questi plugin è presente, il server lo carica prima di Verité così che la funzionalità corrispondente possa attivarsi. Quando è assente, Verité funziona normalmente e la funzionalità semplicemente non esiste.

Primo avvio

La prima volta che Verité viene caricato prepara la propria cartella dei dati in plugins/Verite/. Durante questo primo avvio esso:

• Crea la cartella dei dati del plugin.
• Apre il database H2 incorporato (verite.mv.db) in quella cartella, creandolo se assente.
• Scrive il config.yml predefinito.
• Distribuisce le risorse del filtro chat in una sottocartella filter/.
• Registra comandi, listener e integrazioni per tutte le dipendenze opzionali installate.

Tieni d'occhio la console durante questo primo avvio. Conferma che Verité si carichi e che non appaiano avvertimenti o errori che indichino un problema di configurazione o compatibilità.

Output della console

Verité colora i messaggi della console in modo che gli errori si distinguano dalle normali righe di avvio. Gli errori sono rossi, i successi verdi e i conteggi sono mostrati nel colore del marchio Verité. Ogni messaggio è preceduto da [Verité].

Il colore viene aggiunto solo quando la console è in grado di mostrarlo. Verité controlla, in quest'ordine:

Quando il colore è disattivato i messaggi vengono scritti come testo semplice, senza lasciare codici di escape, così i file di log restano leggibili.

Due proprietà di sistema hanno la precedenza sul rilevamento, se occorre forzare un risultato:

-Dverite.console.colour=false
-Dverite.console.truecolour=false

La prima disattiva (o attiva) del tutto il colore. La seconda mantiene il colore ma passa da 24 bit alla tavolozza di base a 16 colori, cosa che vale la pena provare se la console mostra caratteri strani al posto dei colori.

Moduli

Verité è costruito da tre moduli, ciascuno attivabile in modo indipendente in config.yml. Tutti e tre sono abilitati per impostazione predefinita. Disabilita un modulo impostando il suo flag enabled su false; il resto del plugin continua a funzionare.

chat.filter:
  enabled: true

moderation:
  enabled: true

vanish:
  enabled: true

Aggiornamento automatico della configurazione

Quando Verité si aggiorna, può aggiungere nuove chiavi al tuo config.yml esistente così da non perdere le tue impostazioni. Questo è controllato nella sezione general:

general:
  auto.update.config: true

Con questo abilitato, le nuove chiavi di configurazione aggiunte in una release successiva vengono unite automaticamente nel tuo file. Questo non aggira gli aggiornamenti del tokenizer, che sono gestiti separatamente.

I file di risorsa del filtro chat (i file .eve) hanno il proprio interruttore, che è disattivato per impostazione predefinita:

chat.filter:
  auto.update.eve: false