Les informations sur cette page ne sont plus à jour. Cela vous aidera peut-être, mais usez de votre discernement et adaptez.

Ceci est une ancienne révision du document !

Mises à jour des données de jeu pour le serveur Lirria

Tutoriel en cours de rédaction Il faut corriger dasn ce tuto le contenu des scripts qui font désormais appel à Git et plus Mercurial

Pour simplifier le déploiement de nouvelles données auprès du client (fichiers image, son), du serveur (certaines primitives) voire des deux (fichiers de traduction, datasheets), il peut être intéressant de créer des scripts qui font l'opération rapidement.

C'est ce que nous avons fait pour nos serveurs, à l'aide de trois scripts qui gèrent plusieurs cas de figures. Attention, ceux-ci ne vous sont présentés que comme référence, car il sera peut-être nécessaire de les adapter à vos besoins/votre environnement.

L'architecture sur laquelle se basent ces scripts est celle détaillée dans Installation d'un serveur de patchs. Tous les noms commencent par script_ pour qu'ils soient listés les uns à côté des autres.

Grâce à ces scripts, nous pouvons :

soit créer le fichier patch_lirria.bnp qui sera fourni lors d'un futur patch ;
soit créer un patch et l'activer avec des données clients ;
soit préparer un patch avec de nouvelles données client et serveur.

Préparation de données clients Lirria pour un patch futur

Ce script prend les data du client organisées dans un dépôt git dédié pour le client Lirria (khanat-data-client), où elles sont classées par répertoire futur de destination (lorsque nous travaillerons pour un serveur stable).

Pour l'heure, nous nous contentons de mettre à jour les .bnp des data mais bientôt tous ce mettera à jour (client compris).

script_regenerer_bnps_client.sh

#!/bin/bash
# Script pour récupérer les data du dépôt
# Puis en faire des .bnp 
# Dans le serveur de patch, prêt pour la
# génération du patch suivant
 
# On récupère les dernières datas du dépôt dans le répertoire, sur la branche lirria
cd ~/patch_service/khanat-data-client
git pull
git checkout lirria
 
# On va dans le répertoire de patch
cd ~/patch_service
 
# On copie les données récupérées
for folder in ~/patch_service/khanat-data-client/data/
    do cp -R $folder/fonts patch_lirria/
    done
 
