Guides, architecture et références

Documentation Ultimate Odycer

Commencez par les consignes du lot téléchargé. La documentation est organisée en cinq parcours clairs : démarrage serveur, gestion des clés ODY1, intégration client Godot/Nethercore, ateliers Codex et référence API/MCP.

Documentation et premier essai

Préparez une instance, connectez un client et testez votre premier monde en ligne.

Lire la FAQ

  1. Installer une instance d’évaluation

    Consultez les notes de version, vérifiez le SHA-256 de l’archive et suivez le guide correspondant. Configurez PostgreSQL, appliquez les migrations requises et préparez TLS. Maintenez PostgreSQL et WebAdmin sur une interface ou un réseau privé.

    Télécharger le serveurGuide VPS
  2. Connecter les premiers clients

    Utilisez un projet Godot/C# compatible. Pointez-le vers les adresses configurées pour Login et Game. Créez deux comptes de test et vérifiez que les deux clients entrent dans le même monde.

    Documentation technique
  3. Créer une première boucle jouable avec l’IA

    Confiez à Codex ou Claude Code un changement à relire à la fois. Commencez par une petite carte, un PNJ, une quête et une récompense. Utilisez des exports versionnés des ateliers auxquels vous avez accès. Importez-les dans le projet et vérifiez le résultat dans Godot et sur le serveur.

    Ateliers Codex
  4. Préparer le déploiement en préproduction

    Vérifiez que le personnage et la récompense sont conservés après reconnexion et redémarrage. Restaurez une sauvegarde dans un environnement isolé, consultez les journaux et mesurez la charge. Passez en production avec la même version une fois vos critères satisfaits.

Installer le serveur sur un VPS

Parcours d’évaluation sur un VPS Linux x86-64, avec PostgreSQL et TLS. Prévoyez un client compatible séparément. Les commandes illustrent un premier démarrage sur Debian ou Ubuntu. Vérifiez les prérequis de l’archive choisie.

  1. Préparer le VPS et le réseau privé

    Utilisez un compte SSH non root avec sudo. Confirmez l’architecture x86_64 et la version de glibc, puis installez PostgreSQL et les dépendances du lot. Gardez PostgreSQL, l’API et WebAdmin en local. Prévoyez un réseau privé ou VPN routable depuis les deux postes de test.

    uname -m
    getconf GNU_LIBC_VERSION
    sudo apt update
    sudo apt install postgresql libpq5 openssl ca-certificates
    pg_isready
  2. Télécharger, vérifier et extraire

    Téléchargez l’archive Linux x86-64 et son fichier .sha256 depuis Versions. Depuis le dossier de téléchargement, remplacez le nom d’exemple par le nom exact. Comparez aussi l’empreinte avec la page officielle. Arrêtez-vous si elle diffère. Entrez dans le répertoire extrait et vérifiez les dépendances manquantes.

    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
    Télécharger le serveur
  3. Créer une base dédiée

    Sur une instance PostgreSQL dédiée à l’essai, créez un rôle et sa base. Choisissez un mot de passe unique à l’invite. La dernière commande confirme que le compte peut se connecter en TCP local.

    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. Renseigner la configuration et TLS

    Copiez config.example.json en config.json et protégez-le. Dans server, réglez db_host, db_port, db_name, db_user et db_password pour la base créée. Gardez network.enable_tls à true. Installez le certificat et sa clé aux chemins network.tls_cert_path et tls_key_path. Le certificat doit être approuvé par les clients et correspondre aux noms ou IP utilisés. Utilisez le même JWT_SECRET dans Game et Login. Extrayez l’archive avec le compte qui exécutera les binaires, ou donnez à ce compte l’accès aux fichiers nécessaires. Pour des services lancés séparément, utilisez des chemins TLS absolus et vérifiez que les deux processus peuvent lire le certificat et la clé.

    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. Démarrer Game, puis Login après les migrations

    Ouvrez deux sessions SSH dans le répertoire extrait. Chargez le même fichier d’environnement dans chacune, sans en afficher le contenu. Sur une base vierge, démarrez Game seul. Attendez la fin des migrations PostgreSQL et l’écoute de Game et WebAdmin. Démarrez ensuite Login dans la seconde session. Un démarrage simultané peut provoquer une erreur de relation en double et un repli vers SQLite. Si les journaux signalent ce repli, corrigez PostgreSQL avant de poursuivre.

    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. Ouvrir WebAdmin et autoriser les clients de test

    Après les migrations, lancez bootstrap-admin et changez le mot de passe temporaire à la première connexion via le tunnel SSH. Pour le test distant, configurez server.login_ip et server.server_ip sur une adresse privée joignable par les postes, redémarrez et autorisez uniquement leur réseau sur TCP 2106 et 7777. Login communique l’adresse de Game au client. Vérifiez donc que cette adresse est routable et couverte par le certificat. Gardez 5432, 8080 et 8082 hors de l’accès public. Pour le bootstrap, gardez le même compte système, le même répertoire de travail et les mêmes réglages PostgreSQL que Game. Si vous changez d’utilisateur, utilisez son propre répertoire personnel plutôt que celui de root.

    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. Consigner le résultat et sauvegarder

    Depuis un poste de test, vérifiez successivement Login et l’entrée dans Game avec un client compatible. Si Login répond mais que le monde reste inaccessible, vérifiez d’abord l’adresse de Game annoncée, le pare-feu et la confiance TLS. Sauvegardez la base, la configuration et la version du lot. Avant une ouverture publique, restaurez la sauvegarde dans une instance isolée.

    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

