Krak Server

Configuralo in 6 passi

Ti serve la macchina su cui gira il tuo server Minecraft (un VPS, un server dedicato o un PC di casa) e Krak Multiplayer sul telefono o sul PC. Scrivi un solo comando sulla macchina; tutto il resto avviene nell’app.

1. Avvia come al solito il tuo server Minecraft su quella macchina: un Bedrock Dedicated Server, un server Java o Java con Geyser.
2. Apri un terminale su quella macchina come amministratore. Windows: fai clic con il tasto destro sul pulsante Start e scegli Terminale (amministratore) o Windows PowerShell (amministratore). Linux: apri un terminale o collegati via SSH.
3. Copia qui sotto il comando di installazione per il tuo sistema (il pulsante Copia), incollalo nel terminale e premi Invio. Su Linux, scrivi la tua password se sudo la chiede.
4. Aspetta fino a un minuto. Il comando scarica Krak Server, lo controlla, lo installa e mostra un grande codice di abbinamento come 7Q4M-X2PA e un link. Lì non devi scrivere nient’altro.
5. Sul telefono o sul PC apri Krak Multiplayer, tocca il pulsante +, poi Ospita un server remoto, e inserisci il codice (o apri il link). Controlla il nome del server e approva.
6. Scegli quale server Minecraft della macchina condividere e come quale mondo, poi Salva. Il tuo mondo è online per i tuoi amici ogni volta che la macchina è accesa.

Installa su Linux

Incolla questo in un terminale e premi Invio (sudo potrebbe chiederti la password):

curl -fsSL https://krak-mp.cc/download/server/install.sh | sudo sh

Lo script sceglie la build per il tuo processore, ne controlla lo SHA-256, installa Krak Server come servizio di sistema krak-server, lo avvia e mostra il codice di abbinamento. In seguito, sudo krak-server status lo mostra di nuovo. A mano: scarica l’archivio per il tuo processore dalla pagina di download, confronta il suo SHA-256, estrailo con tar xzf ed esegui sudo ./krak-server install. Eseguire di nuovo l’installer aggiorna Krak Server.

Installa su Windows

Apri PowerShell come amministratore (tasto destro sul pulsante Start, Terminale (amministratore)), incolla questo e premi Invio:

irm https://krak-mp.cc/download/server/install.ps1 | iex

Questo installa il servizio Windows Krak Server, che parte con Windows e si riavvia dopo un errore, aggiunge krak-server.exe al PATH e mostra il codice di abbinamento. In seguito, krak-server.exe status in un qualsiasi nuovo terminale da amministratore lo mostra di nuovo; il programma è in C:\Program Files\Krak Server.

Per provarlo prima senza installarlo: scarica lo zip, estrailo ed esegui krak-server.exe in una console. Si abbina e ospita finché non lo chiudi.

Cosa fa

Krak Server accede con un codice di abbinamento, mai con la tua password. Trova i server Bedrock e Java sulla stessa macchina e condivide quelli che scegli nell’app come mondi Krak. I giocatori ci entrano da Krak Multiplayer come in qualsiasi altro mondo: il server appare nell’elenco LAN di Minecraft.

Il traffico di gioco passa dal relay di Krak. I giocatori non vedono mai l’indirizzo IP del server e il server non vede mai il loro. Krak Server non apre porte e non richiede port forwarding: si collega solo in uscita a krak-mp.cc.

Controlli il server nell’app: tocca +, poi Ospita un server remoto, oppure apri I miei mondi, dove sono elencati i tuoi server. Lì scegli cosa ospitare, lo avvii e lo fermi, e vedi i suoi giocatori, le richieste di accesso, espulsioni e ban e il suo stato. Quella schermata si chiama Controllo remoto, così non la confondi mai con l’hosting sul tuo dispositivo.

Requisiti

1. Linux su x86_64 o ARM64 (systemd per il servizio sempre attivo), oppure Windows 10, 11 o Server 2019 e successivi su x64.
2. Un Bedrock Dedicated Server, un server Java (Paper, Fabric e altri) o un server Java con Geyser sulla stessa macchina.
3. Un account Krak Multiplayer con email confermata o accesso con Google, e l’app 0.8.5 o successiva per abbinare e controllare il server (il pulsante + dalla 0.8.6).
4. Circa 15 MB di disco e 40 MB di memoria. Accanto al server di gioco, Krak Server usa pochissima CPU.

