🛠 My Shard — Pannello GM / Amministrazione

Riferimento operativo per la gestione del server

Accesso riservato

Come sapere se il server UO è attivo

Verifica in corso…
Container Docker
Porta 2593
In esecuzione dal
Ultimo controllo

La pagina si aggiorna da sola ogni 30 secondi; il dato lato server viene ricalcolato ogni minuto da un cron job (check_status.sh).

Il server gira dentro un container Docker (servuo) in /opt/servuo/ServUO. Da SSH, per un controllo manuale:

cd /opt/servuo/ServUO
docker compose ps

Se la colonna STATUS mostra Up ..., il container è in esecuzione. Per confermare che il gioco stia davvero ascoltando sulla porta 2593:

sudo ss -tlnp | grep 2593

Per vedere cosa sta facendo in questo momento (utile se qualcuno segnala problemi):

docker compose logs -f

(Ctrl+C per uscire dalla visualizzazione live — non ferma il server)

Avvio automatico dopo un riavvio del server Linux: configurato con restart: always.
Il servizio Docker si avvia da solo al boot (systemctl enable docker) e il container riparte sempre, qualunque sia stato il suo ultimo stato prima dello stop — a differenza di unless-stopped, che non riparte se l'ultimo stato registrato era "fermato manualmente" (es. dopo un docker compose down).
Nota operativa (30-31 agosto 2026): dopo un blackout, il server non è ripartito da solo nonostante il riavvio automatico fosse impostato. Causa reale: sul sistema coesistevano due installazioni di Docker (quella apt e una precedente installata come snap), entrambe avviate al boot e in competizione per lo stesso socket (/run/docker.sock / /var/run/docker.sock). Quella snap "vinceva" la contesa ma, essendo confinata da AppArmor, non riusciva a montare la cartella /opt/servuo/ServUO nel container — errore fuorviante "read-only file system" anche se il disco era perfettamente scrivibile. Risolto rimuovendo del tutto lo snap (sudo snap remove docker), lasciando solo il Docker apt come unico demone. Se in futuro un riavvio non porta su il server, controlla per prima cosa:
snap list 2>/dev/null | grep -i docker
docker info | grep "Server Version"
Se compare uno snap Docker, o la versione non è quella attesa, è di nuovo questo il sospetto principale.

Comandi Docker per la gestione quotidiana

AzioneComando
Vedere lo statodocker compose ps
Avviare (in background)docker compose up -d
Fermaredocker compose down
Riavviaredocker compose restart
Log in tempo realedocker compose logs -f
Ultime N righe di logdocker compose logs --tail 100
Entrare nella console interattiva del serverdocker attach servuo
per staccarsi senza fermarlo: Ctrl+P poi Ctrl+Q (mai Ctrl+C)

Tutti i comandi vanno lanciati da dentro /opt/servuo/ServUO.

Comandi da GM/Owner in gioco

Per la lista completa e sempre aggiornata alla tua versione esatta del server, in gioco digita:
[Gendocs]
genera la documentazione completa di tutti i comandi disponibili sul tuo shard. Usa [help per l'aiuto contestuale su un comando specifico.

Movimento e navigazione

ComandoEffetto
[go <luogo>Teletrasporto rapido a una città (es. [go britain)
[teleTeletrasporto al punto cliccato sulla mappa
[whereMostra le tue coordinate attuali

Creazione e modifica oggetti/creature

ComandoEffetto
[add <nome>Genera un oggetto o una creatura (es. [add gold, [add dragon)
[propsApre il pannello proprietà dell'oggetto/creatura cliccata (stat, nome, quantità...)
[dupeDuplica l'oggetto cliccato
[removeRimuove l'oggetto/creatura cliccata

Gestione personaggi

ComandoEffetto
[killUccide istantaneamente il bersaglio cliccato
[freezeBlocca (immobilizza) un personaggio
[invulTi rende invulnerabile
[hideTi rende invisibile
[kick <nome>Disconnette un giocatore
[ban <nome>Banna un account

Comunicazione

ComandoEffetto
[bcast <messaggio>Messaggio broadcast a tutto il server

Mondo / setup iniziale dello shard

ComandoEffetto
[createworldGenera le infrastrutture di base (porte, teletrasporti)
[xmlload SpawnsCarica gli spawner di mostri/NPC in tutto il mondo
[xmlload Spawns/<regione>Carica gli spawner solo per una regione specifica (es. Trammel), utile se il caricamento completo dà problemi

File di configurazione principali

Tutti dentro /opt/servuo/ServUO/Config/. Dopo ogni modifica: docker compose restart per applicarla.

FileCosa controlla
Server.cfgAddress= — l'indirizzo che il server comunica ai client per la connessione di gioco vera e propria. Port= — porta di ascolto (default 2593).
DataPath.cfgCustomPath= — dove si trovano i file dati del client UO (dentro il container: /app/UO_DATA).
PlayerCaps.cfgIndividualSkillCap / TotalSkillCap / TotalStatCap — cap delle skill e delle statistiche per i nuovi personaggi (valori ×10, es. 7000 = 700.0).

Per applicare un nuovo skill cap ai personaggi già esistenti (non solo ai nuovi), da GM in gioco:

[global set SkillsCap <valore> where playermobile

Manutenzione

Aggiornare ServUO

cd /opt/servuo/ServUO
docker compose down
git pull
docker compose run --rm servuo make build
docker compose up -d

Backup del mondo

I salvataggi vivono in /opt/servuo/ServUO/Saves/ (creata automaticamente). Per un backup, con il server fermo o subito dopo un salvataggio ([save in gioco, o il comando GM [save lato server):

tar -czf ~/servuo-backup-$(date +%Y%m%d).tar.gz -C /opt/servuo/ServUO Saves

Rinominare lo shard

Cambia Name=My Shard in Config/Server.cfg, poi docker compose restart.

Stato del progetto

Accesso da internet: completato. Port forwarding sul router per 2593/tcp e Address in Server.cfg aggiornato all'indirizzo pubblico — i giocatori si collegano da fuori casa su fusac.it porta 2593.
Ancora da fare:
  • Personalizzare le regole dello shard nella pagina pubblica (sezione "Regole")