← Téléchargements Ultimate Odycer · Guide texte · Notes de version

Ultimate Odycer — guide du serveur développeur

Version : dev-20261122.1. Publication du 22 novembre 2026.

1. Choisir le téléchargement

Windows x86-64 : archive ZIP avec les DLL runtime. Linux x86-64 : archive tar.gz, cible glibc 2.28 ou ultérieure. Les quatre programmes sont mmorpg-server, login-server, webadmin-server et bootstrap-admin. PostgreSQL, Python et les bibliothèques système Linux sont à installer séparément. Aucun client graphique ni gros pack graphique d'éditeur n'est inclus.

Il s'agit d'une version développeur pour un environnement de test. Sans licence ODY1 acceptée par le serveur, l'évaluation est limitée à 20 connexions simultanées. Un ancien résultat de charge ne constitue pas une mesure de cette nouvelle archive.

La page /releases/ présente uniquement la version courante. Chaque téléchargement possède une somme SHA-256 et un fichier .sha256. Vérifiez-les avant extraction. Conservez votre ancienne version et vos sauvegardes.

2. Vérifier et extraire

Windows, dans PowerShell :


Get-FileHash .\ultimate-odycer-server-dev-20261122.1-windows-x86_64.zip -Algorithm SHA256

Expand-Archive .\ultimate-odycer-server-dev-20261122.1-windows-x86_64.zip -DestinationPath .\odycer-dev

Set-Location .\odycer-dev\ultimate-odycer-server-dev-20261122.1-windows-x86_64

.\bin\mmorpg-server.exe --version

Linux :


sha256sum -c ultimate-odycer-server-dev-20261122.1-linux-x86_64.tar.gz.sha256

tar -xzf ultimate-odycer-server-dev-20261122.1-linux-x86_64.tar.gz

cd ultimate-odycer-server-dev-20261122.1-linux-x86_64

./bin/mmorpg-server --version

Les programmes doivent afficher exactement dev-20261122.1. Les exécutables Windows utilisent la signature privée Ultimate Odycer ; cette chaîne n'est pas une autorité publique reconnue par défaut par Windows. La signature ne remplace pas la vérification des sommes publiées.

3. Préparer PostgreSQL, la configuration et TLS

Créez une base et un utilisateur PostgreSQL dédiés à cet essai. Ne réutilisez pas une base de production pour un premier démarrage. Dupliquez config.example.json en config.json à la racine extraite ; renseignez server.db_host, db_port, db_name, db_user et db_password. Les fichiers de votre installation existante ne sont jamais à publier.

Définissez un JWT_SECRET aléatoire, long et propre à cet environnement. Les services Game et Login doivent utiliser le même secret et la même base. Les champs vides de l'exemple sont intentionnels : aucun mot de passe ni secret prêt à l'emploi n'est distribué.

Placez votre certificat et sa clé dans certs/server.crt et certs/server.key, ou adaptez network.tls_cert_path et tls_key_path. Pour un essai local, un certificat auto-signé doit être explicitement approuvé par le client de test. Pour un accès distant, utilisez un nom et une chaîne de confiance adaptés. Gardez enable_tls à true et ne publiez jamais la clé privée.

L'exemple fourni choisit les écoutes suivantes : Game TLS 127.0.0.1:7777, Login TLS 127.0.0.1:2106, API 127.0.0.1:8080 et WebAdmin 127.0.0.1:8082. Ce sont les valeurs de l'exemple, pas une détection automatique de votre installation. Vérifiez les journaux et les ports réellement ouverts avant d'autoriser un accès distant.

Pour Linux, installez notamment la bibliothèque cliente PostgreSQL et les bibliothèques OpenSSL correspondant à votre distribution. Si une bibliothèque manque, utilisez ldd bin/mmorpg-server pour identifier précisément la dépendance ; ne copiez pas des DLL Windows sur Linux.

4. Démarrer et ouvrir WebAdmin

Le dossier logs est livré dans cette révision du paquet. Si vous reprenez une installation précédente, créez ce dossier à la racine du serveur et donnez au compte du service la permission d’y écrire avant de lancer Login.

Exécutez les commandes depuis la racine extraite, afin que config/, templates/ et src/webadmin/frontend/ soient trouvés. L'exemple désactive le lancement automatique d'autres programmes et l'ouverture automatique du navigateur.

Windows : ouvrez deux terminaux PowerShell dans ce même dossier, avec la même configuration et le même JWT_SECRET.


