# 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](index.md). Il materiale qui approfondisce requisiti, dipendenze e comportamento al primo avvio.

## Requisiti

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

| Requisito | Dettaglio |
| --- | --- |
| Piattaforma server | Paper, Purpur, Folia o Spigot |
| Versione di Minecraft | Dalla 1.21.6 alla 26.3 |
| Livello API | Compilato per la versione API 1.21.6 |
| Folia | Supportato |
| Java | La versione di Java richiesta dal software del tuo server per la versione di Minecraft che hai scelto |

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.

!!! note "Versione di Java"
    Verité segue il requisito Java del server su cui lo esegui. Le versioni più recenti di Minecraft richiedono release più recenti di Java. Se il tuo server si avvia, Verité ha la versione di Java di cui ha bisogno.

## Libreria di runtime

Verité memorizza i suoi dati in un database [H2](https://www.h2database.com/) incorporato. H2 è dichiarato come libreria del plugin in `plugin.yml`:

```yaml
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](page:privacy).

## Dipendenze opzionali

Verité dichiara quattro dipendenze opzionali:

```yaml
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.

| Plugin | Cosa abilita |
| --- | --- |
| Floodgate | Migliora la gestione dei giocatori Bedrock che entrano tramite Floodgate. |
| PlaceholderAPI | Espone lo stato di vanish ad altri plugin come placeholder sotto l'identificatore `verite`. Quando PlaceholderAPI è assente, i placeholder non vengono mai registrati. |
| LuckPerms | Fornisce i pesi dei gruppi per la moderazione consapevole dei ranghi, così lo staff non può punire ranghi uguali o superiori. Questo è controllato da `use.rank.weights` nella sezione moderation della configurazione. Gli operatori sono sempre trattati come il rango più alto. |
| Skript | Rende la sintassi del filtro chat di Verité disponibile automaticamente agli script. Vedi la guida [Integrazione Skript](page:developers/skript). |

!!! note "Sistemi di chat personalizzati"
    Se un altro plugin intercetta e consegna la chat da solo, Verité potrebbe non vedere mai il messaggio da filtrare. La guida [Integrazione della chat personalizzata](page:developers/wiring) spiega come far passare i messaggi attraverso Verité in quel caso.

## 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:

| Controllo | Effetto |
| --- | --- |
| `NO_COLOR` è impostata (con qualsiasi valore) | Il colore viene disattivato. È lo standard [NO_COLOR](https://no-color.org/), rispettato da molti strumenti da riga di comando. |
| `TERM` è `dumb` | Il colore viene disattivato. |
| Windows senza un terminale compatibile con ANSI | Il colore viene disattivato, a meno che non venga rilevato Windows Terminal o ANSICON. |
| Qualsiasi altro caso | Il colore viene attivato. |

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.

| Modulo | Chiave di configurazione | Scopo |
| --- | --- | --- |
| Veritédoux | `chat.filter.enabled` | Filtraggio della chat e controlli sui contenuti. |
| Veritésauver | `moderation.enabled` | Moderazione, punizioni e intelligence sugli account. |
| Veritévoiler | `vanish.enabled` | Vanish dello staff. |

```yaml
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`:

```yaml
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:

```yaml
chat.filter:
  auto.update.eve: false
```

!!! warning "Voci del filtro personalizzate"
    Quando `auto.update.eve` è abilitato, i file `.eve` vengono sostituiti con versioni aggiornate quando vengono aggiunte nuove voci, e ogni voce personalizzata che hai aggiunto viene sovrascritta o scartata. Lascialo disattivato se gestisci le tue voci.