# Minecraft Server

## Come avviare il tuo server Minecraft su CloudPanda

Una volta che il tuo server Minecraft è stato creato tramite l’interfaccia di **CloudPanda**, sei a pochi semplici passaggi dall’avvio. In questa guida ti spieghiamo come è strutturato il file system, come gestire l’avvio e come proteggere il server da accessi non autorizzati tramite **whitelist**.

---

### 📁 Struttura dei file

Quando accedi al pannello del tuo server, troverai una serie di file e cartelle essenziali per il funzionamento del tuo server Minecraft. Ecco cosa aspettarti:

- **server.jar** → Il file principale del server (può essere chiamato anche con un nome diverso, es. `paper-xxx.jar` o `forge-xxx.jar` a seconda della versione o tipo di server scelto).
- **eula.txt** → Documento che contiene la licenza d’uso di Minecraft.
- **server.properties** → File di configurazione dove puoi modificare impostazioni come la porta, la difficoltà, la modalità di gioco, ecc.  
    Trovi una lista con tutte le opzioni [qui](https://minecraft.wiki/w/Server.properties/?utm_source=chatgpt.com).
- **whitelist.json** → File che contiene la lista dei giocatori autorizzati ad accedere, se la whitelist è attiva.
- **logs/** → Cartella che contiene i log delle attività del server.
- **world/** → La cartella del mondo generato.
- Altri file/cartelle possono comparire in base al tipo di server scelto (moddato, plugin, ecc).

---

### ✅ Accettare l’EULA

Per avviare il server Minecraft per la prima volta, è necessario accettare la licenza EULA di Mojang.

1. Apri il file **`eula.txt`**.
2. Troverai una riga come questa:
    
    <div class="contain-inline-size rounded-2xl relative bg-token-sidebar-surface-primary"><div class="sticky top-9"></div><div class="overflow-y-auto p-4" dir="ltr">`<span class="hljs-attr">eula</span>=<span class="hljs-literal">false</span>`</div></div>
3. Cambia `false` in `true`, così:
    
    <div class="contain-inline-size rounded-2xl relative bg-token-sidebar-surface-primary"><div class="sticky top-9"></div><div class="overflow-y-auto p-4" dir="ltr">`<span class="hljs-attr">eula</span>=<span class="hljs-literal">true</span>`</div></div>
4. Salva il file.

> ⚠️ Senza questo passaggio, il server non si avvierà.

---

### 🟢 Avvio del server

Una volta accettata l’EULA:

1. Torna alla **dashboard del tuo server** sull’interfaccia di CloudPanda.
2. Premi il pulsante **Avvia (Start)**.
3. Nella console vedrai il caricamento del server in tempo reale. Al termine, comparirà un messaggio tipo:
    
    <div class="contain-inline-size rounded-2xl relative bg-token-sidebar-surface-primary"><div class="overflow-y-auto p-4" dir="ltr">`Done (xx.xs)! For <span class="hljs-built_in">help</span>, <span class="hljs-built_in">type</span> <span class="hljs-string">"help"</span>`</div></div>
4. A questo punto il tuo server è **online e funzionante**.

---

### 🔒 Proteggi il server con la Whitelist

Per evitare accessi indesiderati, ti consigliamo vivamente di **attivare la whitelist**, soprattutto se stai gestendo un server privato tra amici o una community ristretta.

#### Come attivare la whitelist:

1. Apri il file **`server.properties`**.
2. Trova la riga:
    
    <div class="contain-inline-size rounded-2xl relative bg-token-sidebar-surface-primary"><div class="overflow-y-auto p-4" dir="ltr">`<span class="hljs-attr">whitelist</span>=<span class="hljs-literal">false</span>`</div></div>
3. Cambiala in:
    
    <div class="contain-inline-size rounded-2xl relative bg-token-sidebar-surface-primary"><div class="overflow-y-auto p-4" dir="ltr">`<span class="hljs-attr">whitelist</span>=<span class="hljs-literal">true</span>`</div></div>
4. Salva il file e **riavvia** il server.

#### Aggiungere giocatori alla whitelist:

- Una volta attiva, solo i giocatori presenti nel file `whitelist.json` potranno accedere.
- Per aggiungere un giocatore, apri la console e digita:
    
    <div class="contain-inline-size rounded-2xl relative bg-token-sidebar-surface-primary"><div class="overflow-y-auto p-4" dir="ltr">`whitelist <span class="hljs-keyword">add</span> NOMEGIOCATORE`</div></div>
- Puoi anche rimuovere un utente con:
    
    <div class="contain-inline-size rounded-2xl relative bg-token-sidebar-surface-primary"><div class="overflow-y-auto p-4" dir="ltr">`whitelist remove NOMEGIOCATORE`</div></div>

> ⚠️ Se la whitelist è attiva ma vuota, **nessuno potrà entrare** nel server.
> 
> Ulteriori informazioni sulla Whitelist [qui](https://minecraft.wiki/w/Server#Whitelist).

---

### ℹ️ Consigli utili

- Puoi modificare le impostazioni nel file `server.properties` **prima** di avviare il server per personalizzare il gameplay.
- Per server moddati (Forge, Fabric) o con plugin (Spigot, Paper), assicurati che tutti i file necessari siano presenti prima dell’avvio.
- Se qualcosa va storto, controlla i **log nella console** o nella cartella `logs/` per trovare eventuali errori.

---

Hai bisogno di supporto? Il nostro team è sempre disponibile per aiutarti tramite il sistema di ticketing del tuo account CloudPanda.