Ultimate Odycer

Documentazione e prima prova di gioco

Prepara un’istanza, collega un client e prova il tuo primo mondo online.

Leggi le domande frequenti

  1. Installare un’istanza di valutazione

    Leggi le note, verifica l’hash SHA-256 e segui la guida della versione. Configura PostgreSQL e TLS e applica le migrazioni. Mantieni PostgreSQL e WebAdmin su una rete o interfaccia privata.

    Scarica il serverGuida VPS (in francese)
  2. Collegare i primi client

    Usa un progetto Godot/C# compatibile. Configura gli indirizzi di Login e Game. Crea due account di prova e verifica che entrino nello stesso mondo.

    Documentazione tecnica (in inglese)
  3. Creare una prima esperienza giocabile con l’IA

    Chiedi a Codex o Claude Code una modifica verificabile alla volta. Parti da una piccola mappa, un PNG, una missione e una ricompensa. Importa gli export con versione degli strumenti accessibili e prova il risultato in Godot e sul server.

    Strumenti per Codex
  4. Preparare la preproduzione

    Verifica personaggio e ricompensa dopo riconnessione e riavvio. Ripristina un backup in isolamento, leggi i log e misura il carico. Usa la stessa versione quando supera le verifiche di preproduzione.

Installare il server su un VPS