Abbinalo al tuo account

1. Il comando di installazione mostra il codice di abbinamento alla fine. In seguito, o quando il codice è scaduto, esegui sudo krak-server status sulla macchina (su Windows: krak-server.exe status in un terminale da amministratore).
2. In Krak Multiplayer tocca +, poi Ospita un server remoto, e scrivi il codice, oppure apri il link sul telefono. Nell’app 0.8.5: Profilo, I miei server, Aggiungi un server.
3. Controlla nome, sistema e rete del server, poi approva. Il codice vale per 10 minuti; poi il server ne mostra uno nuovo.

Approva solo un codice mostrato da un server che controlli tu. Chi ti chiede un codice vuole ospitare a nome tuo.

Scegli cosa ospitare

Apri il server (in I miei mondi, oppure + e poi Ospita un server remoto) e tocca Ospita su questo server. Scegli un server trovato sulla macchina, poi uno dei tuoi Mondi locali o uno nuovo. Nome, descrizione, icona, accesso e le altre impostazioni del mondo si modificano nell’app come al solito.

Un account ospita un mondo alla volta, con o senza Krak Plus: un mondo sul telefono o sul PC, un server ospitato tramite l’app o un mondo su un Krak Server. Un server cross-play (Paper con Geyser) è un unico mondo con entrambe le edizioni. Puoi abbinare fino a 2 server, o 7 con Krak Plus, e tenere un mondo su ciascuno: attiva l’hosting per quello che vuoi adesso. Con Krak Plus il tuo server esterno può restare in elenco nel frattempo, a meno che non sia lo stesso server.

L’approvazione degli ingressi funziona, ma le richieste scadono dopo 2 minuti. Per un server che resta acceso mentre dormi, disattiva l’approvazione e usa invece le impostazioni di accesso del mondo e i ban.

Impostazioni di Bedrock Dedicated Server

I giocatori Krak entrano dall’elenco LAN, quindi il server deve accettare giocatori in LAN. In server.properties imposta:

enable-lan-visibility=true
online-mode=false
allow-list=false

Con online-mode=false il server non controlla l’accesso Xbox. Se anche la porta del server è aperta su internet, chi si collega direttamente può entrare con qualsiasi nome, anche quello di un operatore. Tieni la porta Bedrock chiusa a internet, oppure accetta giocatori diretti non verificati.

Su ogni macchina solo un server Bedrock può essere visibile in LAN: occupa la porta UDP 7551. Minecraft 1.26.52 e successivi fanno entrare i giocatori Krak solo così, quindi un secondo server Bedrock sulla stessa macchina non può essere condiviso: Krak Server non lo ospita e l’app spiega perché. Ferma l’altro server, oppure attiva RakNet sul secondo. Riavvia il server dopo aver cambiato queste impostazioni.

Server Java

Un server Java non richiede nulla di speciale: Krak Server si collega alla porta del server sulla stessa macchina. Su un server con online-mode i giocatori hanno bisogno di Minecraft: Java Edition come al solito.

Geyser: giocatori Bedrock su un server Java

Con Geyser su Paper, Spigot o un proxy, i giocatori Bedrock entrano dalla porta Bedrock di Geyser, e Krak Server condivide quella porta come un server Bedrock. Un Geyser con le impostazioni predefinite respinge ogni giocatore Bedrock che arriva da Krak: vede “Please log into Xbox”, perché entra come partita LAN, senza il controllo dell’accesso Xbox che Geyser si aspetta. Krak Server non vede questo rifiuto, quindi l’app non può avvisarti. Imposta questo nel config.yml di Geyser (plugins/Geyser-Spigot/config.yml su Paper e Spigot):

validate-bedrock-login: false

Poi riavvia il server. Geyser non controlla più l’accesso Xbox dei giocatori Bedrock: tieni la sua porta Bedrock (19132 di default) chiusa a internet, altrimenti chi si collega direttamente può entrare con qualsiasi nome Bedrock. A Krak non serve nessuna porta aperta.