Créer un premier MMORPG jouable avec Codex ou Claude Code

Objectif du prototype : deux joueurs dans le même monde, une quête et une récompense persistante. Il faut un projet client Godot compatible avec le serveur choisi. Le téléchargement du serveur ne contient pas ce client.

  1. Préparer le projet Godot

    Ouvrez un projet client compatible dans Godot 4 .NET avec le SDK .NET demandé par ce projet. Relevez la version du serveur, du client et du protocole. Conservez le projet dans Git et travaillez dans une branche dédiée, avec une instance et des comptes d’essai.

    Godot .NET / C#
  2. Donner une première tâche à l’assistant

    Ouvrez le dossier du projet avec Codex ou Claude Code. Donnez-lui le contrat réseau correspondant, les fichiers de configuration non secrets et le résultat attendu. Demandez un changement vérifiable à la fois et relisez le diff. Exemple : « Repère la configuration de Login et Game. Propose le plus petit changement pour connecter le client de test à mon serveur et indique comment le vérifier. »

    CodexClaude Code
  3. Valider la connexion avec un seul client

    Utilisez le mécanisme de configuration du projet pour l’adresse de Login et vérifiez l’adresse de Game qui en découle. Créez deux comptes joueurs par le parcours pris en charge par votre version. Avec le premier, créez ou sélectionnez un personnage et entrez dans la zone de test. Corrigez d’abord les erreurs de version, de certificat ou de connexion. Vérifiez aussi le registre d’assets attendu par le client et le serveur. L’archive serveur dev-20261106.2 ne fournit pas asset_registry.json. Si votre client exige une empreinte, utilisez le registre livré avec son projet ou générez le registre à partir de vos templates serveur et des assets de ce client avec l’outil du projet. Chargez ce registre sur l’instance de test et redémarrez Game avant de renseigner la même empreinte dans le client.

  4. Construire une boucle de jeu

    Créez une petite carte, un point d’apparition, un PNJ et une quête simple. Exemple : parler au PNJ, ramasser un objet, revenir recevoir une récompense. Importez les exports d’atelier selon les formats pris en charge. Vérifiez dans Godot puis sur le serveur. Demandez à l’assistant de réutiliser les voies serveur existantes pour l’objectif, l’inventaire et la récompense.

    Ateliers Codex
  5. Lancer deux clients Godot

    Dans Godot, utilisez Debug → Customize Run Instances et choisissez deux instances, ou lancez deux builds de bureau sur des postes distincts. Utilisez des profils ou des répertoires utilisateur séparés si le client mémorise un compte. Connectez les comptes A et B au même serveur et placez leurs personnages dans la même zone. Pour la recette graphique, choisissez un build C# complet avec ses ressources, compatible avec le système et le pilote graphique des postes de test. Si vous lancez le projet source, utilisez les versions Godot .NET et du SDK .NET qu’il indique. Un export Windows s’exécute sur un poste Windows avec affichage et peut se connecter au serveur sur un VPS Linux. Un affichage X11 virtuel est une option pour un build Linux compatible avec le pilote du VPS. Conservez le manifeste livré avec le build, vérifiez l’intégrité de ses fichiers et autorisez son empreinte dans le registre de Game. Si le client source signale un inventaire modifié, régénérez son manifeste avec l’outil du projet et mettez à jour le registre du serveur de test. Le compte d’exécution doit pouvoir lire les fichiers et écrire dans son profil. Prenez une capture de chaque fenêtre avant et après le redémarrage.

    Godot · Customize Run Instances
  6. Vérifier le multijoueur et la persistance

    Confirmez que les deux personnages se voient et que le mouvement d’A est visible chez B. Faites terminer la quête par A. Vérifiez qu’A reçoit la récompense une seule fois et que B ne la reçoit pas. Déconnectez A, reconnectez-le, puis effectuez un redémarrage propre du serveur de test et contrôlez le personnage, l’inventaire et la récompense.

  7. Noter les résultats et traiter les écarts

    Pour chaque essai, notez versions, comptes de test, étapes, résultat attendu et résultat observé, sans conserver de secrets. Si les clients ne se voient pas, comparez zone, instance et version. Si la récompense disparaît, vérifiez la sauvegarde serveur avant de poursuivre. Une fois les contrôles passés, vous avez un premier parcours multijoueur jouable. Le scénario de quête et de récompense après le redémarrage de Game et Login sur le VPS a été vérifié avec deux clients de recette. Avec deux fenêtres de l’export Windows complet d’Ultody2, l’élimination du gobelin et la conservation de la progression et des inventaires en base après redémarrage ont été vérifiées. La collecte du trophée et le crédit de la récompense restent à valider sur cet export. Avant de jouer la quête, vérifiez que toutes ses actions, y compris la fouille d’une dépouille si elle fait partie de l’objectif, sont accessibles dans l’interface de l’export. Après le redémarrage de Game et Login, reconnectez les deux comptes et comparez le journal de quête et l’inventaire de chacun.