# Terminal Login

.\bin\login-server.exe

# Terminal Game

.\bin\mmorpg-server.exe

Linux : utilisez deux terminaux ou des services propres à votre environnement, dans le même dossier de travail.


# Terminal Login

./bin/login-server

# Terminal Game

./bin/mmorpg-server

Le serveur Game démarre son WebAdmin intégré. Ouvrez http://127.0.0.1:8082 après son initialisation. Le programme webadmin-server est aussi fourni pour une administration autonome : ne le démarrez pas simultanément sur le port déjà utilisé par le WebAdmin intégré. Certaines fonctions liées au monde nécessitent le Game actif.

Pour une installation distante, gardez WebAdmin en boucle locale et utilisez un tunnel SSH ou un reverse proxy HTTPS correctement configuré. Le guide VPS Hostinger du site décrit ce parcours ; télécharger le serveur ne déploie aucun service automatiquement.

5. Créer le premier administrateur

Après les migrations et le démarrage de la base, exécutez bootstrap-admin depuis la même racine et avec la même configuration. Sous Windows : .\bin\bootstrap-admin.exe ; sous Linux : ./bin/bootstrap-admin.

L'outil crée ou répare le compte administrateur initial lorsque son hash est encore le placeholder de migration. Un administrateur existant et utilisable est conservé. Le mot de passe temporaire généré est sensible : ne le copiez pas dans un chat ni dans les notes de publication. Si vous conservez la sortie, protégez le fichier.

Connectez-vous à WebAdmin et changez le mot de passe imposé avant d'accéder aux fonctions d'administration. Reconnectez-vous ensuite et retirez toute copie du mot de passe temporaire. Aucun identifiant administrateur universel n'est fourni.

6. Ce que cette version améliore

Les sessions WebSocket du WebAdmin utilisent désormais un fil de session dédié après le handshake HTTP : une session inactive ne bloque plus un worker du pool. Les broadcasts et heartbeats préparent leurs destinataires sous verrou court puis écrivent sur les sockets sans conserver le mutex global du gestionnaire.

Les refus d'authentification WebAdmin produisent une seule réponse HTTP. Les transports TLS terminés mais pas encore authentifiés restent comptés dans le plafond de connexions.

Les événements saisonniers appliquent leurs effets avant la création de l'événement de suivi. Cette correction évite d'utiliser un pointeur devenu invalide lorsque l'ajout agrandit la liste des événements.

Les mutations de l'inventaire sont protégées par une réservation. La progression de quête retardée est conservée lorsque l'inventaire est occupé. Les pertes liées à la mort restent en attente jusqu'à ce que leur application soit admise.

Lors d'une déconnexion, un échec de capture, d'allocation ou d'admission dans la file conserve l'autorité du personnage et son transport exact pour une nouvelle tentative. La fermeture propre exige toujours la vérification d'un reçu final complet. L'arrêt fait aussi progresser ces captures en attente.

Ces protections améliorent la continuité pendant la vie du processus. Une capture qui n'a pas encore atteint le stockage durable reste en mémoire ; une panne brutale n'est pas couverte par cette seule garde. Le journal durable combiné mort/assurance reste à compléter. Aucun gain global de débit ou de latence n'est annoncé par ce guide.

7. Personnaliser et utiliser Codex

Les données publiques de config/ et templates/ servent à configurer le serveur. Conservez les identifiants et les dépendances des modèles. Le chargement des quêtes refuse ou met en quarantaine les documents invalides ; lisez le diagnostic avant de modifier un catalogue. Sauvegardez avant chaque modification.

SERVER_MODE=classic3d ou vr choisit le profil de jeu ; classic3d refuse les paquets VR. SERVER_REGION sélectionne les règles régionales disponibles. Ces réglages ne remplacent pas un examen de votre propre exploitation.

Pour Codex, fournissez le chemin local extrait, la version exacte et les journaux utiles. N'envoyez pas config.json, les mots de passe, les clés TLS ou les jetons. L'installation d'un plugin Codex, sa connexion authentifiée à votre serveur et son rendu dans Codex sont des vérifications distinctes ; l'archive serveur ne les active pas automatiquement.

8. Mettre à jour et revenir en arrière

