(Note du traducteur: les termes tel que “Shard”, “domains”, “George sheets”,.. sont laissé en anglais car ils seront, très souvent, utilisés en anglais et je les considèrent donc comme des termes techniques et ne souhaite pas embrouillé les lecteurs en utilisant des mots fr qui n'auront plus aucun lien avec les éléments concrets utiliser ensuite.)

(05 Février 2013)

Ryzom Core possède une énorme quantité de données pour faciliter le monde et son fonctionnement général. Cependant la nature des données de Ryzom Core embrouille souvent les nouveau utilisateur de la plateforme. Beaucoup voient la procédure de création MySQL et sans faute supposent que tout est contenu ici. En réalité les très peu de données sont vraiment contenue dans MySQL puisque la plateforme Ryzom Core a été développé à une époque avant que MySQL puissent été utilisé, de manière sure, pour une charge directe de travail tel que requis pour Ryzom.

Alors où les donnée sont-elles stockées dans RyzomCore ? Il y à une multitude de type et d'endroits. Il y à beaucoup de scénario unique également mais les éléments principaux sont:

• MySQL pour l'administration du “shard”, les applications “WebIG” les comptes utilisateurs.
• Georges Sheets pour les données statiques.
• Primitives pour le contenu du monde et sa disposition.
• PDR pour la persistance.

La base de données MySQL est uniquement utilisé par les services d'administration générale du shard. C'est la que les services du “shard” et les “domains” sont définis et comment AS (Admin Service / Service d'administration) sais ce qui dois être lancé et où. MySQL est aussi typiquement l'endroit ou toutes les application “Ryzom API” vont stocker leurs données persistantes qui ne sont pas directement lié aux données en jeu. Par exemple une application “boite mail” stockera très probablement les emails dans une base de données MySQL. Quand vous créer un compte pour Ryzom soit par un formulaire d'enregistrement personnalisé ou via la génération automatique activé par défaut votre compte utilisateur et vos privilèges sont stocké dans une base de données MySQL. Ce sont uniquement les informations de base comme le nom le mot de passe, le serveur auquel vous avez accès et avec quels privilèges ( tel que GM ou CSR ).

Pour comprendre ce que sont les “Georges Sheets” il faut comprendre ce que Ryzom définit comme “données statiques” à l'opposé du contenu du monde. Alors que les primitives, expliqués ensuite, ne contiennent pas d'informations persistantes et déposent le monde dans sa forme initiale. Les “Georges Sheets” ( qui sont compilé en “Packed sheet” un sujet plus complexe mais essentiellement une version binaire compressée des “sheets”) contiennent toutes les données statiques qui définissent des choses comme la faunes, les objets, les sort, et toutes les autre éléments de ce genre. Ces “sheets” définissent les caractéristiques qui mette en place une créatures ou un PNJ mais ne contiennent en fait aucune données spécifiques concernent cette créature ou ce PNJ. Ce sont les données de bases utiliser pour mettre le monde en place. Les “Shhets” contiennent également les autre objets statiques tel que des listes de titres, des éléments définissants les animations et les ensembles d'animation, les continents, les caractèristique de départs des joueurs, et bien plus. Toutes ses données sont contenues dans le dossier code/ryzom/common/data_leveldesign/leveldesign. On modifie ces “sheets” avec l'outil “George Editor” et sont essentiellement des fichier XML avec une capacité de relation parent/héritage.

Tandis que vous pouvez utiliser l’éditeur “George Editor” et créer une “sheets” de “créature PNJ” qui ne place ce PNJ nul part sur la carte, en fait qui ne décrit pas forcément un PNJ spécifique, Les primitives, éditées par l'outil “World Editor”, définissent ce à quoi la version initial du monde, non altéré par les joueurs, ressemblera. La disposition définie par les primitives est ce à quoi le monde ressemblera quand le serveur sera lancé pour la première fois. Pour illustrer les différences entre els primitives et les “sheets”, quand vous ajouter un nouveau PNJ vous fournissez tous les détails à propos de ce PNj incluant la possibilité de modifier sont équipement et sa couleur. Une des choses que vous faites en définissant un PNJ est de choisir le “sheet” qui le défini. Cela signifie que vous créer une “Sheet” de “créature PNJ” comme un modèle et ensuite êtes capable de déposer des PNJ, avec des caractéristiques définies, à travers le monde. Dans Ryzom Core vous ne pouvez pas placer une créature spécifique (faune), sachant que les mob et les PNJ sont deux choses distincte, à la place vous définissez ce que sera leur modèle et laisser l'IA se charger de le placer, le déplacer et le reste. Dans les primitives vous pouvez configurer ce comportement mais le contenu de votre primitive fera toujours référence à une “sheet” qui définit les caractéristiques de base de la faune en temps que modèle. Vous pouvez voir ce schéma maintenant, les “George Sheet fournissent le modèle, les primitives le positionnement et la structure, et le joueur fournit son évolution. Mais puisque ni George ni les primitive ne stocke l'état du monde cela nous amène a la partie suivante. Les données des primitives sont situées dans le répertoire code/ryzom/common/data_leveldesign/primitives. Vous pouvez les éditer avec le ”World Editor“ et sont essentiellement un format XML (appelé LIGO).

donc si MySQL, George et les primitives ne garde pas la trace des personnage, de l'équipement, des guildes et autre chose de ce genre qui persistent à travers les redémarrages du serveur qu'est ce qui le fait ? Le framework supportant Ryzom, NeL (Nevrax Library) possède un système riche et sophistiqué de sérialisation. Presque tous objet de Ryzom Core peux être sérialiser dans un flux pour être transmis à travers le réseau ou sauvegarder dans un fichier. Cela signifie qu'au lieu de devoir traduire un objet de personnage en une requête MySQL Ryzom Core est capable de simplement passer l'objet du personnage à un fichier objet NeL, le sauvegarder et le lire depuis le disque. Le service d'infrastructure de Ryzom Core va plus loin avec les PDR ou “Persistent Data Record system”. Ce système sophistiqué permet de répliquer les changements d'autre services du serveur et et maintenu sur le disque via un service de backup maitre/esclave. C'est la véritable source des données persistante en temps réel dans Ryzom Core. Les données sont stockées dans le répertoire saveshard et dépendent du type de donnée. Par exemple prenons les personnages “characters”, ils sont stocké dans le répertoire “code/ryzom/server/saveshard/characters” dans un schéma que le service détermine. Les fichiers actuel ressemble à quelque chose comme “code/ryzom/server/saveshard/characters/001/account10pdr.bin” où le 001 est simplement un mécanisme destiné à séparer les comptes dans plusieurs répertoires (de sorte que l'ont est pas 100k de fichier dans un seul répertoire. ), les deux autre chiffres ( 1 et 0) font référence, respectivement, à l'ID du compte et le slot du personnage. Vous pouvez voir le contenu des binaires PDR en utilisant pdr_util. Bien que cela ne soit pas encouragé puisque c'est typiquement des données interne de Ryzom Core, vous pouvez extraire des PDR au format XML, les éditer et les réassemble en utilisant cet outil. Cela peut être utilise pour, apr exemple, écrire un script d'édition de masse pour mettre à jours les personnages pour une raison ou une autre.

Source: Texte original anglais de Matt Raykowski (sfb) sur ryzomcore.org