Come Usare il Generatore di Whitelist per Minecraft
Il generatore whitelist.json è uno strumento semplice che trasforma un elenco di nomi utente Minecraft in un file whitelist.json formattato correttamente. Puoi incollare i nomi utente uno per riga o separati da virgole. Lo strumento rimuove automaticamente i duplicati e taglia gli spazi extra. Una volta generato, puoi copiare il JSON o scaricarlo direttamente. Questo file è essenziale per i proprietari di server che vogliono limitare l'accesso solo ai giocatori approvati.Per i server in modalità offline (cracked o non premium), lo strumento usa l'algoritmo ufficiale OfflinePlayer UUID. Questo UUID è derivato dal nome utente del giocatore usando il metodo Java UUID.nameUUIDFromBytes. È importante usare questo formato esatto perché il server si aspetta UUID offline in whitelist.json. Se usi UUID online su un server offline, la whitelist non corrisponderà agli UUID in-game dei giocatori e verranno espulsi.Per i server in modalità online (premium o autenticati Mojang), lo strumento può risolvere ogni nome utente al profilo Mojang UUID corrente. Questo richiede una connessione internet e usa l'API Mojang. Lo strumento recupererà l'UUID per ogni nome e genererà un whitelist.json con gli UUID online corretti. Nota che se un nome utente è stato cambiato, l'UUID rifletterà il profilo corrente, non il vecchio nome. Usa sempre il nome utente corrente per la modalità online.Le differenze di versione contano: In Minecraft 1.7.9 e precedenti, il formato whitelist.json usava un semplice array di nomi utente. Da 1.8 in poi, il formato è cambiato in un array di oggetti con campi 'uuid' e 'name'. Questo generatore produce sempre il formato moderno, che funziona per tutte le versioni da 1.8 alla più recente. Se gestisci un server più vecchio, potresti dover convertire il file manualmente, ma la maggior parte dei server moderni usa il formato a oggetti.Consigli pratici: fai sempre un backup del tuo whitelist.json esistente prima di sostituirlo. Dopo la generazione, posiziona il file nella directory principale del server (dove si trova server.properties). Poi esegui il comando 'whitelist reload' nella console del server o usa il comando in-game '/whitelist reload' se hai i permessi da operatore. Testa con un account non in whitelist per assicurarti che la whitelist sia attiva. Ricorda di impostare 'white-list=true' in server.properties affinché la whitelist abbia effetto.
Gli UUID online e gli UUID offline non sono intercambiabili
Un server Java in modalità online identifica un account a pagamento con l'UUID restituito dai servizi Mojang. Un server in modalità offline deriva un UUID diverso basato sul nome, quindi copiare una whitelist offline in un server online può fallire anche quando il nome utente sembra corretto. Abbina il metodo UUID alla modalità di autenticazione del server e rigenera il file se tale modalità cambia.
Installa il file senza perdere i giocatori esistenti
Ferma il server o usa i suoi comandi whitelist prima di sostituire whitelist.json. Se il server contiene già giocatori approvati, unisci quelle voci invece di sovrascrivere il file alla cieca. Mantieni un JSON valido con un nome e un UUID univoci per ogni voce, quindi avvia il server ed esegui /whitelist reload se il tuo software server lo supporta. Conserva un backup prima di modificare un server di produzione.
Domande Comuni
Qual è la differenza tra UUID in modalità offline e online?
Gli UUID in modalità offline sono generati dal nome utente del giocatore usando un algoritmo fisso, quindi sono sempre gli stessi per quel nome. Gli UUID in modalità online sono assegnati da Mojang a ogni account premium e sono unici per l'account, non per il nome utente. Se un giocatore cambia il proprio nome, il suo UUID online rimane lo stesso, ma il suo UUID offline cambia perché è basato sul nome. Per i server offline, devi usare UUID offline; per i server online, usa UUID online.
Posso usare questo generatore per un server con giocatori sia online che offline?
No, un server funziona in modalità online o offline, non entrambe. Se imposti online-mode=true in server.properties, tutti i giocatori devono avere account premium e devi usare UUID online. Se online-mode=false, tutti i giocatori sono trattati come offline e devi usare UUID offline. Mescolare tipi di UUID in whitelist.json causerà l'espulsione dei giocatori perché il loro UUID in-game non corrisponderà alla voce della whitelist.
Perché la mia whitelist non funziona dopo aver incollato il JSON generato?
Le ragioni comuni includono: hai dimenticato di impostare white-list=true in server.properties, hai posizionato il file nella cartella sbagliata (deve essere nella stessa directory di server.properties), non hai eseguito 'whitelist reload' dopo aver sostituito il file, o hai usato la modalità UUID sbagliata (offline vs online). Inoltre, assicurati che il JSON sia valido, senza virgole finali o parentesi mancanti. Il generatore produce JSON valido, ma se lo modifichi manualmente, ricontrolla la sintassi.
Il generatore supporta nomi utente con caratteri speciali o numeri?
Sì, i nomi utente Minecraft possono contenere lettere, numeri e trattini bassi. Il generatore accetta qualsiasi formato di nome utente valido. Tuttavia, per la modalità offline, l'algoritmo UUID funziona con qualsiasi stringa, quindi anche nomi insoliti produrranno un UUID coerente. Per la modalità online, l'API Mojang restituirà un errore se il nome utente non esiste o non è valido. Lo strumento salterà i nomi non validi e mostrerà un avviso, così puoi correggerli.
Posso usare questo strumento per aggiungere giocatori a un whitelist.json esistente?
Il generatore crea un nuovo whitelist.json da zero. Se vuoi aggiungere giocatori a una whitelist esistente, puoi copiare le voci esistenti e incollarle insieme ai nuovi nomi utente nel campo di input. Lo strumento le unirà e deduplicherà. Tuttavia, fai attenzione: se usi la modalità online, lo strumento recupererà nuovamente gli UUID per tutti i nomi, il che potrebbe aggiornare le voci se un giocatore ha cambiato nome. Per la modalità offline, gli UUID sono deterministici, quindi l'unione è sicura.