Mise à niveau depuis dev-20261101.1 ou une version antérieure : effectuez une maintenance manuelle et sauvegardée. Conservez la base, la configuration, les certificats, les templates personnalisés et la version précédente. Une version antérieure à dev-20261030.4 peut devoir franchir une première transition manuelle avant d'utiliser le canal signé actuel ; ne contournez jamais ce refus et n'exécutez pas un script issu d'un dossier candidat non vérifié.

Téléchargez l'archive dev-20261122.1 et vérifiez son empreinte publiée. Sauvegardez la base et votre configuration, arrêtez vos services en maintenance, puis installez la nouvelle release dans un dossier distinct. Conservez vos données, vos certificats et vos secrets hors des fichiers d'exemple. Faites pointer vos services vers cette nouvelle installation, vérifiez la version et la santé, puis contrôlez la connexion et une sauvegarde relue. Gardez l'ancienne installation pour le retour arrière.

Les futures activations automatiques utilisent les deux scripts de update/ déjà présents dans l'installation de confiance, sous le dossier live de votre racine de releases. Elles vérifient aussi l'archive signée conservée et tout le contenu préparé. Une ancienne installation sans ces scripts compatibles doit d'abord être mise à niveau manuellement. La page du site annonce cette étape pour éviter une fausse impression de mise à jour automatique depuis .4.

Sauvegardez PostgreSQL, les données persistantes, la configuration et la version courante avant toute mise à jour. Une restauration de fichiers binaires ne restaure pas la base.

Le dossier update/ contient odycer_update.py, update_activate.py et la clé publique du canal. Python 3 et le module cryptography sont nécessaires pour ces outils. Le manifeste et sa signature doivent être vérifiés avant de télécharger, puis l'empreinte de chaque archive avant de l'extraire.

Dans WebAdmin, Système > Mises à jour affiche le canal et la version. L'installation et le redémarrage exigent une confirmation et un environnement de services configuré pour la bascule. En cas d'échec du contrôle de santé, l'outil tente le retour à la version conservée. Le bouton de retour arrière explicite utilise cette même version précédente. Cela ne dispense pas de la sauvegarde de base.

Si votre installation n'a pas de gestion des services configurée, préparez le téléchargement et effectuez une maintenance contrôlée ; ne lancez pas une bascule avec un fichier services.json inventé. La publication sur le site ne redémarre aucun serveur installé.

9. Vérifier l'installation et demander de l'aide

Contrôlez la version des quatre programmes, la santé WebAdmin, l'authentification, la création puis la sélection d'un personnage, une reconnexion et une sauvegarde relue. Un démarrage seul ne prouve pas tout le parcours de jeu.

En cas de refus de fermeture ou de sauvegarde, conservez le processus et ses journaux lorsque c'est possible. Ne forcez pas un redémarrage pour contourner une garde de persistance. Relevez le message exact, la version et la configuration non sensible concernée.

Pour signaler un problème, indiquez dev-20261122.1, le système, l'étape, le résultat attendu et le diagnostic expurgé. Les vérifications de cette publication sont résumées dans NOTES-VERSION.txt. Les limites graphiques, VR, endurance et preuve native des plugins restent séparées des tests serveur.

Achats de gemmes en sandbox

Dans le WebAdmin, ouvrez la configuration Stripe de la boutique. Utilisez les identifiants de test de votre propre compte. Créez une offre avec une devise, un prix et un nombre de gemmes. Activez la création de factures pour les nouvelles commandes si vous souhaitez une facture après paiement.

Pour vendre un pack au prix TTC affiché, configurez le siège, les immatriculations applicables et la catégorie fiscale du produit dans Stripe Tax, puis activez « Prix TTC des packs avec Stripe Tax ». Le joueur renseigne son adresse dans Checkout. Vérifiez une commande de test, sa facture et son solde avant toute ouverture du parcours aux joueurs.

Compatibilité des clients

Le registre distribué active la vérification de l’empreinte des ressources du client canonique. Pour un client Godot personnalisé, installez à la racine asset_registry_godot.json avec la valeur manifest_hash issue de votre propre build client. Conservez vos registres lors de la mise à niveau.

Première connexion avec la révision r3

Connectez-vous au WebAdmin avec le mot de passe temporaire fourni par bootstrap-admin, puis choisissez et confirmez votre nouveau mot de passe. Dans la boutique, activez les factures et le prix TTC, puis créez votre pack. Les options et les packs sont conservés dans PostgreSQL. Le champ d’adresse prépare un modèle de configuration pour votre hébergement.

Révision r4 : un joueur connecté peut choisir son pack dans le catalogue de gemmes Godot.