Configurare la whitelist del server Minecraft: consenti solo gli amici

Con una whitelist Minecraft limiti il tuo server ai giocatori espressamente autorizzati. È utile per mondi survival privati, progetti di costruzione, eventi o community in cui vuoi mantenere il controllo sugli accessi. I punti decisivi sono tre: white-list=true, nomi giocatore gestiti correttamente e enforce-whitelist=true, così le modifiche vengono applicate in modo affidabile.

Requisiti

Ti serve l'accesso alla console del server, i permessi OP in gioco oppure l'accesso al file server.properties. Inoltre dovresti conoscere i nomi Minecraft esatti dei giocatori. Per gli account Java di solito basta il nome giocatore. Se i giocatori Bedrock entrano tramite Geyser, il nome può comparire con un prefisso a seconda della configurazione di Geyser; nell'esempio di partenza viene usato un punto.

Se stai configurando il server da zero, ti aiuta la guida di approfondimento Noleggiare e configurare un server Minecraft: guida completa 2026. Per altri setup coop con una logica di accesso simile trovi anche Noleggiare e configurare un server Valheim: guida coop 2026.

Configurare la whitelist Minecraft

Che cos'è la whitelist?

La whitelist è un controllo di accesso per il tuo server. Possono entrare solo i giocatori presenti nella lista. Non sostituisce la moderazione, ma impedisce ad account sconosciuti di entrare semplicemente tramite l'indirizzo del server. Per l'hosting multi-game a pagamento è particolarmente pratico, perché puoi separare in modo più chiaro accesso al server, casi di supporto e procedure operative: chi non è nella lista non entra.

Microsoft documenta il relativo comando Bedrock come /allowlist; lì /whitelist viene indicato come alias e vengono descritte le azioni add, remove, list, off, on e reload: Microsoft Learn su allowlist/whitelist. Per i server Java, le voci server.properties e i comandi /whitelist mostrati sotto restano la base pratica.

Attivare la whitelist

Nel file server.properties:

white-list=true
enforce-whitelist=true

Già che sei in server.properties: la riga motd definisce la voce del tuo server nella lista server; puoi renderla colorata con il nostro generatore MOTD gratuito.

Oppure con un comando in-game:

/whitelist on

Se modifichi direttamente il file, ferma prima il server oppure riavvialo dopo. Le modifiche tramite comandi sono più comode durante il funzionamento, perché non devi aprire ogni volta il file.

Aggiungere giocatori

/whitelist add <Spielername>

Per i giocatori Bedrock tramite Geyser:

/whitelist add .<BedRockName>

Fai attenzione alla grafia. Se un giocatore non riesce a entrare anche se lo hai aggiunto, confronta il nome con quello visualizzato nel tentativo di login o nei log del server. Nei setup con Geyser è particolarmente importante verificare se viene usato un prefisso e come vengono gestite maiuscole e minuscole.

Gestire la whitelist

Usa /whitelist list dopo ogni modifica importante. Così individui subito errori di battitura o nomi inseriti accidentalmente due volte. Se rimuovi un giocatore, enforce-whitelist=true è importante affinché l'esclusione non diventi rilevante solo al prossimo tentativo di connessione.

whitelist.json

La whitelist viene salvata in whitelist.json:

[
  {
    "uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "name": "NomeGiocatore"
  }
]

Modifica questo file solo se sai cosa stai facendo. Per l'uso normale, i comandi sono più sicuri perché il server gestisce correttamente nomi e UUID. Se modifichi il file manualmente, usa poi /whitelist reload oppure riavvia il server.

Controllare il risultato

Controlla prima con /whitelist list se sono presenti tutti i giocatori desiderati. Poi un giocatore inserito dovrebbe riuscire a entrare. Un account non inserito dovrebbe essere rifiutato. Controlla anche la console del server: lì vedi se il tentativo di join fallisce per la whitelist, per un nome errato o per un altro problema.

Per i progetti privati è utile una breve routine: aggiungere il giocatore, testare il join, visualizzare la lista, documentare la modifica. Soprattutto con più admin, questo evita che le richieste di supporto restino poco chiare in seguito.

Risoluzione dei problemi

Il giocatore è nella lista, ma non riesce a entrare

Controlla il nome esatto, la modalità di gioco e possibili prefissi con Geyser. Nel dubbio rimuovi la voce con /whitelist remove <name> e poi aggiungila di nuovo.

I giocatori rimossi restano online

Imposta enforce-whitelist=true e ricarica la lista con /whitelist reload. Senza questa impostazione, a seconda dello stato del server, i giocatori rimossi possono restare connessi fino alla disconnessione.

Le modifiche nel file non vengono applicate

Se hai modificato manualmente server.properties o whitelist.json, ricarica la whitelist oppure riavvia il server in modo controllato. Verifica anche di aver modificato davvero il file dell'istanza server attiva.

Confondere OP e whitelist

I permessi da operatore sono diritti di amministrazione, non una vera lista di accesso. Mantieni pochi OP e gestisci la whitelist separatamente. Così resta chiaro chi può amministrare e chi può solo giocare.

Consigli

• Enforce Whitelist: attiva enforce-whitelist=true affinché i giocatori vengano espulsi quando vengono rimossi dalla lista
• Ops: gli operatori (OP) possono entrare anche senza whitelist se enforce-whitelist è disattivato
• Automazione: usa plugin come EasyWhitelist per una gestione basata sul web

Controllo, limiti e ritorno sicuro

La guida “Configurare la whitelist del server Minecraft: consenti solo gli amici” vale per il tipo di server descritto nell'articolo e per lo stato delle versioni visibile al momento del controllo. Nomi dei menu, versioni disponibili, compatibilità di mod o plugin e risorse necessarie possono cambiare dopo gli aggiornamenti. Per questo non trasferire valori su un'altra versione di gioco, loader o server senza verificarli.

Prima di modificare mondo, salvataggio, configurazione o estensioni, crea un backup dei file interessati. Poi modifica solo un passaggio collegato alla volta e controllalo con la stessa versione client e server con cui vorrai giocare in seguito.

Un singolo test riuscito non è una garanzia di prestazioni o disponibilità. Dimensione del mondo, mod, plugin, numero di giocatori, percorso di rete e carico simultaneo possono cambiare il risultato. Documenta versione, modifica e risultato del test, così potrai ricostruire eventuali differenze successive.

FAQ

Devo riavviare dopo ogni modifica?

Non necessariamente. Se usi comandi come /whitelist add, /whitelist remove o /whitelist reload, puoi gestire la lista mentre il server è in esecuzione. Dopo modifiche manuali ai file, un reload o un riavvio è sensato.

La whitelist è meglio di una password?

Per Minecraft la whitelist è il metodo più comune, perché autorizza account specifici. Una password non protegge da dati di accesso condivisi, mentre una whitelist è legata ai nomi giocatore o agli account.

Dovrei attivare sempre enforce-whitelist=true?

Per i server privati di solito ha senso. L'impostazione fa sì che i giocatori rimossi non restino online dopo un reload, anche se non sono più nella lista.

La whitelist funziona con mod e plugin?

Sì, la whitelist di base è una funzione del server. I plugin possono offrire una gestione aggiuntiva, ma dovrebbero essere scelti consapevolmente e mantenuti aggiornati.

Cosa faccio con i giocatori Bedrock tramite Geyser?

Controlla come il tuo setup Geyser mappa i nomi Bedrock. Nell'esempio viene usato .<BedRockName>. Se il join fallisce, controlla il nome effettivamente mostrato in console o nei log.