Valutazione su un VPS Linux x86-64 con PostgreSQL e TLS. Procurati a parte un client compatibile. I comandi illustrano il primo avvio su Debian o Ubuntu. Controlla i requisiti dell’archivio scelto.

  1. Preparare il VPS e la rete privata

    Usa un account SSH non root con sudo. Verifica x86_64 e glibc e installa PostgreSQL e le dipendenze. Mantieni PostgreSQL, API e WebAdmin in locale. Predisponi una rete privata o VPN raggiungibile dai due computer di prova.

    uname -m
    getconf GNU_LIBC_VERSION
    sudo apt update
    sudo apt install postgresql libpq5 openssl ca-certificates
    pg_isready
  2. Scaricare, verificare ed estrarre

    Scarica l’archivio Linux x86-64 e il file .sha256 da Versioni. Sostituisci il nome d’esempio con quello esatto. Confronta anche l’hash con la pagina ufficiale e fermati se è diverso. Entra nella cartella estratta e controlla le librerie mancanti.

    archive=ultimate-odycer-server-dev-20261106.2-linux-x86_64.tar.gz
    sha256sum -c "$archive.sha256" && tar -xzf "$archive" &&
      cd "${archive%.tar.gz}" && ldd ./bin/mmorpg-server && ldd ./bin/login-server
    Scarica il server
  3. Creare un database dedicato

    Nell’istanza PostgreSQL di valutazione crea un ruolo e il relativo database. Imposta una password univoca quando richiesto. L’ultimo comando verifica l’accesso TCP locale.

    sudo -u postgres createuser --pwprompt odycer_test
    sudo -u postgres createdb --owner=odycer_test ultimate_odycer_test
    psql -h 127.0.0.1 -U odycer_test -d ultimate_odycer_test -c "SELECT current_user;"
  4. Configurare il server e TLS

    Copia config.example.json in config.json e proteggilo. Imposta db_host, db_port, db_name, db_user e db_password in server. Lascia network.enable_tls su true. Colloca certificato e chiave in network.tls_cert_path e tls_key_path. Il client deve fidarsi del certificato, che deve corrispondere al nome o all’IP usato. Usa lo stesso JWT_SECRET in Game e Login. Estrai l’archivio con l’account che eseguirà i binari o concedigli accesso ai file necessari. Usa percorsi TLS assoluti per servizi avviati separatamente e verifica che entrambi leggano certificato e chiave.

    cp -n config.example.json config.json
    chmod 600 config.json
    (umask 077; set -C; printf "JWT_SECRET=%s
    " "$(openssl rand -hex 32)" > .odycer-runtime.env)
  5. Avviare Game e poi Login, dopo le migrazioni

    Apri due sessioni SSH nella cartella estratta e carica lo stesso file d’ambiente senza mostrarlo. Su un database vuoto avvia solo Game. Attendi il completamento delle migrazioni PostgreSQL e l’ascolto di Game e WebAdmin. Poi avvia Login nella seconda sessione. L’avvio simultaneo può causare una relazione duplicata e il ripiego su SQLite. Se i log segnalano il ripiego, correggi PostgreSQL prima di continuare.

    Game

    set -a; . ./.odycer-runtime.env; set +a
    ./bin/mmorpg-server
    ss -ltn

    Login

    set -a; . ./.odycer-runtime.env; set +a
    ./bin/login-server
  6. Aprire WebAdmin e autorizzare i client di prova

    Dopo le migrazioni esegui bootstrap-admin e cambia la password temporanea al primo accesso via tunnel SSH. Per la prova remota imposta server.login_ip e server.server_ip su un IP privato raggiungibile, riavvia e consenti solo la rete di prova sulle porte TCP 2106 e 7777. Login comunica l’indirizzo di Game. Verifica che sia raggiungibile e coperto da TLS. Tieni 5432, 8080 e 8082 fuori dalla rete pubblica. Esegui il bootstrap con lo stesso utente di sistema, la stessa cartella di lavoro e le stesse impostazioni PostgreSQL di Game. Al cambio di utente, usa la home dell’account di servizio.

    VPS

    set -a; . ./.odycer-runtime.env; set +a
    ./bin/bootstrap-admin

    SSH → WebAdmin

    ssh -N -L 8082:127.0.0.1:8082 operator@vps.example.com
    # http://127.0.0.1:8082/
  7. Registrare il risultato e fare il backup

    Da un computer di prova verifica Login e l’ingresso in Game. Se l’accesso al mondo fallisce, controlla indirizzo pubblicizzato, firewall e fiducia TLS. Salva database, configurazione e versione. Verifica il ripristino su un’istanza isolata prima dell’apertura al pubblico.

    umask 077
    pg_dump -h 127.0.0.1 -U odycer_test -Fc -f odycer-test.dump ultimate_odycer_test
    pg_restore --list odycer-test.dump

Creare un primo MMORPG giocabile con Codex o Claude Code

Obiettivo del prototipo: due giocatori nello stesso mondo, una missione e una ricompensa persistente. Procurati un progetto Godot compatibile con il server. Il pacchetto server è separato.

  1. Preparare il progetto Godot

    Apri il client in Godot 4 .NET con il .NET SDK richiesto. Registra le versioni di server, client e protocollo. Usa Git, un ramo dedicato, un’istanza e account di prova.

    Godot .NET / C#
  2. Dare il primo compito all’assistente

    Apri la cartella in Codex o Claude Code. Fornisci contratto di rete, configurazione senza segreti e risultato atteso. Chiedi una modifica verificabile alla volta e rileggi le differenze. Per esempio, chiedi di individuare le impostazioni di Login e Game, proporre la modifica minima per collegare il client e indicare come verificarla.

    CodexClaude Code
  3. Collegare prima un client

    Configura l’indirizzo di Login con il meccanismo del progetto e verifica quello di Game. Crea due account attraverso il percorso supportato dalla tua versione. Usa il primo per creare o scegliere un personaggio ed entrare nell’area di prova. Risolvi prima gli errori di versione, certificato o connessione. Controlla il registro delle risorse richiesto da client e server. Il pacchetto dev-20261106.2 non include asset_registry.json. Se il client richiede un’impronta, usa il registro del suo progetto o generane uno dai template del server e dalle risorse del client con lo strumento del progetto. Caricalo nell’istanza di prova e riavvia Game prima di usare la stessa impronta nel client.

  4. Costruire un ciclo di gioco

    Crea una piccola mappa, un punto di partenza, un PNG e una missione semplice. Parla al PNG, raccogli un oggetto e torna per la ricompensa. Importa gli export nei formati supportati e verifica in Godot e sul server. Chiedi di riutilizzare i percorsi server per obiettivi, inventario e ricompense.

    Strumenti per Codex
  5. Avviare due client Godot

    In Godot apri Debug → Customize Run Instances e scegli due istanze, oppure avvia due build desktop su computer distinti. Usa profili o cartelle utente separati se il client memorizza l’account. Collega A e B allo stesso server e alla stessa area. Per la prova grafica, scegli una build C# completa di risorse e compatibile con il sistema operativo e il driver grafico delle macchine di prova. Se avvii il progetto sorgente, usa le versioni di Godot .NET e dell’SDK .NET che indica. Un export per Windows si avvia su un PC Windows con desktop e può collegarsi al server su un VPS Linux. Un display X11 virtuale è un’opzione per una build Linux compatibile con il driver del VPS. Conserva il manifest fornito con la build, verifica i file e autorizza la sua impronta nel registro di Game. Se il client da sorgente segnala un inventario modificato, rigenera il manifest con lo strumento del progetto e aggiorna il registro del server di prova. L’account di esecuzione deve poter leggere i file e scrivere nel proprio profilo. Acquisisci ciascuna finestra prima e dopo il riavvio.

    Godot · Customize Run Instances
  6. Verificare multigiocatore e persistenza

    Verifica che i due personaggi si vedano e che B veda il movimento di A. Completa la missione con A. A deve ricevere la ricompensa una sola volta e B mai. Ricollega A, poi riavvia correttamente il server di prova. Controlla personaggio, inventario e ricompensa.

  7. Registrare risultati e analizzare gli errori

    Annota versioni, account, passaggi e risultati attesi e osservati, senza segreti. Se i client non si vedono, confronta area, istanza e versione. Se la ricompensa scompare, controlla il salvataggio sul server. Superati i controlli, hai un prototipo multigiocatore giocabile. Lo scenario della missione e della ricompensa dopo il riavvio di Game e Login sul VPS è stato verificato con due client di test. Con due finestre dell’export completo di Ultody2 per Windows sono stati verificati l’uccisione del goblin e il mantenimento dei progressi e di entrambi gli inventari nel database dopo il riavvio. Per questo export restano da verificare il recupero del trofeo e l’assegnazione della ricompensa. Prima di giocare la missione, controlla che l’interfaccia permetta tutte le azioni richieste, compreso il recupero del bottino da un cadavere se previsto dall’obiettivo. Dopo aver riavviato Game e Login, riconnetti entrambi gli account e confronta il diario delle missioni e l’inventario di ciascun personaggio.