for folder in ~/patch_service/khanat-data-client/data/
    do cp -R $folder/kh/* patch_lirria/
    done
 
for folder in ~/patch_service/khanat-data-client/data/
    do cp -R $folder/ryz/* patch_lirria/
    done
 
# On génère patch_lirria.bnp et on le met à sa place
for i in patch_lirria/* ; do bnp_make -p $i ; done
#rm ~/patch_service/patch_game/bnp/
for folder in ~/patch_service
    do cp $folder/patch_lirria/*.bnp ~/patch_service/patch_game/bnp/
    done
 
# On nettoie le répertoire de transit temporaire
rm -Rf patch_lirria/*
 
 
# On retourne à la racine du home
cd ~

Création et activation d'un patch

On doit avoir préparé un lot préalables de données clients (via le script ci-dessus Préparation de données clients Lirria pour un patch futur) qu'on souhaite désormais rendre disponibles via un patch avec ce script.

Si jamais on souhaite également mettre à jour des primitives, datasheets ou des données serveur, il faut préférer exécuter le script suivant : Création des données serveur d'un patch et activation de celui-ci.

Il suffira de remplir la release note si on le souhaite, puis, surtout, d'incrémenter de 1 le numéro de version de patch de Lirria.

script_creation_patchs_simple.sh

#!/bin/bash
set -o verbose
 
# ===================  IMPORTANT ===================
#
# Il faut juste incrémenter de 1 l'indice comme habituellement
# Cela est proposé automatiquement à la fin, après
# le patch-release
#
### VERIFIER QU'ON A BIEN LISTE TOUS LES NOUVEAUX BNP DANS $PATCH_CLIENT_SYSTEM/patchgame/ryzom.xml
### DANS LE CAS OÙ ON A DÉCIDÉ DE PATCHER D'AUTRES BNP QUE CEUX GÉNÉRÉS AUTOMATIQUEMENT PAR
### LES DEUX SCRIPTS :
# * script_mise_a_jour_data_serveur.sh
# * script_regenerer_bnps_client.sh
# Il faut alors modifier comme ci-dessous :
# nano $PATCH_CLIENT_SYSTEM/patchgame/ryzom.xml
# Ligne ajoutée pour les données issues du serveur :
#    			<_Files type="STRING" value="dataserver.bnp"/>
 
# On va dans le bon répertoire
cd ~/patch_service
 
# On génère un nouveau patch
patch_gen updateProduct patch_game/ryzom.xml
 
# On peut éditer la release note à cette occasion :
nano patch_game/patch/index.php
 
# On peut activer la mise à disposition du patch
# Il suffit d'incrémenter de 1 les deux chiffres du fichier Lirria.version ci-dessous
nano patch_game/patch/Lirria.version
 
# On revient au départ
cd ~

Création des données serveur d'un patch et activation de celui-ci

Ce script réalise la même opération que le script Création et activation d'un patch mais il effectue au préalable la mis à jour des données au niveau du serveur et d'éventuelles données communes au client et au serveur.

Il se sert d'un fichier kh_server.bnp et les kh_translate_*.bnp généré automatiquement à partir des données des dépôts correspondant et des fichiers calculés pour le serveur de jeu.

Attention ce script stoppe le serveur de jeu le temps de recalculer les fichiers .packed_sheets, sheet_id.bin et visual_slot.tab. Il le relance à la fin de la procédure.

Il suffira de remplir la release note si on le souhaite, puis, surtout, d'incrémenter de 1 le numéro de version de patch de Lirria.

script_mise_a_jour_data_serveur.sh

#!/bin/bash
set -o verbose
 
# ===================  IMPORTANT ===================
# Ce script stoppe et relance le shard tout seul
#
# Il sert à recalculer les packed_sheets, sheet_id.bin et
# visual_slot.tab après que des changements de datasheets dans 
# khaganat-data aient été pullés.
# Il est donc nécessaire de faire un patch client
# qui est automatiquement mis en place à la fin du script
#
# Il faut juste incrémenter de 1 l'indice comme habituellement
#
# Cela est proposé automatiquement à la fin, après
# l'éventuelle modification de la patch-release
# 
# ------------- Editer ces variables ---------------
 
 
# indiquer ici le dossier d'installation des sources RC
export RYZOM_HOME=~/khanat-code
export RYZOM_DATA_HOME=~/khanat-ressources
export PATCH_CLIENT_SYSTEM=~/patch_service
 
# ------------- Fin des variables ---------------
 
# On va dans le répertoire des data
cd $RYZOM_DATA_HOME
 
# On met à jour les données avec la branche Lirria du dépot de data
git pull https://git.khaganat.net/khaganat/khanat-ressources.git
git checkout lirria
 
 
# On stoppe le shard
shard stop
 
# supprimer les anciennes packed_sheets du dossier serveur et dossier client
rm -f $RYZOM_HOME/code/ryzom/client/data/*.packed_sheets
rm -f $RYZOM_HOME/code/ryzom/server/data_shard/*.packed_sheets
rm -f $RYZOM_HOME/code/ryzom/common/data_common/visual_slot.tab
 
# regénérer le fichier sheet_id.bin
 
cd $RYZOM_HOME/code/build/bin
./make_sheet_id -o$RYZOM_DATA_HOME/leveldesign/game_elem/sheet_id.bin $RYZOM_DATA_HOME/leveldesign/game_elem $RYZOM_DATA_HOME/leveldesign/game_element $RYZOM_DATA_HOME/leveldesign/world $RYZOM_DATA_HOME/leveldesign/ecosystems $RYZOM_DATA_HOME/sound
 
# regénérer les packed_sheets
cd $RYZOM_HOME/code/ryzom/tools/sheets_packer
./sheets_packer
 
# copier le nouveau visual_slot.tab aux bons endroit
cp visual_slot.tab $RYZOM_HOME/code/ryzom/client/data/visual_slot.tab
cp visual_slot.tab $RYZOM_HOME/code/ryzom/common/data_common/visual_slot.tab
 
# On obtient dans $RYZOM_HOME/code/ryzom/client/data/ :
# - les packed_sheets du client
# - le fichier lmconts.packed
# Dans $RYZOM_HOME/code/ryzom/common/data_common/
# - le visual_slot.tab
# Dans $RYZOM_DATA_HOME/leveldesign/game_elem/
# - le sheet_id.bin
 
# On copie les données nécessaires au client dans le répertoire de création du patch.
# Cela inclue les fichiers de traduction
 
rm -Rf $PATCH_CLIENT_SYSTEM/dataserver/kh_translate_fr/*
rm -Rf $PATCH_CLIENT_SYSTEM/dataserver/kh_translate_en/*
rm -Rf $PATCH_CLIENT_SYSTEM/dataserver/kh_translate_wk/*
rm -Rf $PATCH_CLIENT_SYSTEM/dataserver/kh_translate_es/*
rm -Rf $PATCH_CLIENT_SYSTEM/dataserver/kh_translate_de/*
rm -Rf $PATCH_CLIENT_SYSTEM/dataserver/kh_translate_ru/*
rm -Rf $PATCH_CLIENT_SYSTEM/kh_server/*
cp $RYZOM_HOME/code/ryzom/common/data_common/database.xml $PATCH_CLIENT_SYSTEM/kh_server/
cp $RYZOM_HOME/code/ryzom/common/data_common/msg.xml $PATCH_CLIENT_SYSTEM/kh_server/
cp $RYZOM_HOME/code/ryzom/client/data/*.packed_sheets $PATCH_CLIENT_SYSTEM/kh_server/
cp $RYZOM_HOME/code/ryzom/client/data/*.packed $PATCH_CLIENT_SYSTEM/kh_server/
cp $RYZOM_HOME/code/ryzom/common/data_common/visual_slot.tab $PATCH_CLIENT_SYSTEM/kh_server/
cp $RYZOM_DATA_HOME/leveldesign/game_elem/sheet_id.bin $PATCH_CLIENT_SYSTEM/kh_server/
cp $RYZOM_DATA_HOME/translation/translated/*fr.* $PATCH_CLIENT_SYSTEM/dataserver/kh_translate_fr/
cp $RYZOM_DATA_HOME/translation/translated/*en.* $PATCH_CLIENT_SYSTEM/dataserver/kh_translate_en/
cp $RYZOM_DATA_HOME/translation/translated/*wk.* $PATCH_CLIENT_SYSTEM/dataserver/kh_translate_wk/
cp $RYZOM_DATA_HOME/translation/translated/*es.* $PATCH_CLIENT_SYSTEM/dataserver/kh_translate_es/
cp $RYZOM_DATA_HOME/translation/translated/*de.* $PATCH_CLIENT_SYSTEM/dataserver/kh_translate_de/
cp $RYZOM_DATA_HOME/translation/translated/*ru.* $PATCH_CLIENT_SYSTEM/dataserver/kh_translate_ru/
 
# On va dans le répertoire où on va générer le nouveau dataserver.bnp
cd $PATCH_CLIENT_SYSTEM/dataserver/
bnp_make -p kh_translate_fr
bnp_make -p kh_translate_en
bnp_make -p kh_translate_wk
bnp_make -p kh_translate_es
bnp_make -p kh_translate_de
bnp_make -p kh_translate_ru
cd $PATCH_CLIENT_SYSTEM/
bnp_make -p kh_server
rm $PATCH_CLIENT_SYSTEM/patch_game/bnp/kh_translate_fr.bnp
rm $PATCH_CLIENT_SYSTEM/patch_game/bnp/kh_translate_en.bnp
rm $PATCH_CLIENT_SYSTEM/patch_game/bnp/kh_translate_wk.bnp
rm $PATCH_CLIENT_SYSTEM/patch_game/bnp/kh_translate_es.bnp
rm $PATCH_CLIENT_SYSTEM/patch_game/bnp/kh_translate_de.bnp
rm $PATCH_CLIENT_SYSTEM/patch_game/bnp/kh_translate_ru.bnp
rm $PATCH_CLIENT_SYSTEM/patch_game/bnp/kh_server.bnp
 
mv dataserver/kh_translate_fr.bnp $PATCH_CLIENT_SYSTEM/patch_game/bnp/
mv dataserver/kh_translate_en.bnp $PATCH_CLIENT_SYSTEM/patch_game/bnp/
mv dataserver/kh_translate_wk.bnp $PATCH_CLIENT_SYSTEM/patch_game/bnp/
mv dataserver/kh_translate_es.bnp $PATCH_CLIENT_SYSTEM/patch_game/bnp/
mv dataserver/kh_translate_de.bnp $PATCH_CLIENT_SYSTEM/patch_game/bnp/
mv dataserver/kh_translate_ru.bnp $PATCH_CLIENT_SYSTEM/patch_game/bnp/
mv kh_server.bnp $PATCH_CLIENT_SYSTEM/patch_game/bnp/
 
read -p "Appuyer sur une touche pour continuer ."
# On peut éventuellement ajouter dans $PATCH_CLIENT_SYSTEM/patchgame/bnp/ les autres .bnp qui doivent être patchés
 
### VERIFIER QU'ON A BIEN LISTE TOUS LES NOUVEAUX BNP DANS $PATCH_CLIENT_SYSTEM/patchgame/ryzom.xml
# nano $PATCH_CLIENT_SYSTEM/patchgame/ryzom.xml
# Ligne ajoutée pour les données issues du serveur :
#    			<_Files type="STRING" value="dataserver.bnp"/>
 
# On génère un nouveau patch
patch_gen updateProduct patch_game/ryzom.xml
 
read -p "Appuyer sur une touche pour continuer ."
# On peut éditer la release note à cette occasion :
nano patch_game/patch/index.php
 
# On peut activer la mise à disposition du patch
# Il suffit d'incrémenter de 1 les deux chiffres du fichier Lirria.version ci-dessous
nano patch_game/patch/Lirria.version
 
# On relance le shard
shard start

Détail sur patch_gen

Pour avoir plus de détail sur le programme pacth_gen Patch gen

serveur, MMORPG, tutoriel, shard, obsolète