Checklist de préparation archivée

Préparer un premier monde local

Ce document historique contient un résumé français. Ses anciennes indications de disponibilité précèdent l’essai actuel : la page des versions et le LISEZ-MOI du lot font référence pour les fichiers et prérequis.

Architecture documentaire en 5 parcours

Parcours complets par rôle technique

Chaque parcours distingue explicitement ce qui est supporté dans le lot développeur actuel, ce qui relève d’une validation privée et ce qui est en préouverture.

Référence réseau canonique

Matrice officielle des ports et services

À utiliser pour configurer votre pare-feu, votre reverse-proxy TLS et vos fichiers de configuration.

Service Port Protocole Fonction
Serveur de Jeu (Game Socket) 7777 TCP / TLS binaire Boucle temps réel ECS 100 Hz, déplacements Fixed64 et actions autoritaires
Serveur d’Authentification (Login) 2106 TCP / TLS binaire Handshake initial, vérification compte et sélection du monde
WebAdmin REST & WebSocket 8082 HTTP / WS (JWT & x-agent-key) API d’administration d’instance (/auth/*, /license/*, /monitoring/*, /api/mcp.json)
Vault WebAdmin Studio UI 5174 HTTP (SPA React) Interface graphique d’exploitation du serveur auto-hébergé
Portail Commercial Nexus 4321 HTTP / Statique Portail public ultimateodycer.com, simulateur CCU et espace compte studio

Flux de création local

Comment fonctionnent les ateliers et plugins Codex

1. Cadrage dans Codex

Décrivez le bâtiment, la créature, la plante ou la carte dans votre session Codex locale. Le compagnon appelle les outils MCP locaux de l’atelier correspondant.

2. Retouche dans l’atelier natif

Ouvrez la révision sauvegardée dans l’éditeur local (Architecture, PlantLab, Creature Editor ou Map Creator) pour contrôler la géométrie et les matériaux PBR.

3. Export vers Godot & Serveur Zig

Exportez l’archive validée (.json, .glb, .mapodc ou starter Godot) et testez son chargement dans le client et sur votre serveur Zig local.