I giocatori Java non sono coinvolti, e il server Java può tenere online-mode=true. Con Floodgate, i giocatori Bedrock entrano senza un account Java; senza Floodgate, Geyser chiede a ogni giocatore Bedrock di accedere con un account Java.

Krak raggiunge Geyser tramite RakNet. Minecraft 26.60 dovrebbe eliminare gli ingressi via RakNet, quindi i giocatori Bedrock su 26.60 potrebbero non riuscire a entrare tramite Krak finché Geyser non li supporterà.

Docker

Avvia il container del server di gioco con la rete dell’host (--network host), così Krak Server, installato sull’host, vede la sua scoperta LAN e le sue porte.

Impostazioni

Krak Server legge /etc/krak-server/config.json su Linux e %ProgramData%\Krak Server\config.json su Windows. Ogni chiave è facoltativa e le chiavi sconosciute vengono rifiutate. Controlla il file con krak-server config check e riavvia il servizio dopo una modifica.

name

Il nome mostrato nell’app. Predefinito: il nome host della macchina.

allow

Le porte che l’app può condividere: bedrockPorts e javaPorts. Predefinito: gli intervalli abituali, Bedrock da 19132 a 19140 e Java da 25565 a 25570. Un server su un’altra porta viene condiviso solo dopo che hai aggiunto qui la sua porta, sulla macchina stessa.

updates

mode: auto (predefinito), notify o off; window: l’ora locale in cui un aggiornamento automatico può riavviare Krak Server (predefinito 04:00-06:00).

relay

preferred: un relay da usare sempre; null sceglie il migliore.

publicAddress

Un indirizzo che l’app suggerisce quando attivi un indirizzo pubblico per il mondo.

logLevel, logFormat

debug, info, warn o error; text o json.

limits

memoryMB: il limite di memoria di Krak Server (predefinito 128).

Aggiornamenti

Krak Server cerca aggiornamenti firmati ogni 6 ore e li installa da solo: nella finestra di aggiornamento, oppure appena nessuno sta giocando o l’aggiornamento è obbligatorio. Il mondo ospitato si riavvia e i giocatori rientrano dall’elenco LAN. Nell’app, Aggiorna ora installa subito un aggiornamento.

Su Linux il servizio installa l’aggiornamento quando si riavvia, in pochi secondi. Su Windows lo installa entro 15 minuti l’attività pianificata Krak Server\Apply update: viene eseguita come SYSTEM, ferma il servizio, sostituisce il programma, lo riavvia e controlla che la nuova versione funzioni. Se la nuova versione non si avvia, torna quella precedente. krak-server status mostra un aggiornamento in attesa e quando l’attività è stata eseguita l’ultima volta.

Per installare subito un aggiornamento su Linux:

sudo krak-server update

Su Windows, in PowerShell come amministratore (con il percorso completo funziona in qualsiasi finestra):

& "C:\Program Files\Krak Server\krak-server.exe" update

Eseguire di nuovo il comando di installazione aggiorna anche Krak Server. Mantiene l’abbinamento e le impostazioni e ricrea l’attività di aggiornamento di Windows, per esempio dopo un’installazione con --no-auto-update.

Stato e log

krak-server status mostra a quale account è abbinato il server, il codice di abbinamento mentre aspetta, la connessione, ogni mondo ospitato e i suoi giocatori. Su Linux i log sono nel journal:

sudo krak-server status
journalctl -u krak-server -f

Su Windows si trovano in %ProgramData%\Krak Server\logs. I log non contengono mai token, chiavi o indirizzi dei giocatori.

Rimuovi un server

Nell’app: apri il server (I miei mondi), il suo menu, Rimuovi il server. Il server smette subito di ospitare e non può più accedere. Poi mostra da solo un nuovo codice di abbinamento, per questo account o per un altro.

Sulla macchina: sudo krak-server unpair rimuove l’abbinamento; sudo krak-server uninstall rimuove il servizio, e con --purge anche le sue impostazioni e i dati.

Cambiare o reimpostare la password, uscire da tutti i dispositivi e un ban disconnettono anche tutti i server dell’account.