Revision as of 20:29, 28 August 2014

DE translation needed please.

Ce tutoriel couvre l'installation et la configuration du client Ryzom lui-même. Il ne documente pas comment installer les dépendances, car cela peut changer d'une distribution à l'autre.

Installation de base

Il est possible d'utiliser rsync pour récupérer les données de Ryzom et le client 32 bits.

mkdir "$HOME/ryzom"
rsync -rtzv --progress --stats www.ryzom.com::ryzom "$HOME/ryzom/client"

On peut lancer le client avec la commande suivante : "$HOME/ryzom/client/ryzom_client"

Pour garder le répertoire à jour et démarrer le client plus facilement, on peut utiliser le script suivant et le déposer dans /usr/bin/ryzom

#!/bin/sh

ROOT_PATH="$HOME/ryzom"
CLIENT_PATH="$ROOT_PATH/client"

if [ ! $(pidof ryzom_client) ]; then
    rsync -rtzv --progress --stats www.ryzom.com::ryzom "$CLIENT_PATH"
fi

cd "$CLIENT_PATH"
./ryzom_client

N'oubliez pas de rendre le script exécutable en utilisant chmod a+x /usr/bin/ryzom. Maintenant, la commande ryzom, mettra à jour le client (si besoin) et le démarrera.

Installation de pointe

Si le client pré-compilé 32 bits ne répond pas à vos besoin, il est possible de le compiler soi-même à partir du code source. On peut trouver les dépendances et comment les installer sur la plupart des distributions dans ladocumentation Ryzom Core.

cd "$HOME/ryzom"
hg clone https://bitbucket.org/ryzom/ryzomcore
cd ryzomcore
hg update -c compatibility

Au lieu de revenir sur ce wiki à chaque fois que vous souhaitez compiler le client Ryzom, créez le script suivant. C'est une bonne idée de le mettre dans $HOME/ryzom/compile_client.sh.

#
# DOC: https://ryzomcore.atlassian.net/wiki/display/RC/Build+Source+on+Linux
# 

set -e

RYHOME="$HOME/ryzom/ryzomcore/code"

if [ ! -d "$RYHOME/build" ]; then
    mkdir "$RYHOME/build"
fi
cd "$RYHOME/build"

# Mettre à jour le code
hg pull
hg update

# Hack moche
sed -i "s/OPTIONAL/REQUIRED/" "../CMakeModules/FindLibwww.cmake"

# Compilons
cmake -DWITH_NEL_TESTS=OFF -DWITH_NEL_SAMPLES=OFF -DWITH_NEL_TOOLS=OFF -DWITH_RYZOM_SERVER=OFF -DWITH_RYZOM_TOOLS=OFF -DWITH_RYZOM_CLIENT=ON -DWITH_QT=OFF ..
make -j4

# Retour arrière sur le hack moche
hg revert "../CMakeModules/FindLibwww.cmake"

Notez que vous pourriez avoir à adapter vos flag cmake. Par exemple, sur ArchLinux, ajoutez -DFREETYPE_LIBRARY=/usr/lib/libfreetype.so -DFREETYPE_INCLUDE_DIR=/usr/include/freetype2/ -DFREETYPE_INCLUDE_DIRS=/usr/include/freetype2/. Sur certaines distributions, la partie "hack moche" n'est pas nécessaire.

Pour utiliser le client, il faut changer le script de démarrage (/usr/bin/ryzom):

#!/bin/sh

ROOT_PATH="$HOME/ryzom"
CLIENT_PATH="$ROOT_PATH/client"
CLIENT_EXE="$CLIENT_PATH/ryzom_client"
CLIENT_SAVE="$CLIENT_EXE.save"
CLIENT_CUSTOM="$ROOT_PATH/ryzomcore/code/build/bin/ryzom_client"

if [ ! $(pidof ryzom_client) ]; then
    if [ -f "$CLIENT_SAVE" ]; then
	cp -v "$CLIENT_SAVE" "$CLIENT_EXE"
    fi

    rsync -rtzv --progress --stats www.ryzom.com::ryzom "$CLIENT_PATH"

    if [ -f "$CLIENT_CUSTOM" ]; then
	mv "$CLIENT_EXE" "$CLIENT_SAVE"
	cp -v "$CLIENT_CUSTOM" "$CLIENT_EXE"
    fi
fi

cd "$CLIENT_PATH"
./ryzom_client

Et voila ! Souvenez vous que :

• Le script run ne met à jour que les données.
• Il faut lancer $HOME/ryzom/compile_client.sh manuellement pour compiler un nouveau client.
• Le script run utilisera votre client personalisé s'il est disponible. Il faut donc supprimer ou déplacer $HOME/ryzom/ryzomcore/code/build/bin/ryzom_client si vous voulez utiliser le client pré-compilé.