Ryzom Forge Wiki - User contributions [en]

Ryzom Installer Manual

2018-11-22T19:50:51Z

Riasan: /* Error missing DDL */

{{Migrated to|:en:Ryzom Installer Manual}}
{{TabLang|EN|DE|Ryzom_Installer_Manual|ES|Manuel de l'Installeur Ryzom|RU}}

{{toTrad|DE}}
{{toTrad|EN|To check the quality of the text itself}}
{{toTrad|ES}}
{{toTrad|RU}}

{{TPInWikiRyzom}}
[[Category:EN]]
[[Category:Tutorials]]

==What is Ryzom Installer?==

"Ryzom Installer" is a new tool to handle the migration from 2.1 to 3.0. It has been created because 2.1 client doesn't support all platforms (it only supports Windows 32 bits) and it is installed in a "wrong" location (a MMORPG shouldn't be installed in C:\Program Files because this directory is not writable by a normal user and requires Administrator permissions).

It’s called "Installer" because it can be used to install Ryzom from scratch and download required data.

==How does Ryzom Installer works?==

The first time a player on version 2.1 client launches the game, it’s the Installer that launches instead of client. It detects it must migrate current data and copies them to a new location (where user can write). After the migration, it displays a simple dialog with the choice of a "profile" (a default one is created during migration) and allows to click on Play or Configure.

Once everything is done, the player is able to launch Ryzom as usual clicking on an icon or using the Installer.

*'''Q: How much time the migration takes?'''

**A: Only the time needed to copy the files.

*'''Q: Some are still having an older client than 2.1, like 2.0 on Mac or even older ones. Are any of these supported here as well?'''

**A: It patches only Windows client because no other client is using official patch system. Windows 2.0 clients patch to 3.0 using Installer. If patch is working, it patches, even with 1.x clients. It won't change anything. For Linux and OS X players, they’ll have to download the Installer. In all cases, all players who are using beta clients are migrating automatically, without the need of the Installer.

==Configuration file used or created by Ryzom Installer==

Each user choice is saved in a configuration file named ryzom_installer.ini. You can open https://bitbucket.org/ryzom/ryzomcore/src/05465687c514be172eadb4d39d670714219d4558/code/ryzom/tools/client/ryzom_installer/res/ryzom_installer.ini?at=compatibility-develop&fileviewer=file-view-default with your browser to see its default content. This file is integrated into Ryzom Installer binary and is copied in C:\Users\<your name>\AppData\Local\Ryzom even if you chose a different location during migration.

After the default profile is created (at the end of the migration), its content should be like that :

version=3

[common]
language=fr
source_directory=
installation_directory=C:/Users/Kervala/AppData/Local/Ryzom
use_64bits_client=true
should_uninstall_old_client=true
installer_filename_windows=ryzom_installer_qt_r.exe
installer_filename_osx=RyzomInstaller.app/Contents/MacOS/RyzomInstaller
installer_filename_linux=ryzom_installer_qt

[product]
name=Ryzom
publisher="Winch Gate Property Limited"
url_about=http://ryzom.com/?lang=$LANG
url_help=http://app.ryzom.com/app_forum/index.php?page=topic/view/22047/1&post149889=$LANG#1
comments=Science-fantasy MMORPG

[servers]
size=1

[server_0]
id=ryzom_live
name=Atys
display_url="http://app.ryzom.com/app_releasenotes/index.php?lang=$LANG"
files_list_url="https://sourceforge.net/projects/ryzom/rss?path=/installer"
data_download_url="http://downloads.sourceforge.net/project/ryzom/installer/ryzom_live_data.7z?r=&ts=$TIMESTAMP"
data_download_filename=ryzom_live_data.7z
data_compressed_size=1500000000
data_uncompressed_size=7000000000
client_download_url="http://downloads.sourceforge.net/project/ryzom/installer/ryzom_live_client_$ARCH.7z?r=&ts=$TIMESTAMP"
client_download_filename=ryzom_live_client_$ARCH.7z
client_filename_windows=ryzom_client_r.exe
client_filename_osx=Ryzom.app/Contents/MacOS/Ryzom
client_filename_linux=ryzom_client
client_filename_old_windows=client_ryzom_rd.exe
configuration_filename_windows=ryzom_configuration_qt_r.exe
configuration_filename_osx=Ryzom.app/Contents/MacOS/RyzomConfiguration
configuration_filename_linux=ryzom_configuration_qt
comments=

[profiles]
size=1
default=0

[profile_0]
id=0
name=Ryzom (Atys)
server=ryzom_live
executable=
arguments=
comments=Default profile created by Ryzom Installer
desktop_shortcut=true
menu_shortcut=true

* [product] section contains details on Ryzom that will be used in "App/Remove programs" and other locations.
* [server_X] sections include files required by a server, files to copy, space required, etc... :) for the moment, only ryzom_live (= Atys) is supported.
* [profiles] are saved in different sections [profile_X] with a number.

*'''Q: In edit profile window we still can put in login details in arguments to automatically log in? same like in a shortcut?'''

**A: Indeed. And it'll update shortcuts if they are checked. if you have several accounts, it'll be useful. You can even choose another client and it'll display its version. It can be useful if you want to use a DEV client for example.

**Ryzom Installer allows to edit this file easily, but that's always good to understand where are stored users data and their content:
***Patched files (client, data, etc...) are located in the directory you chose during migration or, by default, C:\Users\<your name>\AppData\Local\Ryzom\ryzom_live (where ryzom_live is the ID of the server).
***Users files (client.cfg, client.log, user, save, screenshots, music, etc...) are located in C:\Users\<your name>\AppData\Roaming\Ryzom\<profile id>

*'''Q:Can we choose to install them elsewhere?'''

**A:Yes. We can put where we want the client data. The location that can be changed is the one to C:\Users\<your name>\AppData\Local\Ryzom, C:\Users\<your name>\AppData\Roaming\Ryzom\<profile id> can't be changed. Perhaps later... Under Windows, “Local“ is big data specific to current machine, “Roaming” is user data that must be copied on each machine user is connected (it makes sense in the case on a Windows network using a domain).

*'''Q: What is the goal of this structure?'''

**A: Being able to have several data files for each server (Atys, Yubo, Kaghanat, Tempest in the Aether, etc) and several clients/accounts. So if you have 4 accounts on Atys, you'll have one server (ryzom_live) and 4 profiles (0, 1, 2, 3) with different client.cfg and distinct user files. And you'll be able to play simultaneously without having 4 copies of whole data. The locations of files and ryzom_installer.ini will be different on each platform.

*'''Q: Why isn't it stored in the same directory the game is?'''

**A: Because we need to centralize the configuration file else Ryzom Installer won't find it if we launch it from elsewhere.

*'''Q: How can I find the folder where my screenshots, client.fg or client.log are located?'''

**A: C:\Users\<your name>\AppData\Roaming\Ryzom\<profile id> where 'AppData' is usually a hidden folder. There are at least 3 ways to open the folder and to go ahead to your location:

***Open the Ryzom Installer, go to Settings -> Profile, choose your Profile on the left, click on 'Open' next to 'Directory' on the right side.

***Go to Windows Explorer and type in the address bar %AppData% and press enter.

***Go to Windows Explorer, open your C:\ drive, click on 'Organize', select 'Folder and Search' option, Select 'View' tab in the new window. Under 'Files and Folders' -> 'Hidden files and folders', select the option to 'Show hidden files, folders and drives'. Click on 'OK' and from now on you always can find and open AppData directory.

**For Windows XP the location is: C:\Documents and Settings\yourname\Application Data\Ryzom\0

==Advices==

*Never uncompress the downloaded 7z files manually.
*Both ryzom_live_data.7z and ryzom_live_client_win32.7z (or ryzom_live_client_win64.7z) must be let untouched.
*Never launch ryzom_client_patcher.exe yourself.

==Linux version of Ryzom Installer==

Linux version of Ryzom Installer is available on http://ryzom.com (just click on Linux logo to download it).

You get a ryzom_installer_linux.tar.bz2 to uncompress, it'll create a ryzom_installer_linux directory with 32 and 64 bits versions of Installer and a ryzom_installer_linux.sh script that'll launch the right Installer depending on your platform.

Choose where you want to install Ryzom data and client (by default in ~/.local/share/Ryzom), wait until it downloaded and uncompress all files.

If you want to use your interfaces, configurations, etc... you just need to copy them to ~/.local/share/Ryzom/0

If you have error 307 or error 0 message, just download :
*https://sourceforge.net/projects/ryzom/files/installer/ryzom_live_data.7z/download
*https://sourceforge.net/projects/ryzom/files/installer/ryzom_live_client_linux32.7z/download
*https://sourceforge.net/projects/ryzom/files/installer/ryzom_live_client_linux64.7z/download

You should have "Ryzom Installer" and "Ryzom (Atys)" entries in your applications menu.

If Ryzom doesn't want to start, you may need to install OpenAL on your distribution (you can check that by trying to launch it using command-line).

To start Ryzom (and use your first profile) from command-line, you can use : ~/.local/share/Ryzom/ryzom_live/ryzom_client -p 0

==How to remove the installer and files?==

Go in "Add/Remove programs, it should launch Installer in Uninstaller mode and allow to check components you want to uninstall.

If something went wrong, you may need to check these locations :

*Under Windows XP :
*C:\Documents and Settings\<user name>\Local Settings\Application Data\Ryzom
**C:\Documents and Settings\<user name>\Application Data\Ryzom

*Under Windows Vista and up :
**C:\Users\<user name>\AppData\Local\Ryzom
**C:\Users\<user name>\AppData\Roaming\Ryzom

==Different problems and their solutions==

===What to check and to ask when a player has a problem===

*a screenshot of the error
*what is their platform : Windows, Linux, OS X, 32 or 64 bits
*screenshot of C:\Program Files (x86)\Ryzom
*screenshot of C:\Users\<login>\AppData\Local\Ryzom
*screenshot of C:\Users\<login>\AppData\Local\Ryzom\ryzom_live
*(screenshot of another directory if they didn’t install Ryzom Installer in default directories)
*copy-paste of C:\Users\<login>\AppData\Local\Ryzom\ryzom_installer.ini
*copy-paste of C:\Users\<login>\AppData\Roaming\Ryzom\0\client.log
*copy-paste of C:\Users\<login>\AppData\Roaming\Ryzom\0\client.cfg
*screenshot of C:\Users\<login>\AppData\Roaming\Ryzom\0\user content
*(if they used a profile different of 0, replace the 0 by the right profile ID before)

===Ryzom Installer can't run and displays an error message box===

Ryzom Installer, after installing it, is using 32 bits DLLs in C:\Users\<login>\AppData\Local\Ryzom and Ryzom Installer from C:\Users\<login>\AppData\Local\Ryzom\ryzom_live should be in 64 bits if you chose a 64 bits client. After a patch, client is copying Ryzom Installer from C:\Users\<login>\AppData\Local\Ryzom\ryzom_live to C:\Users\<login>\AppData\Local\Ryzom and then DLLs in C:\Users\<login>\AppData\Local\Ryzom could be incompatible with the copied Ryzom Installer :( The temporary fix is to copy both msvcp100.dll, msvcr100.dll and ryzom_installer_qt_r.exe from C:\Users\<login>\AppData\Local\Ryzom\ryzom_live to C:\Users\<login>\AppData\Local\Ryzom. This will be fixed in next patch.

===Ryzom Installer seems blocked/stalled===

If Ryzom Installer seems blocked/stalled, it can be because there was a previously version of Ryzom Installer that wasn’t properly uninstalled or if player moved directories and configuration file became invalid. In this case, it’s possible to uninstall it completely by removing whole content of C:\Users\<login>\AppData\Local\Ryzom and C:\Users\<login>\AppData\Roaming\Ryzom but please be sure that player hasn’t files he would like to keep before doing that. In that case, always make a backup.

===Not enough disk space===

If players have not enough disk space, it should notify them and they'll have to chose another location.

===Error 6===

It means than the downloaded 7z file was incomplete and Ryzom Installer couldn't uncompress it. The best fix is to find the file in C:\Users\<login>\AppData\Local\Ryzom and to change its extension from .7z to .7z.part (just adding a .part). If you restart Ryzom Installer, it should try to resume the file. If it takes too long, you can download it manually (see error 307) and move it to C:\Users\<login>\AppData\Local\Ryzom.

===Error 126 on a ATI/AMD card===

If a player with an ATI/AMD card has an error 126 when launching Ryzom or Configuration (it should only display the splash screen and then the error in a dialog), you need to go to C:\Windows\System32 and copy atio6axx.dll to atiogl64.dll After this change, Ryzom should launch :)

===Error 307 & Error 0 & "File is larger than expected"===

It’s a problem with Sourceforge.

First you need to close Ryzom Installer.

To fix that you can manually download the required files :
*Data : https://sourceforge.net/projects/ryzom/files/installer/ryzom_live_data.7z/download
*Windows 64 bits client : https://sourceforge.net/projects/ryzom/files/installer/ryzom_live_client_win64.7z/download
*Windows 32 bits client : https://sourceforge.net/projects/ryzom/files/installer/ryzom_live_client_win32.7z/download
*Linux 64 bits client : https://sourceforge.net/projects/ryzom/files/installer/ryzom_live_client_linux64.7z/download
*Linux 32 bits client : https://sourceforge.net/projects/ryzom/files/installer/ryzom_live_client_linux32.7z/download
*OS X client : https://sourceforge.net/projects/ryzom/files/installer/ryzom_live_client_osx.7z/download

Data are always required and you need to download the right client.

Then you move all these 7z files in :
*Windows : C:\Users\<login>\AppData\Local\Ryzom
*Linux : HOME/.local/share/Ryzom
*OS X: HOME/Library/Application Support/Ryzom

And relaunch Ryzom Installer, it should detect files and uncompress them.

===Direct3D driver / OpenGL===

If player used a Direct3D driver with 2.1 client and since client.cfg will be copied, it’ll continue to use D3D. Now that OpenGL is recommended driver for all cards, players could need to switch to it manually clicking on Configure button in Ryzom Installer and select OpenGL (or Auto) instead of Direct3D. If not, he could have texture issues.

===White or black textures===

The default quality has been improved in v3 clients. By the way, v3 clients use 128 Mo of video memory against 32 Mo for v2's ones.

The textures are sent to the graphic card's memory. If you see them in white or black, it's probably because your graphic card has not got enough memory to stock them.
Moreover, if your graphic card does not support the compressed textures, Ryzom detects it and unzips them before to send them.

So in case of white or black graphic issue, please reduce the graphic qualities in Configuration and deactive FXAA (lower graphic quality and no effects), it should help to fix the problem.
If it does not work, try to switch from OpenGL to Direct3D. It could fix the texture issue... but you'll see the trees moving, trunk included (know bug: https://bitbucket.org/ryzom/ryzomcore/issues/160/wind-tree-vp-not-working-correcly-under ).

===point_except_handler4_common could not be located in the dynamic link library msvcrt.dll===

Error is The procedure entry point_except_handler4_common could not be located in the dynamic link library msvcrt.dll, to fix it you need to :
*Browse to C:\Windows\System32 folder and find file '''dwmapi.dll'''
*Rename this file from '''dwmapi.dll''' to '''dwmapi.dll_old'''

===Player can't start client because of a wrong DLL===

*Edit C:\Users\<login>\AppData\Local\Ryzom\ryzom_installer.ini, remove the directory after '''source_directory=''' to be sure, it won't copy again from old client
*Remove completely all DLLs and EXEs in C:\Users\<login>\AppData\Local\Ryzom\ryzom_live
*Download the right client on SourceForge (see Error 307)
*Put it to C:\Users\<login>\AppData\Local\Ryzom (don't uncompress it!)
*Restart Ryzom Installer
*It should uncompress the new client and you should be able to patch and play after that

===Error missing DLL===

*If you get by start of Installer the Error Box with msvcp120.dll or msvcr120.dll are missing pleas download and install the "Visual C++ Redistributable Packages for Visual Studio 2013"
*Visual C++ Redistributable Packages for Visual Studio 2013 : https://www.microsoft.com/en-us/download/details.aspx?id=40784

===Case of manually move of "ryzom_live" folder===

If player manually moves "ryzom_live" folder or another one, Ryzom Installer won't detect it and player will have to edit his ryzom_installer.ini

===German players with an English Windows environment===

If German player has an English Windows environment than Ryzom will start in English too, even when the user has chosen a German installation (this only chose the language for the installation process, not the language for the game itself)

===Location of default files under all platforms===

*Windows Vista and up :
**C:\Users\<login>\AppData\Local\Ryzom
**C:\Users\<login>\AppData\Roaming\Ryzom
*Windows XP :
**C:\Documents and Settings\<login>\Local Settings\Application Data\Ryzom
**C:\Documents and Settings\<login>\Application Data\Ryzom
*Linux :
**HOME/.local/share/Ryzom (both profiles (0, 1, 2, etc…) and servers (ryzom_live, ryzom_dev, etc…) are in the same directory)
*OS X :
**HOME/Library/Application Support/Ryzom (both profiles (0, 1, 2, etc…) and servers (ryzom_live, ryzom_dev, etc…) are in the same directory)
**HOME/Library/Containers/com.winchgate.Ryzom/Data/Library/Application Support/Ryzom for AppStore version

===What to do if I do not find a solution to my problem in this list?===

Please come on #ryzom on IRC Freenode (direct link: http://webchat.freenode.net/?channels=ryzom and someone will help you in direct!

===No sound when using OpenAL driver===

Be sure to have installed https://www.openal.org/downloads/oalinst.zip (under Windows) or OpenAL package for your distribution (libopenal1 under Debian-based ones). OpenAL is always installed under OS X.

===Unable to install OS X version of Ryzom Installer===

* Open '''System Preferences'''
* Open the '''Security & Privacy''' pane
* Select the '''General''' tab
* Click on '''Open anyway''' next to '''Ryzom Installer''' and it'll open '''Ryzom Installer''' package

===If there are any bug with Ryzom Installer===

In all cases, if you found a bug with '''Ryzom Installer''', you can download and install latest versions from http://ryzom.com and try it. They'll be updated regularly.

===My download is very slow===

You can close '''Ryzom Installer''', Sourceforge should redirect to a best mirror and your download will resume.

===Crash after teleporting===

It could be related to '''XAudio2''' driver under Windows. You can switch to '''FMod''' driver and check if it's better, to do that simply add to your client.cfg :

DriverSound = "FMod";

===Ryzom Installer is always copying old data===

You should need to uninstall Ryzom Installer and reinstall it or edit ryzom_installer.ini and remove directory on line '''source_directory='''

===No OpenGL driver for ATI Radeon HD 4500 series===

Download legacy drivers on : http://support.amd.com/fr-fr/download/desktop/legacy?product=legacy2&os=Windows%207%20-%2064

If this case occurs, you should see in client.log :

2016/10/25 03:31:16 INF 2d0 ryzom_client_r.exe driver_opengl_extension.cpp 1589 NL3D::registerGlExtensions : 3D: OpenGL 1.1.0 / Microsoft Corporation / GDI Generic

===Crash before character selection and after login===

If player has '''nel_report_*.log''' with content :

A failed assertion occurs
ProcName: ryzom_client_r.exe
Date: 2016/10/30 11:14:29
File: Z:/home/nevrax/ryzomcore/code/nel/include\nel/misc/singleton.h
Line: 155
FuncName: NLMISC::CManualSingleton<class NLSOUND::CListenerFMod>::getInstance
Reason: "_instance() != NULL"
-------------------------------

No log
-------------------------------

And last lines in client.log :

2016/10/30 12:59:27 INF 5e8 ryzom_client_r.exe common.cpp 682 NLMISC::Exception::Exception : Exception will be launched: Failed to create the FMod driver object
2016/10/30 12:59:27 WRN 5e8 ryzom_client_r.exe audio_mixer_user.cpp 479 NLSOUND::CAudioMixerUser::initDevice : Failed to create the FMod driver object

Then player system don't succeed to load FMod driver :( I suggest to switch back to XAudio2 driver by adding to their '''client.cfg''' :

DriverSound = "XAudio2";

===Player launched Ryzom, don't see any window on the screen but the icon is present in task bar===

Coordinates of Ryzom window are outside the screen, to fix that :

* launch Ryzom Configuration by clicking on Configure
* in Display section you can check values for '''Position X''' and '''Position Y''' and correct them
* click on '''Apply'''

===Player receives "Empty answer from server (error code 62)"===

If this error message occurs, it means that Ryzom didn't receive any response from server. In most of cases, it's related to a connection problem. If you have an anti-virus and/or a firewall you could try to disable them (at least to check if it works).

You can also try to display URL : http://shard.ryzom.com:40916/login/r2_login.php?cmd=ask

If it displays an error message or a blank page, you found the problem (that's your connection), if it displays the correct message : '''0:Invalid account: (2001) (in askSalt)''' it's something else.

===Client crashed with Access Violation exception generated at 0xXXXX, thread attempts to read at 0xXXXXX===

It's a standard crash, you need to gather more details depending on the moment where it crashed.

* If before displaying login screen : corrupted data, bad 3D driver, etc...
* If after login screen but before character selection : bad sound driver, corrupted data, etc...
* If after character selection/creation : FXAA (you need to disable 3D effects), corrupted data, etc...

===Unable to install Ryzom Installer under OS X===

With old OS X versions, you can get an error message when installing Ryzom Installer, to workaround that you can directly download a ZIP file containing Ryzom Installer on:
http://devl1.ryzom.com/RyzomInstaller.zip

=== Error codes from Ryzom Installer ===

These errors are from Qt, you can find them on : http://doc.qt.io/qt-5/qabstractsocket.html#SocketError-enum

==Installation of server test Yubo (v3)==

'''WARNING: you can only access Yubo shard if you have got a specific account with yubo access.'''

To add Yubo with Ryzom Installer, just follow these steps :

-close Ryzom Installer if it is launched

-show your hidden folders

-WINDOWS: go to C:\Users\<login>\AppData\Local\Ryzom - or type %appdata% in explorers' addressbar and go back one time to find local folder

-MAC: go to ~/Library/Application Support/Ryzom

-LINUX: go to ~/.local/share/Ryzom under Linux or the other folder where you installed Ryzom

-copy ryzom_live folder to ryzom_dev

-open ryzom_installer.ini with a text editor (Wordpad, notepad++, gedit, etc...)

(to find it:
WINDOWS -> C:\Users\<login>\AppData\Local\Ryzom - or type %appdata% in explorers' addressbar and go back one time to find local folder
MAC -> find the ryzom_installer.ini in /Users/<Your UserID>/Library/Application Support/Ryzom

- delete all parts beginning by [servers] and [server_0] and put :

[servers]
size=2

[server_0]
id=ryzom_live
name=Atys
display_url="http://app.ryzom.com/app_releasenotes/index.php?lang=$LANG"
files_list_url="https://sourceforge.net/projects/ryzom/rss?path=/installer"
data_download_url="http://downloads.sourceforge.net/project/ryzom/installer/ryzom_live_data.7z?r=&ts=$TIMESTAMP"
data_download_filename=ryzom_live_data.7z
data_compressed_size=1500000000
data_uncompressed_size=7000000000
client_download_url="http://downloads.sourceforge.net/project/ryzom/installer/ryzom_live_client_$ARCH.7z?r=&ts=$TIMESTAMP"
client_download_filename=ryzom_live_client_$ARCH.7z
client_filename_windows=ryzom_client_r.exe
client_filename_osx=Ryzom.app/Contents/MacOS/Ryzom
client_filename_linux=ryzom_client
client_filename_old_windows=client_ryzom_rd.exe
configuration_filename_windows=ryzom_configuration_qt_r.exe
configuration_filename_osx=Ryzom.app/Contents/MacOS/RyzomConfiguration
configuration_filename_linux=ryzom_configuration_qt
comments=

[server_1]
id=ryzom_dev
name=Yubo
display_url="http://app.ryzom.com/app_releasenotes/index.php?lang=$LANG"
files_list_url="https://sourceforge.net/projects/ryzom/rss?path=/installer"
data_download_url="http://downloads.sourceforge.net/project/ryzom/installer/ryzom_live_data.7z?r=&ts=$TIMESTAMP"
data_download_filename=ryzom_live_data.7z
data_compressed_size=1500000000
data_uncompressed_size=7000000000
client_download_url="http://downloads.sourceforge.net/project/ryzom/installer/ryzom_live_client_$ARCH.7z?r=&ts=$TIMESTAMP"
client_download_filename=ryzom_live_client_$ARCH.7z
client_filename_windows=ryzom_client_r.exe
client_filename_osx=Ryzom.app/Contents/MacOS/Ryzom
client_filename_linux=ryzom_client
client_filename_old_windows=client_ryzom_rd.exe
configuration_filename_windows=ryzom_configuration_qt_r.exe
configuration_filename_osx=Ryzom.app/Contents/MacOS/RyzomConfiguration
configuration_filename_linux=ryzom_configuration_qt
comments=Test server

- save the file

- WINDOWS: launch Ryzom Installer in Ryzom's main folder

- MAC: launch Ryzom Installer in /Applications

- LINUX: launch Ryzom Installer in Applications menus

- create new profiles in Settings -> Profiles, you should have Atys and Yubo as server choice now :)

- click on "Open" button to open profile folder

- open client.cfg with a text editor (Wordpad, notepad++, gedit, etc...

- add the line at the end (if not already done) : Application = {"ryzom_dev", "./client_ryzom_r.exe", "./"};

- save client.cfg

- return back to Ryzom Installer window

- click on OK

- select your profile and click on Play, it should patch

Ryzom Installer Manual

2018-11-22T19:49:27Z

Riasan:

{{Migrated to|:en:Ryzom Installer Manual}}
{{TabLang|EN|DE|Ryzom_Installer_Manual|ES|Manuel de l'Installeur Ryzom|RU}}

{{toTrad|DE}}
{{toTrad|EN|To check the quality of the text itself}}
{{toTrad|ES}}
{{toTrad|RU}}

{{TPInWikiRyzom}}
[[Category:EN]]
[[Category:Tutorials]]

==What is Ryzom Installer?==

"Ryzom Installer" is a new tool to handle the migration from 2.1 to 3.0. It has been created because 2.1 client doesn't support all platforms (it only supports Windows 32 bits) and it is installed in a "wrong" location (a MMORPG shouldn't be installed in C:\Program Files because this directory is not writable by a normal user and requires Administrator permissions).

It’s called "Installer" because it can be used to install Ryzom from scratch and download required data.

==How does Ryzom Installer works?==

The first time a player on version 2.1 client launches the game, it’s the Installer that launches instead of client. It detects it must migrate current data and copies them to a new location (where user can write). After the migration, it displays a simple dialog with the choice of a "profile" (a default one is created during migration) and allows to click on Play or Configure.

Once everything is done, the player is able to launch Ryzom as usual clicking on an icon or using the Installer.

*'''Q: How much time the migration takes?'''

**A: Only the time needed to copy the files.

*'''Q: Some are still having an older client than 2.1, like 2.0 on Mac or even older ones. Are any of these supported here as well?'''

**A: It patches only Windows client because no other client is using official patch system. Windows 2.0 clients patch to 3.0 using Installer. If patch is working, it patches, even with 1.x clients. It won't change anything. For Linux and OS X players, they’ll have to download the Installer. In all cases, all players who are using beta clients are migrating automatically, without the need of the Installer.

==Configuration file used or created by Ryzom Installer==

Each user choice is saved in a configuration file named ryzom_installer.ini. You can open https://bitbucket.org/ryzom/ryzomcore/src/05465687c514be172eadb4d39d670714219d4558/code/ryzom/tools/client/ryzom_installer/res/ryzom_installer.ini?at=compatibility-develop&fileviewer=file-view-default with your browser to see its default content. This file is integrated into Ryzom Installer binary and is copied in C:\Users\<your name>\AppData\Local\Ryzom even if you chose a different location during migration.

After the default profile is created (at the end of the migration), its content should be like that :

version=3

[common]
language=fr
source_directory=
installation_directory=C:/Users/Kervala/AppData/Local/Ryzom
use_64bits_client=true
should_uninstall_old_client=true
installer_filename_windows=ryzom_installer_qt_r.exe
installer_filename_osx=RyzomInstaller.app/Contents/MacOS/RyzomInstaller
installer_filename_linux=ryzom_installer_qt

[product]
name=Ryzom
publisher="Winch Gate Property Limited"
url_about=http://ryzom.com/?lang=$LANG
url_help=http://app.ryzom.com/app_forum/index.php?page=topic/view/22047/1&post149889=$LANG#1
comments=Science-fantasy MMORPG

[servers]
size=1

[server_0]
id=ryzom_live
name=Atys
display_url="http://app.ryzom.com/app_releasenotes/index.php?lang=$LANG"
files_list_url="https://sourceforge.net/projects/ryzom/rss?path=/installer"
data_download_url="http://downloads.sourceforge.net/project/ryzom/installer/ryzom_live_data.7z?r=&ts=$TIMESTAMP"
data_download_filename=ryzom_live_data.7z
data_compressed_size=1500000000
data_uncompressed_size=7000000000
client_download_url="http://downloads.sourceforge.net/project/ryzom/installer/ryzom_live_client_$ARCH.7z?r=&ts=$TIMESTAMP"
client_download_filename=ryzom_live_client_$ARCH.7z
client_filename_windows=ryzom_client_r.exe
client_filename_osx=Ryzom.app/Contents/MacOS/Ryzom
client_filename_linux=ryzom_client
client_filename_old_windows=client_ryzom_rd.exe
configuration_filename_windows=ryzom_configuration_qt_r.exe
configuration_filename_osx=Ryzom.app/Contents/MacOS/RyzomConfiguration
configuration_filename_linux=ryzom_configuration_qt
comments=

[profiles]
size=1
default=0

[profile_0]
id=0
name=Ryzom (Atys)
server=ryzom_live
executable=
arguments=
comments=Default profile created by Ryzom Installer
desktop_shortcut=true
menu_shortcut=true

* [product] section contains details on Ryzom that will be used in "App/Remove programs" and other locations.
* [server_X] sections include files required by a server, files to copy, space required, etc... :) for the moment, only ryzom_live (= Atys) is supported.
* [profiles] are saved in different sections [profile_X] with a number.

*'''Q: In edit profile window we still can put in login details in arguments to automatically log in? same like in a shortcut?'''

**A: Indeed. And it'll update shortcuts if they are checked. if you have several accounts, it'll be useful. You can even choose another client and it'll display its version. It can be useful if you want to use a DEV client for example.

**Ryzom Installer allows to edit this file easily, but that's always good to understand where are stored users data and their content:
***Patched files (client, data, etc...) are located in the directory you chose during migration or, by default, C:\Users\<your name>\AppData\Local\Ryzom\ryzom_live (where ryzom_live is the ID of the server).
***Users files (client.cfg, client.log, user, save, screenshots, music, etc...) are located in C:\Users\<your name>\AppData\Roaming\Ryzom\<profile id>

*'''Q:Can we choose to install them elsewhere?'''

**A:Yes. We can put where we want the client data. The location that can be changed is the one to C:\Users\<your name>\AppData\Local\Ryzom, C:\Users\<your name>\AppData\Roaming\Ryzom\<profile id> can't be changed. Perhaps later... Under Windows, “Local“ is big data specific to current machine, “Roaming” is user data that must be copied on each machine user is connected (it makes sense in the case on a Windows network using a domain).

*'''Q: What is the goal of this structure?'''

**A: Being able to have several data files for each server (Atys, Yubo, Kaghanat, Tempest in the Aether, etc) and several clients/accounts. So if you have 4 accounts on Atys, you'll have one server (ryzom_live) and 4 profiles (0, 1, 2, 3) with different client.cfg and distinct user files. And you'll be able to play simultaneously without having 4 copies of whole data. The locations of files and ryzom_installer.ini will be different on each platform.

*'''Q: Why isn't it stored in the same directory the game is?'''

**A: Because we need to centralize the configuration file else Ryzom Installer won't find it if we launch it from elsewhere.

*'''Q: How can I find the folder where my screenshots, client.fg or client.log are located?'''

**A: C:\Users\<your name>\AppData\Roaming\Ryzom\<profile id> where 'AppData' is usually a hidden folder. There are at least 3 ways to open the folder and to go ahead to your location:

***Open the Ryzom Installer, go to Settings -> Profile, choose your Profile on the left, click on 'Open' next to 'Directory' on the right side.

***Go to Windows Explorer and type in the address bar %AppData% and press enter.

***Go to Windows Explorer, open your C:\ drive, click on 'Organize', select 'Folder and Search' option, Select 'View' tab in the new window. Under 'Files and Folders' -> 'Hidden files and folders', select the option to 'Show hidden files, folders and drives'. Click on 'OK' and from now on you always can find and open AppData directory.

**For Windows XP the location is: C:\Documents and Settings\yourname\Application Data\Ryzom\0

==Advices==

*Never uncompress the downloaded 7z files manually.
*Both ryzom_live_data.7z and ryzom_live_client_win32.7z (or ryzom_live_client_win64.7z) must be let untouched.
*Never launch ryzom_client_patcher.exe yourself.

==Linux version of Ryzom Installer==

Linux version of Ryzom Installer is available on http://ryzom.com (just click on Linux logo to download it).

You get a ryzom_installer_linux.tar.bz2 to uncompress, it'll create a ryzom_installer_linux directory with 32 and 64 bits versions of Installer and a ryzom_installer_linux.sh script that'll launch the right Installer depending on your platform.

Choose where you want to install Ryzom data and client (by default in ~/.local/share/Ryzom), wait until it downloaded and uncompress all files.

If you want to use your interfaces, configurations, etc... you just need to copy them to ~/.local/share/Ryzom/0

If you have error 307 or error 0 message, just download :
*https://sourceforge.net/projects/ryzom/files/installer/ryzom_live_data.7z/download
*https://sourceforge.net/projects/ryzom/files/installer/ryzom_live_client_linux32.7z/download
*https://sourceforge.net/projects/ryzom/files/installer/ryzom_live_client_linux64.7z/download

You should have "Ryzom Installer" and "Ryzom (Atys)" entries in your applications menu.

If Ryzom doesn't want to start, you may need to install OpenAL on your distribution (you can check that by trying to launch it using command-line).

To start Ryzom (and use your first profile) from command-line, you can use : ~/.local/share/Ryzom/ryzom_live/ryzom_client -p 0

==How to remove the installer and files?==

Go in "Add/Remove programs, it should launch Installer in Uninstaller mode and allow to check components you want to uninstall.

If something went wrong, you may need to check these locations :

*Under Windows XP :
*C:\Documents and Settings\<user name>\Local Settings\Application Data\Ryzom
**C:\Documents and Settings\<user name>\Application Data\Ryzom

*Under Windows Vista and up :
**C:\Users\<user name>\AppData\Local\Ryzom
**C:\Users\<user name>\AppData\Roaming\Ryzom

==Different problems and their solutions==

===What to check and to ask when a player has a problem===

*a screenshot of the error
*what is their platform : Windows, Linux, OS X, 32 or 64 bits
*screenshot of C:\Program Files (x86)\Ryzom
*screenshot of C:\Users\<login>\AppData\Local\Ryzom
*screenshot of C:\Users\<login>\AppData\Local\Ryzom\ryzom_live
*(screenshot of another directory if they didn’t install Ryzom Installer in default directories)
*copy-paste of C:\Users\<login>\AppData\Local\Ryzom\ryzom_installer.ini
*copy-paste of C:\Users\<login>\AppData\Roaming\Ryzom\0\client.log
*copy-paste of C:\Users\<login>\AppData\Roaming\Ryzom\0\client.cfg
*screenshot of C:\Users\<login>\AppData\Roaming\Ryzom\0\user content
*(if they used a profile different of 0, replace the 0 by the right profile ID before)

===Ryzom Installer can't run and displays an error message box===

Ryzom Installer, after installing it, is using 32 bits DLLs in C:\Users\<login>\AppData\Local\Ryzom and Ryzom Installer from C:\Users\<login>\AppData\Local\Ryzom\ryzom_live should be in 64 bits if you chose a 64 bits client. After a patch, client is copying Ryzom Installer from C:\Users\<login>\AppData\Local\Ryzom\ryzom_live to C:\Users\<login>\AppData\Local\Ryzom and then DLLs in C:\Users\<login>\AppData\Local\Ryzom could be incompatible with the copied Ryzom Installer :( The temporary fix is to copy both msvcp100.dll, msvcr100.dll and ryzom_installer_qt_r.exe from C:\Users\<login>\AppData\Local\Ryzom\ryzom_live to C:\Users\<login>\AppData\Local\Ryzom. This will be fixed in next patch.

===Ryzom Installer seems blocked/stalled===

If Ryzom Installer seems blocked/stalled, it can be because there was a previously version of Ryzom Installer that wasn’t properly uninstalled or if player moved directories and configuration file became invalid. In this case, it’s possible to uninstall it completely by removing whole content of C:\Users\<login>\AppData\Local\Ryzom and C:\Users\<login>\AppData\Roaming\Ryzom but please be sure that player hasn’t files he would like to keep before doing that. In that case, always make a backup.

===Not enough disk space===

If players have not enough disk space, it should notify them and they'll have to chose another location.

===Error 6===

It means than the downloaded 7z file was incomplete and Ryzom Installer couldn't uncompress it. The best fix is to find the file in C:\Users\<login>\AppData\Local\Ryzom and to change its extension from .7z to .7z.part (just adding a .part). If you restart Ryzom Installer, it should try to resume the file. If it takes too long, you can download it manually (see error 307) and move it to C:\Users\<login>\AppData\Local\Ryzom.

===Error 126 on a ATI/AMD card===

If a player with an ATI/AMD card has an error 126 when launching Ryzom or Configuration (it should only display the splash screen and then the error in a dialog), you need to go to C:\Windows\System32 and copy atio6axx.dll to atiogl64.dll After this change, Ryzom should launch :)

===Error 307 & Error 0 & "File is larger than expected"===

It’s a problem with Sourceforge.

First you need to close Ryzom Installer.

To fix that you can manually download the required files :
*Data : https://sourceforge.net/projects/ryzom/files/installer/ryzom_live_data.7z/download
*Windows 64 bits client : https://sourceforge.net/projects/ryzom/files/installer/ryzom_live_client_win64.7z/download
*Windows 32 bits client : https://sourceforge.net/projects/ryzom/files/installer/ryzom_live_client_win32.7z/download
*Linux 64 bits client : https://sourceforge.net/projects/ryzom/files/installer/ryzom_live_client_linux64.7z/download
*Linux 32 bits client : https://sourceforge.net/projects/ryzom/files/installer/ryzom_live_client_linux32.7z/download
*OS X client : https://sourceforge.net/projects/ryzom/files/installer/ryzom_live_client_osx.7z/download

Data are always required and you need to download the right client.

Then you move all these 7z files in :
*Windows : C:\Users\<login>\AppData\Local\Ryzom
*Linux : HOME/.local/share/Ryzom
*OS X: HOME/Library/Application Support/Ryzom

And relaunch Ryzom Installer, it should detect files and uncompress them.

===Direct3D driver / OpenGL===

If player used a Direct3D driver with 2.1 client and since client.cfg will be copied, it’ll continue to use D3D. Now that OpenGL is recommended driver for all cards, players could need to switch to it manually clicking on Configure button in Ryzom Installer and select OpenGL (or Auto) instead of Direct3D. If not, he could have texture issues.

===White or black textures===

The default quality has been improved in v3 clients. By the way, v3 clients use 128 Mo of video memory against 32 Mo for v2's ones.

The textures are sent to the graphic card's memory. If you see them in white or black, it's probably because your graphic card has not got enough memory to stock them.
Moreover, if your graphic card does not support the compressed textures, Ryzom detects it and unzips them before to send them.

So in case of white or black graphic issue, please reduce the graphic qualities in Configuration and deactive FXAA (lower graphic quality and no effects), it should help to fix the problem.
If it does not work, try to switch from OpenGL to Direct3D. It could fix the texture issue... but you'll see the trees moving, trunk included (know bug: https://bitbucket.org/ryzom/ryzomcore/issues/160/wind-tree-vp-not-working-correcly-under ).

===point_except_handler4_common could not be located in the dynamic link library msvcrt.dll===

Error is The procedure entry point_except_handler4_common could not be located in the dynamic link library msvcrt.dll, to fix it you need to :
*Browse to C:\Windows\System32 folder and find file '''dwmapi.dll'''
*Rename this file from '''dwmapi.dll''' to '''dwmapi.dll_old'''

===Player can't start client because of a wrong DLL===

*Edit C:\Users\<login>\AppData\Local\Ryzom\ryzom_installer.ini, remove the directory after '''source_directory=''' to be sure, it won't copy again from old client
*Remove completely all DLLs and EXEs in C:\Users\<login>\AppData\Local\Ryzom\ryzom_live
*Download the right client on SourceForge (see Error 307)
*Put it to C:\Users\<login>\AppData\Local\Ryzom (don't uncompress it!)
*Restart Ryzom Installer
*It should uncompress the new client and you should be able to patch and play after that

===Error missing DDL===

*If you get by start of Installer the Error Box with msvcp120.dll or msvcr120.dll are missing pleas download and install the "Visual C++ Redistributable Packages for Visual Studio 2013"
*Visual C++ Redistributable Packages for Visual Studio 2013 : https://www.microsoft.com/en-us/download/details.aspx?id=40784

===Case of manually move of "ryzom_live" folder===

If player manually moves "ryzom_live" folder or another one, Ryzom Installer won't detect it and player will have to edit his ryzom_installer.ini

===German players with an English Windows environment===

If German player has an English Windows environment than Ryzom will start in English too, even when the user has chosen a German installation (this only chose the language for the installation process, not the language for the game itself)

===Location of default files under all platforms===

*Windows Vista and up :
**C:\Users\<login>\AppData\Local\Ryzom
**C:\Users\<login>\AppData\Roaming\Ryzom
*Windows XP :
**C:\Documents and Settings\<login>\Local Settings\Application Data\Ryzom
**C:\Documents and Settings\<login>\Application Data\Ryzom
*Linux :
**HOME/.local/share/Ryzom (both profiles (0, 1, 2, etc…) and servers (ryzom_live, ryzom_dev, etc…) are in the same directory)
*OS X :
**HOME/Library/Application Support/Ryzom (both profiles (0, 1, 2, etc…) and servers (ryzom_live, ryzom_dev, etc…) are in the same directory)
**HOME/Library/Containers/com.winchgate.Ryzom/Data/Library/Application Support/Ryzom for AppStore version

===What to do if I do not find a solution to my problem in this list?===

Please come on #ryzom on IRC Freenode (direct link: http://webchat.freenode.net/?channels=ryzom and someone will help you in direct!

===No sound when using OpenAL driver===

Be sure to have installed https://www.openal.org/downloads/oalinst.zip (under Windows) or OpenAL package for your distribution (libopenal1 under Debian-based ones). OpenAL is always installed under OS X.

===Unable to install OS X version of Ryzom Installer===

* Open '''System Preferences'''
* Open the '''Security & Privacy''' pane
* Select the '''General''' tab
* Click on '''Open anyway''' next to '''Ryzom Installer''' and it'll open '''Ryzom Installer''' package

===If there are any bug with Ryzom Installer===

In all cases, if you found a bug with '''Ryzom Installer''', you can download and install latest versions from http://ryzom.com and try it. They'll be updated regularly.

===My download is very slow===

You can close '''Ryzom Installer''', Sourceforge should redirect to a best mirror and your download will resume.

===Crash after teleporting===

It could be related to '''XAudio2''' driver under Windows. You can switch to '''FMod''' driver and check if it's better, to do that simply add to your client.cfg :

DriverSound = "FMod";

===Ryzom Installer is always copying old data===

You should need to uninstall Ryzom Installer and reinstall it or edit ryzom_installer.ini and remove directory on line '''source_directory='''

===No OpenGL driver for ATI Radeon HD 4500 series===

Download legacy drivers on : http://support.amd.com/fr-fr/download/desktop/legacy?product=legacy2&os=Windows%207%20-%2064

If this case occurs, you should see in client.log :

2016/10/25 03:31:16 INF 2d0 ryzom_client_r.exe driver_opengl_extension.cpp 1589 NL3D::registerGlExtensions : 3D: OpenGL 1.1.0 / Microsoft Corporation / GDI Generic

===Crash before character selection and after login===

If player has '''nel_report_*.log''' with content :

A failed assertion occurs
ProcName: ryzom_client_r.exe
Date: 2016/10/30 11:14:29
File: Z:/home/nevrax/ryzomcore/code/nel/include\nel/misc/singleton.h
Line: 155
FuncName: NLMISC::CManualSingleton<class NLSOUND::CListenerFMod>::getInstance
Reason: "_instance() != NULL"
-------------------------------

No log
-------------------------------

And last lines in client.log :

2016/10/30 12:59:27 INF 5e8 ryzom_client_r.exe common.cpp 682 NLMISC::Exception::Exception : Exception will be launched: Failed to create the FMod driver object
2016/10/30 12:59:27 WRN 5e8 ryzom_client_r.exe audio_mixer_user.cpp 479 NLSOUND::CAudioMixerUser::initDevice : Failed to create the FMod driver object

Then player system don't succeed to load FMod driver :( I suggest to switch back to XAudio2 driver by adding to their '''client.cfg''' :

DriverSound = "XAudio2";

===Player launched Ryzom, don't see any window on the screen but the icon is present in task bar===

Coordinates of Ryzom window are outside the screen, to fix that :

* launch Ryzom Configuration by clicking on Configure
* in Display section you can check values for '''Position X''' and '''Position Y''' and correct them
* click on '''Apply'''

===Player receives "Empty answer from server (error code 62)"===

If this error message occurs, it means that Ryzom didn't receive any response from server. In most of cases, it's related to a connection problem. If you have an anti-virus and/or a firewall you could try to disable them (at least to check if it works).

You can also try to display URL : http://shard.ryzom.com:40916/login/r2_login.php?cmd=ask

If it displays an error message or a blank page, you found the problem (that's your connection), if it displays the correct message : '''0:Invalid account: (2001) (in askSalt)''' it's something else.

===Client crashed with Access Violation exception generated at 0xXXXX, thread attempts to read at 0xXXXXX===

It's a standard crash, you need to gather more details depending on the moment where it crashed.

* If before displaying login screen : corrupted data, bad 3D driver, etc...
* If after login screen but before character selection : bad sound driver, corrupted data, etc...
* If after character selection/creation : FXAA (you need to disable 3D effects), corrupted data, etc...

===Unable to install Ryzom Installer under OS X===

With old OS X versions, you can get an error message when installing Ryzom Installer, to workaround that you can directly download a ZIP file containing Ryzom Installer on:
http://devl1.ryzom.com/RyzomInstaller.zip

=== Error codes from Ryzom Installer ===

These errors are from Qt, you can find them on : http://doc.qt.io/qt-5/qabstractsocket.html#SocketError-enum

==Installation of server test Yubo (v3)==

'''WARNING: you can only access Yubo shard if you have got a specific account with yubo access.'''

To add Yubo with Ryzom Installer, just follow these steps :

-close Ryzom Installer if it is launched

-show your hidden folders

-WINDOWS: go to C:\Users\<login>\AppData\Local\Ryzom - or type %appdata% in explorers' addressbar and go back one time to find local folder

-MAC: go to ~/Library/Application Support/Ryzom

-LINUX: go to ~/.local/share/Ryzom under Linux or the other folder where you installed Ryzom

-copy ryzom_live folder to ryzom_dev

-open ryzom_installer.ini with a text editor (Wordpad, notepad++, gedit, etc...)

(to find it:
WINDOWS -> C:\Users\<login>\AppData\Local\Ryzom - or type %appdata% in explorers' addressbar and go back one time to find local folder
MAC -> find the ryzom_installer.ini in /Users/<Your UserID>/Library/Application Support/Ryzom

- delete all parts beginning by [servers] and [server_0] and put :

[servers]
size=2

[server_0]
id=ryzom_live
name=Atys
display_url="http://app.ryzom.com/app_releasenotes/index.php?lang=$LANG"
files_list_url="https://sourceforge.net/projects/ryzom/rss?path=/installer"
data_download_url="http://downloads.sourceforge.net/project/ryzom/installer/ryzom_live_data.7z?r=&ts=$TIMESTAMP"
data_download_filename=ryzom_live_data.7z
data_compressed_size=1500000000
data_uncompressed_size=7000000000
client_download_url="http://downloads.sourceforge.net/project/ryzom/installer/ryzom_live_client_$ARCH.7z?r=&ts=$TIMESTAMP"
client_download_filename=ryzom_live_client_$ARCH.7z
client_filename_windows=ryzom_client_r.exe
client_filename_osx=Ryzom.app/Contents/MacOS/Ryzom
client_filename_linux=ryzom_client
client_filename_old_windows=client_ryzom_rd.exe
configuration_filename_windows=ryzom_configuration_qt_r.exe
configuration_filename_osx=Ryzom.app/Contents/MacOS/RyzomConfiguration
configuration_filename_linux=ryzom_configuration_qt
comments=

[server_1]
id=ryzom_dev
name=Yubo
display_url="http://app.ryzom.com/app_releasenotes/index.php?lang=$LANG"
files_list_url="https://sourceforge.net/projects/ryzom/rss?path=/installer"
data_download_url="http://downloads.sourceforge.net/project/ryzom/installer/ryzom_live_data.7z?r=&ts=$TIMESTAMP"
data_download_filename=ryzom_live_data.7z
data_compressed_size=1500000000
data_uncompressed_size=7000000000
client_download_url="http://downloads.sourceforge.net/project/ryzom/installer/ryzom_live_client_$ARCH.7z?r=&ts=$TIMESTAMP"
client_download_filename=ryzom_live_client_$ARCH.7z
client_filename_windows=ryzom_client_r.exe
client_filename_osx=Ryzom.app/Contents/MacOS/Ryzom
client_filename_linux=ryzom_client
client_filename_old_windows=client_ryzom_rd.exe
configuration_filename_windows=ryzom_configuration_qt_r.exe
configuration_filename_osx=Ryzom.app/Contents/MacOS/RyzomConfiguration
configuration_filename_linux=ryzom_configuration_qt
comments=Test server

- save the file

- WINDOWS: launch Ryzom Installer in Ryzom's main folder

- MAC: launch Ryzom Installer in /Applications

- LINUX: launch Ryzom Installer in Applications menus

- create new profiles in Settings -> Profiles, you should have Atys and Yubo as server choice now :)

- click on "Open" button to open profile folder

- open client.cfg with a text editor (Wordpad, notepad++, gedit, etc...

- add the line at the end (if not already done) : Application = {"ryzom_dev", "./client_ryzom_r.exe", "./"};

- save client.cfg

- return back to Ryzom Installer window

- click on OK

- select your profile and click on Play, it should patch

Building Ryzom Client On Mac OS X

2018-11-09T21:30:16Z

Riasan: /* Installing and configuring Xcode */

{{migrated to|:en:Building Ryzom Client On Mac OS X}}
{{tabLang|EN|Mac OS XDE|Building Ryzom Client under Mac OS X|Mac OS XES|Mac OS XFR|Mac OS XRU}}

{{ToTrad|DE}}
{{ToTrad|ES}}
{{ToTrad|FR}}
{{ToTrad|RU}}

== Installing and configuring Xcode ==

Last Xcode version can be downloaded from Mac AppStore or https://developer.apple.com/xcode/downloads/

To enable command-line tools under Xcode 5 or more recent versions, you'll need to open a terminal and type :

xcode-select --install

Ryzom client needs at least Mac OS X 10.8. If you plan to deploy Ryzom on Mac OS X versions older than your current one (but more recent than 10.8), I suggest you to set MACOSX_DEPLOYMENT_TARGET environment variable before compiling any dependencies :

export MACOSX_DEPLOYMENT_TARGET=10.8

And append that line to '''~/.bash_profile''' to be sure it'll be defined later.

== Installing and configuring MacPorts ==

To install all 3rd party libraries needed by Ryzom, you'll need to download and install MacPorts from : https://www.macports.org/install.php

First install tools that doesn't require support for older OS X versions :

sudo port install mercurial p7zip cmake

By default, it'll target your Mac OS X version. To change the target, type :

sudo nano /opt/local/etc/macports/macports.conf

And append at the end of the file :

macosx_deployment_target 10.8
cxx_stdlib libc++

Press CTRL+X / Apple+X to save and confirm.

Then open a terminal and type :

sudo port install curl freetype jpeg libxml2 lua zlib libpng libogg giflib
sudo port -s -v install boost libvorbis icu

Note : The '''-s''' option is used to force a rebuild from source (to take into account the new options added to macports.conf) else it'll use a precompiled package. ICU will be used if you need to compile a static version of Qt.

== Compiling Luabind ==

Open a terminal and write the following lines :

hg clone http://hg.kervala.net/luabind
hg clone http://hg.kervala.net/cmake

export CMAKE_MODULE_PATH=$(pwd)/cmake/modules

cd luabind
mkdir build
cd build
cmake -DWITH_STATIC=ON -DWITH_SHARED=OFF -DWITH_LUA53=ON -DWITH_LUA51=OFF ..
make
sudo make install
cd ../..

Luabind will be installed in /usr/local and should not conflict with MacPorts or system files.

== Downloading Ryzom code ==

For first time, please type :

hg clone -b compatibility-develop https://bitbucket.org/ryzom/ryzomcore

Later, to only update sources you will need to type :

hg pull && hg update

== Compiling Ryzom client ==

This section shows how to create a static Ryzom Core client built on Mac OS X. The resulting binary only depends on system libs, therefore can be moved easily to another Mac OS X machine. The given list of CMake options is just an example. For a complete list see: CMake Options. Building a Ryzom Core client that depends on NeL and Ryzom shared libraries is strongly discouraged.

cd ryzomcore
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release -DWITH_STATIC=ON -DWITH_STATIC_DRIVERS=ON \
-DWITH_NEL_TOOLS=OFF -DWITH_NEL_SAMPLES=OFF -DWITH_NEL_TESTS=OFF -DWITH_RYZOM_SERVER=OFF \
-DWITH_RYZOM_TOOLS=OFF -DWITH_STATIC_EXTERNAL=ON -DWITH_LUA53=ON -DWITH_LUA51=OFF -DWITH_RYZOM_PATCH=ON ../code
make

The resulting application bundle will be '''bin/Ryzom.app''' and you should copy data to : Ryzom.app/Contents/Resources/data.

The application '''Ryzom''' (Ryzom.app folder in fact) should do around 6 GB, you can launch it double-clicking on the icon.

Ryzom will patch itself when launched.

== Compilation errors or warnings ==

If you get errors like :
<pre>
error: target Objective-C runtime differs in PCH file vs. current file
error: PCH file was compiled for the target 'x86_64-apple-macosx10.11.0' but the
current translation unit is being compiled for target
'x86_64-apple-macosx10.8.0'
</pre>

You just need to delete compilation files with :

<pre>make clean</pre>

If you get warnings like :

<pre>ld: warning: object file (/opt/local/lib/libz.a(trees.o)) was built for newer OSX version (10.11) than being linked (10.7)</pre>

You need to recompile these libraries with :

<pre>sudo port upgrade -n -s --force zlib</pre>

(you can replace '''zlib''' with the real library)

{{In_Category|Mac}}
{{TPInWikiRyzom}}
[[Category:Tutorials]] [[Category:Support]] [[Category:Mac]] [[Category:EN]]

Building Ryzom Client On Mac OS X

2018-11-09T21:29:48Z

Riasan: /* Compilation errors or warnings */

{{migrated to|:en:Building Ryzom Client On Mac OS X}}
{{tabLang|EN|Mac OS XDE|Building Ryzom Client under Mac OS X|Mac OS XES|Mac OS XFR|Mac OS XRU}}

{{ToTrad|DE}}
{{ToTrad|ES}}
{{ToTrad|FR}}
{{ToTrad|RU}}

== Installing and configuring Xcode ==

Last Xcode version can be downloaded from Mac AppStore or https://developer.apple.com/xcode/downloads/

To enable command-line tools under Xcode 5 or more recent versions, you'll need to open a terminal and type :

xcode-select --install

Ryzom client needs at least Mac OS X 10.8. If you plan to deploy Ryzom on Mac OS X versions older than your current one (but more recent than 10.7), I suggest you to set MACOSX_DEPLOYMENT_TARGET environment variable before compiling any dependencies :

export MACOSX_DEPLOYMENT_TARGET=10.8

And append that line to '''~/.bash_profile''' to be sure it'll be defined later.

== Installing and configuring MacPorts ==

To install all 3rd party libraries needed by Ryzom, you'll need to download and install MacPorts from : https://www.macports.org/install.php

First install tools that doesn't require support for older OS X versions :

sudo port install mercurial p7zip cmake

By default, it'll target your Mac OS X version. To change the target, type :

sudo nano /opt/local/etc/macports/macports.conf

And append at the end of the file :

macosx_deployment_target 10.8
cxx_stdlib libc++

Press CTRL+X / Apple+X to save and confirm.

Then open a terminal and type :

sudo port install curl freetype jpeg libxml2 lua zlib libpng libogg giflib
sudo port -s -v install boost libvorbis icu

Note : The '''-s''' option is used to force a rebuild from source (to take into account the new options added to macports.conf) else it'll use a precompiled package. ICU will be used if you need to compile a static version of Qt.

== Compiling Luabind ==

Open a terminal and write the following lines :

hg clone http://hg.kervala.net/luabind
hg clone http://hg.kervala.net/cmake

export CMAKE_MODULE_PATH=$(pwd)/cmake/modules

cd luabind
mkdir build
cd build
cmake -DWITH_STATIC=ON -DWITH_SHARED=OFF -DWITH_LUA53=ON -DWITH_LUA51=OFF ..
make
sudo make install
cd ../..

Luabind will be installed in /usr/local and should not conflict with MacPorts or system files.

== Downloading Ryzom code ==

For first time, please type :

hg clone -b compatibility-develop https://bitbucket.org/ryzom/ryzomcore

Later, to only update sources you will need to type :

hg pull && hg update

== Compiling Ryzom client ==

This section shows how to create a static Ryzom Core client built on Mac OS X. The resulting binary only depends on system libs, therefore can be moved easily to another Mac OS X machine. The given list of CMake options is just an example. For a complete list see: CMake Options. Building a Ryzom Core client that depends on NeL and Ryzom shared libraries is strongly discouraged.

cd ryzomcore
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release -DWITH_STATIC=ON -DWITH_STATIC_DRIVERS=ON \
-DWITH_NEL_TOOLS=OFF -DWITH_NEL_SAMPLES=OFF -DWITH_NEL_TESTS=OFF -DWITH_RYZOM_SERVER=OFF \
-DWITH_RYZOM_TOOLS=OFF -DWITH_STATIC_EXTERNAL=ON -DWITH_LUA53=ON -DWITH_LUA51=OFF -DWITH_RYZOM_PATCH=ON ../code
make

The resulting application bundle will be '''bin/Ryzom.app''' and you should copy data to : Ryzom.app/Contents/Resources/data.

The application '''Ryzom''' (Ryzom.app folder in fact) should do around 6 GB, you can launch it double-clicking on the icon.

Ryzom will patch itself when launched.

== Compilation errors or warnings ==

If you get errors like :
<pre>
error: target Objective-C runtime differs in PCH file vs. current file
error: PCH file was compiled for the target 'x86_64-apple-macosx10.11.0' but the
current translation unit is being compiled for target
'x86_64-apple-macosx10.8.0'
</pre>

You just need to delete compilation files with :

<pre>make clean</pre>

If you get warnings like :

<pre>ld: warning: object file (/opt/local/lib/libz.a(trees.o)) was built for newer OSX version (10.11) than being linked (10.7)</pre>

You need to recompile these libraries with :

<pre>sudo port upgrade -n -s --force zlib</pre>

(you can replace '''zlib''' with the real library)

{{In_Category|Mac}}
{{TPInWikiRyzom}}
[[Category:Tutorials]] [[Category:Support]] [[Category:Mac]] [[Category:EN]]

Building Ryzom Client On Mac OS X

2018-11-09T21:29:12Z

Riasan: /* Compilation errors or warnings */

{{migrated to|:en:Building Ryzom Client On Mac OS X}}
{{tabLang|EN|Mac OS XDE|Building Ryzom Client under Mac OS X|Mac OS XES|Mac OS XFR|Mac OS XRU}}

{{ToTrad|DE}}
{{ToTrad|ES}}
{{ToTrad|FR}}
{{ToTrad|RU}}

== Installing and configuring Xcode ==

Last Xcode version can be downloaded from Mac AppStore or https://developer.apple.com/xcode/downloads/

To enable command-line tools under Xcode 5 or more recent versions, you'll need to open a terminal and type :

xcode-select --install

Ryzom client needs at least Mac OS X 10.8. If you plan to deploy Ryzom on Mac OS X versions older than your current one (but more recent than 10.7), I suggest you to set MACOSX_DEPLOYMENT_TARGET environment variable before compiling any dependencies :

export MACOSX_DEPLOYMENT_TARGET=10.8

And append that line to '''~/.bash_profile''' to be sure it'll be defined later.

== Installing and configuring MacPorts ==

To install all 3rd party libraries needed by Ryzom, you'll need to download and install MacPorts from : https://www.macports.org/install.php

First install tools that doesn't require support for older OS X versions :

sudo port install mercurial p7zip cmake

By default, it'll target your Mac OS X version. To change the target, type :

sudo nano /opt/local/etc/macports/macports.conf

And append at the end of the file :

macosx_deployment_target 10.8
cxx_stdlib libc++

Press CTRL+X / Apple+X to save and confirm.

Then open a terminal and type :

sudo port install curl freetype jpeg libxml2 lua zlib libpng libogg giflib
sudo port -s -v install boost libvorbis icu

Note : The '''-s''' option is used to force a rebuild from source (to take into account the new options added to macports.conf) else it'll use a precompiled package. ICU will be used if you need to compile a static version of Qt.

== Compiling Luabind ==

Open a terminal and write the following lines :

hg clone http://hg.kervala.net/luabind
hg clone http://hg.kervala.net/cmake

export CMAKE_MODULE_PATH=$(pwd)/cmake/modules

cd luabind
mkdir build
cd build
cmake -DWITH_STATIC=ON -DWITH_SHARED=OFF -DWITH_LUA53=ON -DWITH_LUA51=OFF ..
make
sudo make install
cd ../..

Luabind will be installed in /usr/local and should not conflict with MacPorts or system files.

== Downloading Ryzom code ==

For first time, please type :

hg clone -b compatibility-develop https://bitbucket.org/ryzom/ryzomcore

Later, to only update sources you will need to type :

hg pull && hg update

== Compiling Ryzom client ==

This section shows how to create a static Ryzom Core client built on Mac OS X. The resulting binary only depends on system libs, therefore can be moved easily to another Mac OS X machine. The given list of CMake options is just an example. For a complete list see: CMake Options. Building a Ryzom Core client that depends on NeL and Ryzom shared libraries is strongly discouraged.

cd ryzomcore
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release -DWITH_STATIC=ON -DWITH_STATIC_DRIVERS=ON \
-DWITH_NEL_TOOLS=OFF -DWITH_NEL_SAMPLES=OFF -DWITH_NEL_TESTS=OFF -DWITH_RYZOM_SERVER=OFF \
-DWITH_RYZOM_TOOLS=OFF -DWITH_STATIC_EXTERNAL=ON -DWITH_LUA53=ON -DWITH_LUA51=OFF -DWITH_RYZOM_PATCH=ON ../code
make

The resulting application bundle will be '''bin/Ryzom.app''' and you should copy data to : Ryzom.app/Contents/Resources/data.

The application '''Ryzom''' (Ryzom.app folder in fact) should do around 6 GB, you can launch it double-clicking on the icon.

Ryzom will patch itself when launched.

== Compilation errors or warnings ==

If you get errors like :
<pre>
error: target Objective-C runtime differs in PCH file vs. current file
error: PCH file was compiled for the target 'x86_64-apple-macosx10.11.0' but the
current translation unit is being compiled for target
'x86_64-apple-macosx10.8.0'
</pre>

You just need to delete compilation files with :

<pre>make clean</pre>

If you get warnings like :

<pre>ld: warning: object file (/opt/local/lib/libz.a(trees.o)) was built for newer OSX version (10.11) than being linked (10.8)</pre>

You need to recompile these libraries with :

<pre>sudo port upgrade -n -s --force zlib</pre>

(you can replace '''zlib''' with the real library)

{{In_Category|Mac}}
{{TPInWikiRyzom}}
[[Category:Tutorials]] [[Category:Support]] [[Category:Mac]] [[Category:EN]]

Building Ryzom Client On Mac OS X

2018-11-09T21:28:47Z

Riasan: /* Installing and configuring Xcode */

{{migrated to|:en:Building Ryzom Client On Mac OS X}}
{{tabLang|EN|Mac OS XDE|Building Ryzom Client under Mac OS X|Mac OS XES|Mac OS XFR|Mac OS XRU}}

{{ToTrad|DE}}
{{ToTrad|ES}}
{{ToTrad|FR}}
{{ToTrad|RU}}

== Installing and configuring Xcode ==

Last Xcode version can be downloaded from Mac AppStore or https://developer.apple.com/xcode/downloads/

To enable command-line tools under Xcode 5 or more recent versions, you'll need to open a terminal and type :

xcode-select --install

Ryzom client needs at least Mac OS X 10.8. If you plan to deploy Ryzom on Mac OS X versions older than your current one (but more recent than 10.7), I suggest you to set MACOSX_DEPLOYMENT_TARGET environment variable before compiling any dependencies :

export MACOSX_DEPLOYMENT_TARGET=10.8

And append that line to '''~/.bash_profile''' to be sure it'll be defined later.

== Installing and configuring MacPorts ==

To install all 3rd party libraries needed by Ryzom, you'll need to download and install MacPorts from : https://www.macports.org/install.php

First install tools that doesn't require support for older OS X versions :

sudo port install mercurial p7zip cmake

By default, it'll target your Mac OS X version. To change the target, type :

sudo nano /opt/local/etc/macports/macports.conf

And append at the end of the file :

macosx_deployment_target 10.8
cxx_stdlib libc++

Press CTRL+X / Apple+X to save and confirm.

Then open a terminal and type :

sudo port install curl freetype jpeg libxml2 lua zlib libpng libogg giflib
sudo port -s -v install boost libvorbis icu

Note : The '''-s''' option is used to force a rebuild from source (to take into account the new options added to macports.conf) else it'll use a precompiled package. ICU will be used if you need to compile a static version of Qt.

== Compiling Luabind ==

Open a terminal and write the following lines :

hg clone http://hg.kervala.net/luabind
hg clone http://hg.kervala.net/cmake

export CMAKE_MODULE_PATH=$(pwd)/cmake/modules

cd luabind
mkdir build
cd build
cmake -DWITH_STATIC=ON -DWITH_SHARED=OFF -DWITH_LUA53=ON -DWITH_LUA51=OFF ..
make
sudo make install
cd ../..

Luabind will be installed in /usr/local and should not conflict with MacPorts or system files.

== Downloading Ryzom code ==

For first time, please type :

hg clone -b compatibility-develop https://bitbucket.org/ryzom/ryzomcore

Later, to only update sources you will need to type :

hg pull && hg update

== Compiling Ryzom client ==

This section shows how to create a static Ryzom Core client built on Mac OS X. The resulting binary only depends on system libs, therefore can be moved easily to another Mac OS X machine. The given list of CMake options is just an example. For a complete list see: CMake Options. Building a Ryzom Core client that depends on NeL and Ryzom shared libraries is strongly discouraged.

cd ryzomcore
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release -DWITH_STATIC=ON -DWITH_STATIC_DRIVERS=ON \
-DWITH_NEL_TOOLS=OFF -DWITH_NEL_SAMPLES=OFF -DWITH_NEL_TESTS=OFF -DWITH_RYZOM_SERVER=OFF \
-DWITH_RYZOM_TOOLS=OFF -DWITH_STATIC_EXTERNAL=ON -DWITH_LUA53=ON -DWITH_LUA51=OFF -DWITH_RYZOM_PATCH=ON ../code
make

The resulting application bundle will be '''bin/Ryzom.app''' and you should copy data to : Ryzom.app/Contents/Resources/data.

The application '''Ryzom''' (Ryzom.app folder in fact) should do around 6 GB, you can launch it double-clicking on the icon.

Ryzom will patch itself when launched.

== Compilation errors or warnings ==

If you get errors like :
<pre>
error: target Objective-C runtime differs in PCH file vs. current file
error: PCH file was compiled for the target 'x86_64-apple-macosx10.11.0' but the
current translation unit is being compiled for target
'x86_64-apple-macosx10.7.0'
</pre>

You just need to delete compilation files with :

<pre>make clean</pre>

If you get warnings like :

<pre>ld: warning: object file (/opt/local/lib/libz.a(trees.o)) was built for newer OSX version (10.11) than being linked (10.7)</pre>

You need to recompile these libraries with :

<pre>sudo port upgrade -n -s --force zlib</pre>

(you can replace '''zlib''' with the real library)

{{In_Category|Mac}}
{{TPInWikiRyzom}}
[[Category:Tutorials]] [[Category:Support]] [[Category:Mac]] [[Category:EN]]

Building Ryzom Client On Mac OS X

2018-11-09T21:28:32Z

Riasan: /* Installing and configuring MacPorts */

{{migrated to|:en:Building Ryzom Client On Mac OS X}}
{{tabLang|EN|Mac OS XDE|Building Ryzom Client under Mac OS X|Mac OS XES|Mac OS XFR|Mac OS XRU}}

{{ToTrad|DE}}
{{ToTrad|ES}}
{{ToTrad|FR}}
{{ToTrad|RU}}

== Installing and configuring Xcode ==

Last Xcode version can be downloaded from Mac AppStore or https://developer.apple.com/xcode/downloads/

To enable command-line tools under Xcode 5 or more recent versions, you'll need to open a terminal and type :

xcode-select --install

Ryzom client needs at least Mac OS X 10.7. If you plan to deploy Ryzom on Mac OS X versions older than your current one (but more recent than 10.7), I suggest you to set MACOSX_DEPLOYMENT_TARGET environment variable before compiling any dependencies :

export MACOSX_DEPLOYMENT_TARGET=10.7

And append that line to '''~/.bash_profile''' to be sure it'll be defined later.

== Installing and configuring MacPorts ==

To install all 3rd party libraries needed by Ryzom, you'll need to download and install MacPorts from : https://www.macports.org/install.php

First install tools that doesn't require support for older OS X versions :

sudo port install mercurial p7zip cmake

By default, it'll target your Mac OS X version. To change the target, type :

sudo nano /opt/local/etc/macports/macports.conf

And append at the end of the file :

macosx_deployment_target 10.8
cxx_stdlib libc++

Press CTRL+X / Apple+X to save and confirm.

Then open a terminal and type :

sudo port install curl freetype jpeg libxml2 lua zlib libpng libogg giflib
sudo port -s -v install boost libvorbis icu

Note : The '''-s''' option is used to force a rebuild from source (to take into account the new options added to macports.conf) else it'll use a precompiled package. ICU will be used if you need to compile a static version of Qt.

== Compiling Luabind ==

Open a terminal and write the following lines :

hg clone http://hg.kervala.net/luabind
hg clone http://hg.kervala.net/cmake

export CMAKE_MODULE_PATH=$(pwd)/cmake/modules

cd luabind
mkdir build
cd build
cmake -DWITH_STATIC=ON -DWITH_SHARED=OFF -DWITH_LUA53=ON -DWITH_LUA51=OFF ..
make
sudo make install
cd ../..

Luabind will be installed in /usr/local and should not conflict with MacPorts or system files.

== Downloading Ryzom code ==

For first time, please type :

hg clone -b compatibility-develop https://bitbucket.org/ryzom/ryzomcore

Later, to only update sources you will need to type :

hg pull && hg update

== Compiling Ryzom client ==

This section shows how to create a static Ryzom Core client built on Mac OS X. The resulting binary only depends on system libs, therefore can be moved easily to another Mac OS X machine. The given list of CMake options is just an example. For a complete list see: CMake Options. Building a Ryzom Core client that depends on NeL and Ryzom shared libraries is strongly discouraged.

cd ryzomcore
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release -DWITH_STATIC=ON -DWITH_STATIC_DRIVERS=ON \
-DWITH_NEL_TOOLS=OFF -DWITH_NEL_SAMPLES=OFF -DWITH_NEL_TESTS=OFF -DWITH_RYZOM_SERVER=OFF \
-DWITH_RYZOM_TOOLS=OFF -DWITH_STATIC_EXTERNAL=ON -DWITH_LUA53=ON -DWITH_LUA51=OFF -DWITH_RYZOM_PATCH=ON ../code
make

The resulting application bundle will be '''bin/Ryzom.app''' and you should copy data to : Ryzom.app/Contents/Resources/data.

The application '''Ryzom''' (Ryzom.app folder in fact) should do around 6 GB, you can launch it double-clicking on the icon.

Ryzom will patch itself when launched.

== Compilation errors or warnings ==

If you get errors like :
<pre>
error: target Objective-C runtime differs in PCH file vs. current file
error: PCH file was compiled for the target 'x86_64-apple-macosx10.11.0' but the
current translation unit is being compiled for target
'x86_64-apple-macosx10.7.0'
</pre>

You just need to delete compilation files with :

<pre>make clean</pre>

If you get warnings like :

<pre>ld: warning: object file (/opt/local/lib/libz.a(trees.o)) was built for newer OSX version (10.11) than being linked (10.7)</pre>

You need to recompile these libraries with :

<pre>sudo port upgrade -n -s --force zlib</pre>

(you can replace '''zlib''' with the real library)

{{In_Category|Mac}}
{{TPInWikiRyzom}}
[[Category:Tutorials]] [[Category:Support]] [[Category:Mac]] [[Category:EN]]

Ryzom Installer Manual

2018-07-08T16:57:28Z

Riasan:

{{TabLang|EN|DE|Ryzom_Installer_Manual|ES|Manuel de l'Installeur Ryzom|RU}}

{{toTrad|DE}}
{{toTrad|EN|To check the quality of the text itself}}
{{toTrad|ES}}
{{toTrad|RU}}

{{TPInWikiRyzom}}
[[Category:EN]]
[[Category:Tutorials]]

==What is Ryzom Installer?==

"Ryzom Installer" is a new tool to handle the migration from 2.1 to 3.0. It has been created because 2.1 client doesn't support all platforms (it only supports Windows 32 bits) and it is installed in a "wrong" location (a MMORPG shouldn't be installed in C:\Program Files because this directory is not writable by a normal user and requires Administrator permissions).

It’s called "Installer" because it can be used to install Ryzom from scratch and download required data.

==How does Ryzom Installer works?==

The first time a player on version 2.1 client launches the game, it’s the Installer that launches instead of client. It detects it must migrate current data and copies them to a new location (where user can write). After the migration, it displays a simple dialog with the choice of a "profile" (a default one is created during migration) and allows to click on Play or Configure.

Once everything is done, the player is able to launch Ryzom as usual clicking on an icon or using the Installer.

*'''Q: How much time the migration takes?'''

**A: Only the time needed to copy the files.

*'''Q: Some are still having an older client than 2.1, like 2.0 on Mac or even older ones. Are any of these supported here as well?'''

**A: It patches only Windows client because no other client is using official patch system. Windows 2.0 clients patch to 3.0 using Installer. If patch is working, it patches, even with 1.x clients. It won't change anything. For Linux and OS X players, they’ll have to download the Installer. In all cases, all players who are using beta clients are migrating automatically, without the need of the Installer.

==Configuration file used or created by Ryzom Installer==

Each user choice is saved in a configuration file named ryzom_installer.ini. You can open https://bitbucket.org/ryzom/ryzomcore/src/05465687c514be172eadb4d39d670714219d4558/code/ryzom/tools/client/ryzom_installer/res/ryzom_installer.ini?at=compatibility-develop&fileviewer=file-view-default with your browser to see its default content. This file is integrated into Ryzom Installer binary and is copied in C:\Users\<your name>\AppData\Local\Ryzom even if you chose a different location during migration.

After the default profile is created (at the end of the migration), its content should be like that :

version=3

[common]
language=fr
source_directory=
installation_directory=C:/Users/Kervala/AppData/Local/Ryzom
use_64bits_client=true
should_uninstall_old_client=true
installer_filename_windows=ryzom_installer_qt_r.exe
installer_filename_osx=RyzomInstaller.app/Contents/MacOS/RyzomInstaller
installer_filename_linux=ryzom_installer_qt

[product]
name=Ryzom
publisher="Winch Gate Property Limited"
url_about=http://ryzom.com/?lang=$LANG
url_help=http://app.ryzom.com/app_forum/index.php?page=topic/view/22047/1&post149889=$LANG#1
comments=Science-fantasy MMORPG

[servers]
size=1

[server_0]
id=ryzom_live
name=Atys
display_url="http://app.ryzom.com/app_releasenotes/index.php?lang=$LANG"
files_list_url="https://sourceforge.net/projects/ryzom/rss?path=/installer"
data_download_url="http://downloads.sourceforge.net/project/ryzom/installer/ryzom_live_data.7z?r=&ts=$TIMESTAMP"
data_download_filename=ryzom_live_data.7z
data_compressed_size=1500000000
data_uncompressed_size=7000000000
client_download_url="http://downloads.sourceforge.net/project/ryzom/installer/ryzom_live_client_$ARCH.7z?r=&ts=$TIMESTAMP"
client_download_filename=ryzom_live_client_$ARCH.7z
client_filename_windows=ryzom_client_r.exe
client_filename_osx=Ryzom.app/Contents/MacOS/Ryzom
client_filename_linux=ryzom_client
client_filename_old_windows=client_ryzom_rd.exe
configuration_filename_windows=ryzom_configuration_qt_r.exe
configuration_filename_osx=Ryzom.app/Contents/MacOS/RyzomConfiguration
configuration_filename_linux=ryzom_configuration_qt
comments=

[profiles]
size=1
default=0

[profile_0]
id=0
name=Ryzom (Atys)
server=ryzom_live
executable=
arguments=
comments=Default profile created by Ryzom Installer
desktop_shortcut=true
menu_shortcut=true

* [product] section contains details on Ryzom that will be used in "App/Remove programs" and other locations.
* [server_X] sections include files required by a server, files to copy, space required, etc... :) for the moment, only ryzom_live (= Atys) is supported.
* [profiles] are saved in different sections [profile_X] with a number.

*'''Q: In edit profile window we still can put in login details in arguments to automatically log in? same like in a shortcut?'''

**A: Indeed. And it'll update shortcuts if they are checked. if you have several accounts, it'll be useful. You can even choose another client and it'll display its version. It can be useful if you want to use a DEV client for example.

**Ryzom Installer allows to edit this file easily, but that's always good to understand where are stored users data and their content:
***Patched files (client, data, etc...) are located in the directory you chose during migration or, by default, C:\Users\<your name>\AppData\Local\Ryzom\ryzom_live (where ryzom_live is the ID of the server).
***Users files (client.cfg, client.log, user, save, screenshots, music, etc...) are located in C:\Users\<your name>\AppData\Roaming\Ryzom\<profile id>

*'''Q:Can we choose to install them elsewhere?'''

**A:Yes. We can put where we want the client data. The location that can be changed is the one to C:\Users\<your name>\AppData\Local\Ryzom, C:\Users\<your name>\AppData\Roaming\Ryzom\<profile id> can't be changed. Perhaps later... Under Windows, “Local“ is big data specific to current machine, “Roaming” is user data that must be copied on each machine user is connected (it makes sense in the case on a Windows network using a domain).

*'''Q: What is the goal of this structure?'''

**A: Being able to have several data files for each server (Atys, Yubo, Kaghanat, Tempest in the Aether, etc) and several clients/accounts. So if you have 4 accounts on Atys, you'll have one server (ryzom_live) and 4 profiles (0, 1, 2, 3) with different client.cfg and distinct user files. And you'll be able to play simultaneously without having 4 copies of whole data. The locations of files and ryzom_installer.ini will be different on each platform.

*'''Q: Why isn't it stored in the same directory the game is?'''

**A: Because we need to centralize the configuration file else Ryzom Installer won't find it if we launch it from elsewhere.

*'''Q: How can I find the folder where my screenshots, client.fg or client.log are located?'''

**A: C:\Users\<your name>\AppData\Roaming\Ryzom\<profile id> where 'AppData' is usually a hidden folder. There are at least 3 ways to open the folder and to go ahead to your location:

***Open the Ryzom Installer, go to Settings -> Profile, choose your Profile on the left, click on 'Open' next to 'Directory' on the right side.

***Go to Windows Explorer and type in the address bar %AppData% and press enter.

***Go to Windows Explorer, open your C:\ drive, click on 'Organize', select 'Folder and Search' option, Select 'View' tab in the new window. Under 'Files and Folders' -> 'Hidden files and folders', select the option to 'Show hidden files, folders and drives'. Click on 'OK' and from now on you always can find and open AppData directory.

**For Windows XP the location is: C:\Documents and Settings\yourname\Application Data\Ryzom\0

==Advices==

*Never uncompress the downloaded 7z files manually.
*Both ryzom_live_data.7z and ryzom_live_client_win32.7z (or ryzom_live_client_win64.7z) must be let untouched.
*Never launch ryzom_client_patcher.exe yourself.

==Linux version of Ryzom Installer==

Linux version of Ryzom Installer is available on http://ryzom.com (just click on Linux logo to download it).

You get a ryzom_installer_linux.tar.bz2 to uncompress, it'll create a ryzom_installer_linux directory with 32 and 64 bits versions of Installer and a ryzom_installer_linux.sh script that'll launch the right Installer depending on your platform.

Choose where you want to install Ryzom data and client (by default in ~/.local/share/Ryzom), wait until it downloaded and uncompress all files.

If you want to use your interfaces, configurations, etc... you just need to copy them to ~/.local/share/Ryzom/0

If you have error 307 or error 0 message, just download :
*https://sourceforge.net/projects/ryzom/files/installer/ryzom_live_data.7z/download
*https://sourceforge.net/projects/ryzom/files/installer/ryzom_live_client_linux32.7z/download
*https://sourceforge.net/projects/ryzom/files/installer/ryzom_live_client_linux64.7z/download

You should have "Ryzom Installer" and "Ryzom (Atys)" entries in your applications menu.

If Ryzom doesn't want to start, you may need to install OpenAL on your distribution (you can check that by trying to launch it using command-line).

To start Ryzom (and use your first profile) from command-line, you can use : ~/.local/share/Ryzom/ryzom_live/ryzom_client -p 0

==How to remove the installer and files?==

Go in "Add/Remove programs, it should launch Installer in Uninstaller mode and allow to check components you want to uninstall.

If something went wrong, you may need to check these locations :

*Under Windows XP :
*C:\Documents and Settings\<user name>\Local Settings\Application Data\Ryzom
**C:\Documents and Settings\<user name>\Application Data\Ryzom

*Under Windows Vista and up :
**C:\Users\<user name>\AppData\Local\Ryzom
**C:\Users\<user name>\AppData\Roaming\Ryzom

==Different problems and their solutions==

===What to check and to ask when a player has a problem===

*a screenshot of the error
*what is their platform : Windows, Linux, OS X, 32 or 64 bits
*screenshot of C:\Program Files (x86)\Ryzom
*screenshot of C:\Users\<login>\AppData\Local\Ryzom
*screenshot of C:\Users\<login>\AppData\Local\Ryzom\ryzom_live
*(screenshot of another directory if they didn’t install Ryzom Installer in default directories)
*copy-paste of C:\Users\<login>\AppData\Local\Ryzom\ryzom_installer.ini
*copy-paste of C:\Users\<login>\AppData\Roaming\Ryzom\0\client.log
*copy-paste of C:\Users\<login>\AppData\Roaming\Ryzom\0\client.cfg
*screenshot of C:\Users\<login>\AppData\Roaming\Ryzom\0\user content
*(if they used a profile different of 0, replace the 0 by the right profile ID before)

===Ryzom Installer can't run and displays an error message box===

Ryzom Installer, after installing it, is using 32 bits DLLs in C:\Users\<login>\AppData\Local\Ryzom and Ryzom Installer from C:\Users\<login>\AppData\Local\Ryzom\ryzom_live should be in 64 bits if you chose a 64 bits client. After a patch, client is copying Ryzom Installer from C:\Users\<login>\AppData\Local\Ryzom\ryzom_live to C:\Users\<login>\AppData\Local\Ryzom and then DLLs in C:\Users\<login>\AppData\Local\Ryzom could be incompatible with the copied Ryzom Installer :( The temporary fix is to copy both msvcp100.dll, msvcr100.dll and ryzom_installer_qt_r.exe from C:\Users\<login>\AppData\Local\Ryzom\ryzom_live to C:\Users\<login>\AppData\Local\Ryzom. This will be fixed in next patch.

===Ryzom Installer seems blocked/stalled===

If Ryzom Installer seems blocked/stalled, it can be because there was a previously version of Ryzom Installer that wasn’t properly uninstalled or if player moved directories and configuration file became invalid. In this case, it’s possible to uninstall it completely by removing whole content of C:\Users\<login>\AppData\Local\Ryzom and C:\Users\<login>\AppData\Roaming\Ryzom but please be sure that player hasn’t files he would like to keep before doing that. In that case, always make a backup.

===Not enough disk space===

If players have not enough disk space, it should notify them and they'll have to chose another location.

===Error 6===

It means than the downloaded 7z file was incomplete and Ryzom Installer couldn't uncompress it. The best fix is to find the file in C:\Users\<login>\AppData\Local\Ryzom and to change its extension from .7z to .7z.part (just adding a .part). If you restart Ryzom Installer, it should try to resume the file. If it takes too long, you can download it manually (see error 307) and move it to C:\Users\<login>\AppData\Local\Ryzom.

===Error 126 on a ATI/AMD card===

If a player with an ATI/AMD card has an error 126 when launching Ryzom or Configuration (it should only display the splash screen and then the error in a dialog), you need to go to C:\Windows\System32 and copy atio6axx.dll to atiogl64.dll After this change, Ryzom should launch :)

===Error 307 & Error 0===

It’s a problem with Sourceforge.

First you need to close Ryzom Installer.

To fix that you can manually download the required files :
*Data : https://sourceforge.net/projects/ryzom/files/installer/ryzom_live_data.7z/download
*Windows 64 bits client : https://sourceforge.net/projects/ryzom/files/installer/ryzom_live_client_win64.7z/download
*Windows 32 bits client : https://sourceforge.net/projects/ryzom/files/installer/ryzom_live_client_win32.7z/download
*Linux 64 bits client : https://sourceforge.net/projects/ryzom/files/installer/ryzom_live_client_linux64.7z/download
*Linux 32 bits client : https://sourceforge.net/projects/ryzom/files/installer/ryzom_live_client_linux32.7z/download
*OS X client : https://sourceforge.net/projects/ryzom/files/installer/ryzom_live_client_osx.7z/download

Data are always required and you need to download the right client.

Then you move all these 7z files in :
*Windows : C:\Users\<login>\AppData\Local\Ryzom
*Linux : HOME/.local/share/Ryzom
*OS X: HOME/Library/Application Support/Ryzom

And relaunch Ryzom Installer, it should detect files and uncompress them.

===Direct3D driver / OpenGL===

If player used a Direct3D driver with 2.1 client and since client.cfg will be copied, it’ll continue to use D3D. Now that OpenGL is recommended driver for all cards, players could need to switch to it manually clicking on Configure button in Ryzom Installer and select OpenGL (or Auto) instead of Direct3D. If not, he could have texture issues.

===White or black textures===

The default quality has been improved in v3 clients. By the way, v3 clients use 128 Mo of video memory against 32 Mo for v2's ones.

The textures are sent to the graphic card's memory. If you see them in white or black, it's probably because your graphic card has not got enough memory to stock them.
Moreover, if your graphic card does not support the compressed textures, Ryzom detects it and unzips them before to send them.

So in case of white or black graphic issue, please reduce the graphic qualities in Configuration and deactive FXAA (lower graphic quality and no effects), it should help to fix the problem.
If it does not work, try to switch from OpenGL to Direct3D. It could fix the texture issue... but you'll see the trees moving, trunk included (know bug: https://bitbucket.org/ryzom/ryzomcore/issues/160/wind-tree-vp-not-working-correcly-under ).

===point_except_handler4_common could not be located in the dynamic link library msvcrt.dll===

Error is The procedure entry point_except_handler4_common could not be located in the dynamic link library msvcrt.dll, to fix it you need to :
*Browse to C:\Windows\System32 folder and find file '''dwmapi.dll'''
*Rename this file from '''dwmapi.dll''' to '''dwmapi.dll_old'''

===Player can't start client because of a wrong DLL===

*Edit C:\Users\<login>\AppData\Local\Ryzom\ryzom_installer.ini, remove the directory after '''source_directory=''' to be sure, it won't copy again from old client
*Remove completely all DLLs and EXEs in C:\Users\<login>\AppData\Local\Ryzom\ryzom_live
*Download the right client on SourceForge (see Error 307)
*Put it to C:\Users\<login>\AppData\Local\Ryzom (don't uncompress it!)
*Restart Ryzom Installer
*It should uncompress the new client and you should be able to patch and play after that

===Case of manually move of "ryzom_live" folder===

If player manually moves "ryzom_live" folder or another one, Ryzom Installer won't detect it and player will have to edit his ryzom_installer.ini

===German players with an English Windows environment===

If German player has an English Windows environment than Ryzom will start in English too, even when the user has chosen a German installation (this only chose the language for the installation process, not the language for the game itself)

===Location of default files under all platforms===

*Windows Vista and up :
**C:\Users\<login>\AppData\Local\Ryzom
**C:\Users\<login>\AppData\Roaming\Ryzom
*Windows XP :
**C:\Documents and Settings\<login>\Local Settings\Application Data\Ryzom
**C:\Documents and Settings\<login>\Application Data\Ryzom
*Linux :
**HOME/.local/share/Ryzom (both profiles (0, 1, 2, etc…) and servers (ryzom_live, ryzom_dev, etc…) are in the same directory)
*OS X :
**HOME/Library/Application Support/Ryzom (both profiles (0, 1, 2, etc…) and servers (ryzom_live, ryzom_dev, etc…) are in the same directory)
**HOME/Library/Containers/com.winchgate.Ryzom/Data/Library/Application Support/Ryzom for AppStore version

===What to do if I do not find a solution to my problem in this list?===

Please come on #ryzom on IRC Freenode (direct link: http://webchat.freenode.net/?channels=ryzom and someone will help you in direct!

===No sound when using OpenAL driver===

Be sure to have installed https://www.openal.org/downloads/oalinst.zip (under Windows) or OpenAL package for your distribution (libopenal1 under Debian-based ones). OpenAL is always installed under OS X.

===Unable to install OS X version of Ryzom Installer===

* Open '''System Preferences'''
* Open the '''Security & Privacy''' pane
* Select the '''General''' tab
* Click on '''Open anyway''' next to '''Ryzom Installer''' and it'll open '''Ryzom Installer''' package

===If there are any bug with Ryzom Installer===

In all cases, if you found a bug with '''Ryzom Installer''', you can download and install latest versions from http://ryzom.com and try it. They'll be updated regularly.

===My download is very slow===

You can close '''Ryzom Installer''', Sourceforge should redirect to a best mirror and your download will resume.

===Crash after teleporting===

It could be related to '''XAudio2''' driver under Windows. You can switch to '''FMod''' driver and check if it's better, to do that simply add to your client.cfg :

DriverSound = "FMod";

===Ryzom Installer is always copying old data===

You should need to uninstall Ryzom Installer and reinstall it or edit ryzom_installer.ini and remove directory on line '''source_directory='''

===No OpenGL driver for ATI Radeon HD 4500 series===

Download legacy drivers on : http://support.amd.com/fr-fr/download/desktop/legacy?product=legacy2&os=Windows%207%20-%2064

If this case occurs, you should see in client.log :

2016/10/25 03:31:16 INF 2d0 ryzom_client_r.exe driver_opengl_extension.cpp 1589 NL3D::registerGlExtensions : 3D: OpenGL 1.1.0 / Microsoft Corporation / GDI Generic

===Crash before character selection and after login===

If player has '''nel_report_*.log''' with content :

A failed assertion occurs
ProcName: ryzom_client_r.exe
Date: 2016/10/30 11:14:29
File: Z:/home/nevrax/ryzomcore/code/nel/include\nel/misc/singleton.h
Line: 155
FuncName: NLMISC::CManualSingleton<class NLSOUND::CListenerFMod>::getInstance
Reason: "_instance() != NULL"
-------------------------------

No log
-------------------------------

And last lines in client.log :

2016/10/30 12:59:27 INF 5e8 ryzom_client_r.exe common.cpp 682 NLMISC::Exception::Exception : Exception will be launched: Failed to create the FMod driver object
2016/10/30 12:59:27 WRN 5e8 ryzom_client_r.exe audio_mixer_user.cpp 479 NLSOUND::CAudioMixerUser::initDevice : Failed to create the FMod driver object

Then player system don't succeed to load FMod driver :( I suggest to switch back to XAudio2 driver by adding to their '''client.cfg''' :

DriverSound = "XAudio2";

===Player launched Ryzom, don't see any window on the screen but the icon is present in task bar===

Coordinates of Ryzom window are outside the screen, to fix that :

* launch Ryzom Configuration by clicking on Configure
* in Display section you can check values for '''Position X''' and '''Position Y''' and correct them
* click on '''Apply'''

===Player receives "Empty answer from server (error code 62)"===

If this error message occurs, it means that Ryzom didn't receive any response from server. In most of cases, it's related to a connection problem. If you have an anti-virus and/or a firewall you could try to disable them (at least to check if it works).

You can also try to display URL : http://shard.ryzom.com:40916/login/r2_login.php?cmd=ask

If it displays an error message or a blank page, you found the problem (that's your connection), if it displays the correct message : '''0:Invalid account: (2001) (in askSalt)''' it's something else.

===Client crashed with Access Violation exception generated at 0xXXXX, thread attempts to read at 0xXXXXX===

It's a standard crash, you need to gather more details depending on the moment where it crashed.

* If before displaying login screen : corrupted data, bad 3D driver, etc...
* If after login screen but before character selection : bad sound driver, corrupted data, etc...
* If after character selection/creation : FXAA (you need to disable 3D effects), corrupted data, etc...

===Unable to install Ryzom Installer under OS X===

With old OS X versions, you can get an error message when installing Ryzom Installer, to workaround that you can directly download a ZIP file containing Ryzom Installer on:
http://devl1.ryzom.com/RyzomInstaller.zip

=== Error codes from Ryzom Installer ===

These errors are from Qt, you can find them on : http://doc.qt.io/qt-5/qabstractsocket.html#SocketError-enum

==Installation of server test Yubo (v3)==

'''WARNING: you can only access Yubo shard if you have got a specific account with yubo access.'''

To add Yubo with Ryzom Installer, just follow these steps :

-close Ryzom Installer if it is launched

-show your hidden folders

-WINDOWS: go to C:\Users\<login>\AppData\Local\Ryzom - or type %appdata% in explorers' addressbar and go back one time to find local folder

-MAC: go to ~/Library/Application Support/Ryzom

-LINUX: go to ~/.local/share/Ryzom under Linux or the other folder where you installed Ryzom

-copy ryzom_live folder to ryzom_dev

-open ryzom_installer.ini with a text editor (Wordpad, notepad++, gedit, etc...)

(to find it:
WINDOWS -> C:\Users\<login>\AppData\Local\Ryzom - or type %appdata% in explorers' addressbar and go back one time to find local folder
MAC -> find the ryzom_installer.ini in /Users/<Your UserID>/Library/Application Support/Ryzom

- delete all parts beginning by [servers] and [server_0] and put :

[servers]
size=2

[server_0]
id=ryzom_live
name=Atys
display_url="http://app.ryzom.com/app_releasenotes/index.php?lang=$LANG"
files_list_url="https://sourceforge.net/projects/ryzom/rss?path=/installer"
data_download_url="http://downloads.sourceforge.net/project/ryzom/installer/ryzom_live_data.7z?r=&ts=$TIMESTAMP"
data_download_filename=ryzom_live_data.7z
data_compressed_size=1500000000
data_uncompressed_size=7000000000
client_download_url="http://downloads.sourceforge.net/project/ryzom/installer/ryzom_live_client_$ARCH.7z?r=&ts=$TIMESTAMP"
client_download_filename=ryzom_live_client_$ARCH.7z
client_filename_windows=ryzom_client_r.exe
client_filename_osx=Ryzom.app/Contents/MacOS/Ryzom
client_filename_linux=ryzom_client
client_filename_old_windows=client_ryzom_rd.exe
configuration_filename_windows=ryzom_configuration_qt_r.exe
configuration_filename_osx=Ryzom.app/Contents/MacOS/RyzomConfiguration
configuration_filename_linux=ryzom_configuration_qt
comments=

[server_1]
id=ryzom_dev
name=Yubo
display_url="http://app.ryzom.com/app_releasenotes/index.php?lang=$LANG"
files_list_url="https://sourceforge.net/projects/ryzom/rss?path=/installer"
data_download_url="http://downloads.sourceforge.net/project/ryzom/installer/ryzom_live_data.7z?r=&ts=$TIMESTAMP"
data_download_filename=ryzom_live_data.7z
data_compressed_size=1500000000
data_uncompressed_size=7000000000
client_download_url="http://downloads.sourceforge.net/project/ryzom/installer/ryzom_live_client_$ARCH.7z?r=&ts=$TIMESTAMP"
client_download_filename=ryzom_live_client_$ARCH.7z
client_filename_windows=ryzom_client_r.exe
client_filename_osx=Ryzom.app/Contents/MacOS/Ryzom
client_filename_linux=ryzom_client
client_filename_old_windows=client_ryzom_rd.exe
configuration_filename_windows=ryzom_configuration_qt_r.exe
configuration_filename_osx=Ryzom.app/Contents/MacOS/RyzomConfiguration
configuration_filename_linux=ryzom_configuration_qt
comments=Test server

- save the file

- WINDOWS: launch Ryzom Installer in Ryzom's main folder

- MAC: launch Ryzom Installer in /Applications

- LINUX: launch Ryzom Installer in Applications menus

- create new profiles in Settings -> Profiles, you should have Atys and Yubo as server choice now :)

- click on "Open" button to open profile folder

- open client.cfg with a text editor (Wordpad, notepad++, gedit, etc...

- add the line at the end (if not already done) : Application = {"ryzom_dev", "./client_ryzom_r.exe", "./"};

- save client.cfg

- return back to Ryzom Installer window

- click on OK

- select your profile and click on Play, it should patch

Building Ryzom Client On Windows

2017-06-03T10:19:10Z

Riasan:

== Downloading prerequisites ==

Even if Ryzom Core supports Visual C++ 2008, 2010, 2012 and 2015, we recommend to use the last one because it supports most features and needs less steps to configure. It also supports Qt 5 with an available extension.

* Tortoise Hg: http://tortoisehg.bitbucket.org
* CMake: https://cmake.org/download/
* 7-Zip: http://www.7-zip.org
* External for Visual C++ 2015: https://sourceforge.net/projects/ryzom/files/external_vc14.7z/download
* DirectX 9 SDK: https://www.microsoft.com/en-us/download/details.aspx?id=6812
* Qt 5 (optional for graphical tools): https://www.qt.io/download-open-source/
* Notepad++ (optional to edit files): https://notepad-plus-plus.org
* WinMerge 2011 (optional to compare files, don't forget to rename to .exe): https://bitbucket.org/jtuc/winmerge2011/downloads

To download '''Visual Studio Community 2015 with Update 3 (7.19 GB)''' click to download https://stackoverflow.com/questions/38134857/visual-studio-2015-update-3-offline-installer-iso .

A popup will appear with '''vs_community.exe''' (the online installer) and '''vs2015.3com_XXX.iso''' the ISO file if you want to download everything at once (easier if you need to install it several times). You don't need to mount the ISO file, you can uncompress it with '''7-Zip''' you downloaded and installed earlier.

Warning! Be sure to check '''Visual C++''' components.

Unlike '''Visual Studio 2010''', you don't need to download separately 64 bits compilers and '''Windows SDK''' since they are included.

== Installing prerequisites ==

Install '''Tortoise Hg''', '''CMake''', '''7-Zip''', '''DirectX 9 SDK''', '''Qt 5''', '''Notepad++''', '''WinMerge 2011''' and '''Microsoft Visual Studio Community 2015'''. Don't forget to check all '''C++''' components for this last one.

If you got an error '''S1023''' when installing the '''DirectX 9 SDK''', please check : https://support.microsoft.com/en-us/kb/2728613

== Getting source ==

Create a new folder called '''Ryzom''' somewhere where you have write access, go in it with Explorer. Click with right mouse button, then on '''TortoiseHg''' -> '''Clone''', you will get a dialog. In '''Source''' enter https://bitbucket.org/ryzom/ryzomcore and '''Destination''' will be filled automatically with '''ryzomcore'''. Finally, click on '''Clone''' to download all '''Ryzom Core''' files.

== Configure TortoiseHg ==

We need to configure '''TortoiseHg''' to simplify code update later. Right click on your new directory '''ryzomcore''' and click on '''Hg Workbench''', it should launch TortoiseHg.

Select the last commit line where appears '''compatibility-develop''' in '''Branch''' column, right-click on it and '''Update...'''.

Now go to '''Files''' -> '''Settings''' and define different options :

* in '''TortoiseHg''' tab :

# '''Three-way Merge Tool''' : winmergeu
# '''Visual Diff Tool''' : winmergeu
# '''Visual Editor''' : notepad++

* in '''Commit''' tab, '''Username''' : Put your username if you want to commit something
* in '''Sync''' tab, '''After Pull Operation''' : update

If you want to edit these options later, you can also directly edit the file '''C:\Users\<Login>\mercurial.ini'''. Mine is :

<pre>
[ui]
username = <username>
merge = winmergeu

[tortoisehg]
ui.language = en
vdiff = winmergeu
editor = notepad++
autoresolve = True
postpull = update
shell = windows_command_prompt
vdiff = winmergeu
engmsg = True

[extensions]
mercurial_keyring =
purge =
eol =
transplant =
hggit =
strip =

[eol]
native = LF

[auth]
bitbucket.prefix = bitbucket.org
bitbucket.username = <login>
bitbucket.password = <password>
bitbucket.schemes = https
</pre>

== Installing external ==

Create an '''external''' directory in '''ryzomcore''' and uncompress '''external_vc14.7z''' here.

== Configuring Ryzom project ==

* Launch '''CMake (cmake-gui)''' and define '''Where is the source code''' to <your path>/Ryzom/ryzomcore/code and '''Where to build the binaries''' to <your path>/Ryzom/ryzomcore/build
* Press '''Configure'''
* Select '''Visual Studio 14 2015 (Win64)''' (64 bits) or '''Visual Studio 14 2015''' (32 bits)
* Press '''Finish'''
* Uncheck : '''WITH_LUA51''', '''WITH_NEL_SAMPLES''', '''WITH_NEL_TESTS''', '''WITH_NEL_TOOLS''', '''WITH_RYZOM_SERVER''', '''WITH_RYZOM_TOOLS'''
* Check : '''WITH_LUA53'''
* I suggest to click on '''File''' -> '''Delete Cache'''
* Press '''Configure'''
* Press '''Generate'''

[[Image:Cmake_example.png]]

== Launch project ==

Double-click on '''RyzomCore.sln''' file in '''build''' directory.

== Visual Studio 2010 ==

If you want to compile for 64-bit, you'll additionally need:

* Microsoft .NET Framework 4
* Microsoft Windows SDK 7.1
* Microsoft Visual C++ 2010 Service Pack 1 Compiler Update for the Windows SDK 7.1

If Windows SDK installer complains about a beta version of .NET Framework 4 being installed: 

open regedit and edit these two strings: 

<big><code>HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\NET Framework Setup\NDP\v4\Client\Version
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\NET Framework Setup\NDP\v4\Full\Version</code></big>
You might have to give yourself ownership of Client and Full folder and then all access rights to be able to edit the Version label... replace the version with '4.0.30319'. Relaunch the Microsoft Windows SDK installer, and when it's finished restore the original value into the version field and change permissions back. 
Solution taken from: http://stackoverflow.com/questions/32091593/cannot-install-windows-sdk-7-1-on-windows-10/32322920#32322920 
 

With Visual Studio 2010 you'll normally encounter following error:

<big><code>error C2719: '_Val': formal parameter with __declspec(align('16')) won't be aligned</code>
</big> 
You have to edit the header file C:\Programs\Microsoft Visual Studio 10.0\VC\include\vector

change line 869 
from: 
<big><code>void resize(size_type _Newsize, _Ty _Val)</code>
</big>to: 
<big><code>void resize(size_type _Newsize, const _Ty& _Val)</code>
</big>

Building Ryzom Client On Windows

2017-06-03T10:12:42Z

Riasan:

== Downloading prerequisites ==

Even if Ryzom Core supports Visual C++ 2008, 2010, 2012 and 2015, we recommend to use the last one because it supports most features and needs less steps to configure. It also supports Qt 5 with an available extension.

* Tortoise Hg: http://tortoisehg.bitbucket.org
* CMake: https://cmake.org/download/
* 7-Zip: http://www.7-zip.org
* External for Visual C++ 2015: https://sourceforge.net/projects/ryzom/files/external_vc14.7z/download
* DirectX 9 SDK: https://www.microsoft.com/en-us/download/details.aspx?id=6812
* Qt 5 (optional for graphical tools): https://www.qt.io/download-open-source/
* Notepad++ (optional to edit files): https://notepad-plus-plus.org
* WinMerge 2011 (optional to compare files, don't forget to rename to .exe): https://bitbucket.org/jtuc/winmerge2011/downloads

To download '''Visual Studio Community 2015 with Update 3 (7.19 GB)''' click to download https://stackoverflow.com/questions/38134857/visual-studio-2015-update-3-offline-installer-iso .

A popup will appear with '''vs_community.exe''' (the online installer) and '''vs2015.com_XXX.iso''' the ISO file if you want to download everything at once (easier if you need to install it several times). You don't need to mount the ISO file, you can uncompress it with '''7-Zip''' you downloaded and installed earlier.

Warning! Be sure to check '''Visual C++''' components.

Unlike '''Visual Studio 2010''', you don't need to download separately 64 bits compilers and '''Windows SDK''' since they are included.

== Installing prerequisites ==

Install '''Tortoise Hg''', '''CMake''', '''7-Zip''', '''DirectX 9 SDK''', '''Qt 5''', '''Notepad++''', '''WinMerge 2011''' and '''Microsoft Visual Studio Community 2015'''. Don't forget to check all '''C++''' components for this last one.

If you got an error '''S1023''' when installing the '''DirectX 9 SDK''', please check : https://support.microsoft.com/en-us/kb/2728613

== Getting source ==

Create a new folder called '''Ryzom''' somewhere where you have write access, go in it with Explorer. Click with right mouse button, then on '''TortoiseHg''' -> '''Clone''', you will get a dialog. In '''Source''' enter https://bitbucket.org/ryzom/ryzomcore and '''Destination''' will be filled automatically with '''ryzomcore'''. Finally, click on '''Clone''' to download all '''Ryzom Core''' files.

== Configure TortoiseHg ==

We need to configure '''TortoiseHg''' to simplify code update later. Right click on your new directory '''ryzomcore''' and click on '''Hg Workbench''', it should launch TortoiseHg.

Select the last commit line where appears '''compatibility-develop''' in '''Branch''' column, right-click on it and '''Update...'''.

Now go to '''Files''' -> '''Settings''' and define different options :

* in '''TortoiseHg''' tab :

# '''Three-way Merge Tool''' : winmergeu
# '''Visual Diff Tool''' : winmergeu
# '''Visual Editor''' : notepad++

* in '''Commit''' tab, '''Username''' : Put your username if you want to commit something
* in '''Sync''' tab, '''After Pull Operation''' : update

If you want to edit these options later, you can also directly edit the file '''C:\Users\<Login>\mercurial.ini'''. Mine is :

<pre>
[ui]
username = <username>
merge = winmergeu

[tortoisehg]
ui.language = en
vdiff = winmergeu
editor = notepad++
autoresolve = True
postpull = update
shell = windows_command_prompt
vdiff = winmergeu
engmsg = True

[extensions]
mercurial_keyring =
purge =
eol =
transplant =
hggit =
strip =

[eol]
native = LF

[auth]
bitbucket.prefix = bitbucket.org
bitbucket.username = <login>
bitbucket.password = <password>
bitbucket.schemes = https
</pre>

== Installing external ==

Create an '''external''' directory in '''ryzomcore''' and uncompress '''external_vc14.7z''' here.

== Configuring Ryzom project ==

* Launch '''CMake (cmake-gui)''' and define '''Where is the source code''' to <your path>/Ryzom/ryzomcore/code and '''Where to build the binaries''' to <your path>/Ryzom/ryzomcore/build
* Press '''Configure'''
* Select '''Visual Studio 14 2015 (Win64)''' (64 bits) or '''Visual Studio 14 2015''' (32 bits)
* Press '''Finish'''
* Uncheck : '''WITH_LUA51''', '''WITH_NEL_SAMPLES''', '''WITH_NEL_TESTS''', '''WITH_NEL_TOOLS''', '''WITH_RYZOM_SERVER''', '''WITH_RYZOM_TOOLS'''
* Check : '''WITH_LUA53'''
* I suggest to click on '''File''' -> '''Delete Cache'''
* Press '''Configure'''
* Press '''Generate'''

[[Image:Cmake_example.png]]

== Launch project ==

Double-click on '''RyzomCore.sln''' file in '''build''' directory.

== Visual Studio 2010 ==

If you want to compile for 64-bit, you'll additionally need:

* Microsoft .NET Framework 4
* Microsoft Windows SDK 7.1
* Microsoft Visual C++ 2010 Service Pack 1 Compiler Update for the Windows SDK 7.1

If Windows SDK installer complains about a beta version of .NET Framework 4 being installed: 

open regedit and edit these two strings: 

<big><code>HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\NET Framework Setup\NDP\v4\Client\Version
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\NET Framework Setup\NDP\v4\Full\Version</code></big>
You might have to give yourself ownership of Client and Full folder and then all access rights to be able to edit the Version label... replace the version with '4.0.30319'. Relaunch the Microsoft Windows SDK installer, and when it's finished restore the original value into the version field and change permissions back. 
Solution taken from: http://stackoverflow.com/questions/32091593/cannot-install-windows-sdk-7-1-on-windows-10/32322920#32322920 
 

With Visual Studio 2010 you'll normally encounter following error:

<big><code>error C2719: '_Val': formal parameter with __declspec(align('16')) won't be aligned</code>
</big> 
You have to edit the header file C:\Programs\Microsoft Visual Studio 10.0\VC\include\vector

change line 869 
from: 
<big><code>void resize(size_type _Newsize, _Ty _Val)</code>
</big>to: 
<big><code>void resize(size_type _Newsize, const _Ty& _Val)</code>
</big>

Building Ryzom Client On Mac OS X

2017-04-19T16:51:44Z

Riasan:

{{tabLang|EN|Mac OS XDE|Building Ryzom Client under Mac OS X|Mac OS XES|Mac OS XFR|Mac OS XRU}}

{{ToTrad|DE}}
{{ToTrad|ES}}
{{ToTrad|FR}}
{{ToTrad|RU}}

== Installing and configuring Xcode ==

Last Xcode version can be downloaded from Mac AppStore or https://developer.apple.com/xcode/downloads/

To enable command-line tools under Xcode 5 or more recent versions, you'll need to open a terminal and type :

xcode-select --install

Ryzom client needs at least Mac OS X 10.7. If you plan to deploy Ryzom on Mac OS X versions older than your current one (but more recent than 10.7), I suggest you to set MACOSX_DEPLOYMENT_TARGET environment variable before compiling any dependencies :

export MACOSX_DEPLOYMENT_TARGET=10.7

And append that line to '''~/.bash_profile''' to be sure it'll be defined later.

== Installing and configuring MacPorts ==

To install all 3rd party libraries needed by Ryzom, you'll need to download and install MacPorts from : https://www.macports.org/install.php

By default, it'll target your Mac OS X version. To change the target, type :

sudo nano /opt/local/etc/macports/macports.conf

And append at the end of the file :

macosx_deployment_target 10.7
cxx_stdlib libc++

Press CTRL+X / Apple+X to save and confirm.

Then open a terminal and type :

sudo port install mercurial p7zip cmake curl freetype jpeg libxml2 lua zlib libpng libogg
sudo port -s -v install boost libvorbis icu

Note : The '''-s''' option is used to force a rebuild from source (to take into account the new options added to macports.conf) else it'll use a precompiled package. ICU will be used if you need to compile a static version of Qt.

== Compiling Luabind ==

Open a terminal and write the following lines :

hg clone http://hg.kervala.net/luabind
hg clone http://hg.kervala.net/cmake

export CMAKE_MODULE_PATH=$(pwd)/cmake/modules

cd luabind
cmake -DWITH_STATIC=ON -DWITH_SHARED=OFF -DWITH_LUA53=ON -DWITH_LUA51=OFF
make
sudo make install
cd ../..

Luabind will be installed in /usr/local and should not conflict with MacPorts or system files.

== Downloading Ryzom code ==

For first time, please type :

hg clone -b compatibility-develop https://bitbucket.org/ryzom/ryzomcore

Later, to only update sources you will need to type :

hg pull && hg update

== Compiling Ryzom client ==

This section shows how to create a static Ryzom Core client built on Mac OS X. The resulting binary only depends on system libs, therefore can be moved easily to another Mac OS X machine. The given list of CMake options is just an example. For a complete list see: CMake Options. Building a Ryzom Core client that depends on NeL and Ryzom shared libraries is strongly discouraged.

cd ryzomcore
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release -DWITH_STATIC=ON -DWITH_STATIC_DRIVERS=ON \
-DWITH_NEL_TOOLS=OFF -DWITH_NEL_SAMPLES=OFF -DWITH_NEL_TESTS=OFF -DWITH_RYZOM_SERVER=OFF \
-DWITH_RYZOM_TOOLS=OFF -DWITH_STATIC_EXTERNAL=ON -DWITH_LUA53=ON -DWITH_LUA51=OFF ../code
make

The resulting application bundle will be '''bin/Ryzom.app''' and you should copy data to : Ryzom.app/Contents/Resources/data.

The application '''Ryzom''' (Ryzom.app folder in fact) should do around 6 GB, you can launch it double-clicking on the icon.

Ryzom will patch itself when launched.

{{In_Category|Mac}}
{{TPInWikiRyzom}}
[[Category:Tutorials]] [[Category:Support]] [[Category:Mac]] [[Category:EN]]

Building Ryzom Client On Mac OS X

2017-04-18T19:13:59Z

Riasan:

{{tabLang|EN|Mac OS XDE|Building Ryzom Client under Mac OS X|Mac OS XES|Mac OS XFR|Mac OS XRU}}

{{ToTrad|DE}}
{{ToTrad|ES}}
{{ToTrad|FR}}
{{ToTrad|RU}}

== Installing and configuring Xcode ==

Last Xcode version can be downloaded from Mac AppStore or https://developer.apple.com/xcode/downloads/

To enable command-line tools under Xcode 5 or more recent versions, you'll need to open a terminal and type :

xcode-select --install

Ryzom client needs at least Mac OS X 10.7. If you plan to deploy Ryzom on Mac OS X versions older than your current one (but more recent than 10.7), I suggest you to set MACOSX_DEPLOYMENT_TARGET environment variable before compiling any dependencies :

export MACOSX_DEPLOYMENT_TARGET=10.7

And append that line to '''~/.bash_profile''' to be sure it'll be defined later.

== Installing and configuring MacPorts ==

To install all 3rd party libraries needed by Ryzom, you'll need to download and install MacPorts from : https://www.macports.org/install.php

By default, it'll target your Mac OS X version. To change the target, type :

sudo nano /opt/local/etc/macports/macports.conf

And append at the end of the file :

macosx_deployment_target 10.7
cxx_stdlib libc++

Press CTRL+X / Apple+X to save and confirm.

Then open a terminal and type :

sudo port install mercurial p7zip cmake curl freetype jpeg libxml2 lua zlib libpng libogg
sudo port -s -v install boost libvorbis icu

Note : The '''-s''' option is used to force a rebuild from source (to take into account the new options added to macports.conf) else it'll use a precompiled package. ICU will be used if you need to compile a static version of Qt.

== Compiling Luabind ==

Open a terminal and write the following lines :

hg clone http://hg.kervala.net/luabind
hg clone http://hg.kervala.net/cmake

export CMAKE_MODULE_PATH=$(pwd)/cmake/modules

cd luabind
cmake -DWITH_STATIC=ON -DWITH_SHARED=OFF -DWITH_LUA53=ON -DWITH_LUA51=OFF..
make
sudo make install
cd ../..

Luabind will be installed in /usr/local and should not conflict with MacPorts or system files.

== Downloading Ryzom code ==

For first time, please type :

hg clone -b compatibility-develop https://bitbucket.org/ryzom/ryzomcore

Later, to only update sources you will need to type :

hg pull && hg update

== Compiling Ryzom client ==

This section shows how to create a static Ryzom Core client built on Mac OS X. The resulting binary only depends on system libs, therefore can be moved easily to another Mac OS X machine. The given list of CMake options is just an example. For a complete list see: CMake Options. Building a Ryzom Core client that depends on NeL and Ryzom shared libraries is strongly discouraged.

cd ryzomcore
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release -DWITH_STATIC=ON -DWITH_STATIC_DRIVERS=ON \
-DWITH_NEL_TOOLS=OFF -DWITH_NEL_SAMPLES=OFF -DWITH_NEL_TESTS=OFF -DWITH_RYZOM_SERVER=OFF \
-DWITH_RYZOM_TOOLS=OFF -DWITH_STATIC_EXTERNAL=ON ../code
make

The resulting application bundle will be '''bin/Ryzom.app''' and you should copy data to : Ryzom.app/Contents/Resources/data.

The application '''Ryzom''' (Ryzom.app folder in fact) should do around 6 GB, you can launch it double-clicking on the icon.

Ryzom will patch itself when launched.

{{In_Category|Mac}}
{{TPInWikiRyzom}}
[[Category:Tutorials]] [[Category:Support]] [[Category:Mac]] [[Category:EN]]

Building Ryzom Client On Mac OS X

2017-04-18T19:13:13Z

Riasan:

{{tabLang|EN|Mac OS XDE|Building Ryzom Client under Mac OS X|Mac OS XES|Mac OS XFR|Mac OS XRU}}

{{ToTrad|DE}}
{{ToTrad|ES}}
{{ToTrad|FR}}
{{ToTrad|RU}}

== Installing and configuring Xcode ==

Last Xcode version can be downloaded from Mac AppStore or https://developer.apple.com/xcode/downloads/

To enable command-line tools under Xcode 5 or more recent versions, you'll need to open a terminal and type :

xcode-select --install

Ryzom client needs at least Mac OS X 10.7. If you plan to deploy Ryzom on Mac OS X versions older than your current one (but more recent than 10.7), I suggest you to set MACOSX_DEPLOYMENT_TARGET environment variable before compiling any dependencies :

export MACOSX_DEPLOYMENT_TARGET=10.7

And append that line to '''~/.bash_profile''' to be sure it'll be defined later.

== Installing and configuring MacPorts ==

To install all 3rd party libraries needed by Ryzom, you'll need to download and install MacPorts from : https://www.macports.org/install.php

By default, it'll target your Mac OS X version. To change the target, type :

sudo nano /opt/local/etc/macports/macports.conf

And append at the end of the file :

macosx_deployment_target 10.7
cxx_stdlib libc++

Press CTRL+X / Apple+X to save and confirm.

Then open a terminal and type :

sudo port install mercurial p7zip cmake curl freetype jpeg libxml2 lua zlib libpng libogg
sudo port -s -v install boost libvorbis icu

Note : The '''-s''' option is used to force a rebuild from source (to take into account the new options added to macports.conf) else it'll use a precompiled package. ICU will be used if you need to compile a static version of Qt.

== Compiling Luabind ==

Open a terminal and write the following lines :

hg clone http://hg.kervala.net/luabind
hg clone http://hg.kervala.net/cmake

export CMAKE_MODULE_PATH=$(pwd)/cmake/modules

cd packaging/luabind
mkdir build
cd build
cmake -DWITH_STATIC=ON -DWITH_SHARED=OFF -DWITH_LUA53=ON -DWITH_LUA51=OFF..
make
sudo make install
cd ../../..

Luabind will be installed in /usr/local and should not conflict with MacPorts or system files.

== Downloading Ryzom code ==

For first time, please type :

hg clone -b compatibility-develop https://bitbucket.org/ryzom/ryzomcore

Later, to only update sources you will need to type :

hg pull && hg update

== Compiling Ryzom client ==

This section shows how to create a static Ryzom Core client built on Mac OS X. The resulting binary only depends on system libs, therefore can be moved easily to another Mac OS X machine. The given list of CMake options is just an example. For a complete list see: CMake Options. Building a Ryzom Core client that depends on NeL and Ryzom shared libraries is strongly discouraged.

cd ryzomcore
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release -DWITH_STATIC=ON -DWITH_STATIC_DRIVERS=ON \
-DWITH_NEL_TOOLS=OFF -DWITH_NEL_SAMPLES=OFF -DWITH_NEL_TESTS=OFF -DWITH_RYZOM_SERVER=OFF \
-DWITH_RYZOM_TOOLS=OFF -DWITH_STATIC_EXTERNAL=ON ../code
make

The resulting application bundle will be '''bin/Ryzom.app''' and you should copy data to : Ryzom.app/Contents/Resources/data.

The application '''Ryzom''' (Ryzom.app folder in fact) should do around 6 GB, you can launch it double-clicking on the icon.

Ryzom will patch itself when launched.

{{In_Category|Mac}}
{{TPInWikiRyzom}}
[[Category:Tutorials]] [[Category:Support]] [[Category:Mac]] [[Category:EN]]

Building Ryzom Client On Debian

2017-03-25T16:50:34Z

Riasan: /* Downloading ryzom dependencies */

== General ==

This page applies for Debian-based GNU/Linux distributions. It should work on other linux distribution too, but some package name might change. To compile Ryzom client under Mac OS X, please check this page : [[Building Ryzom Client On Mac OS X]]. For Archlinux, check [[Building Ryzom Client On Archlinux]]

If you are building the client for your own computer, build a dynamically linked version. If you are building it for other people, it's probably safer to build a statically linked version (note : you should use a distribution with a not too recent libc6, if you want it to work on as many platforms as possible. I recommend a debian Jessie, and doing that in a chroot or a VM).

Lines starting with a $ are meant to be run as a regular user, while lines starting with a # are meant to be run as root.

== Common steps ==
=== Downloading ryzom dependencies ===

Tools needed to build the client :
# apt install mercurial autoconf automake cmake libtool build-essential bison
Libraries needed :
# apt install libluabind-dev libfreetype6-dev libcurl4-openssl-dev libx11-dev \
libgl1-mesa-dev libxxf86vm-dev libxrandr-dev libxrender-dev libopenal-dev \
libogg-dev libvorbis-dev libxml2-dev libpng-dev libjpeg-dev libxmu-dev libssl-dev liblzma-dev

If you are using debian jessie (or older), the CMake version in the repo is too old. You need to take it from jessie-backports (or, for earlier version than jessie, compile it yourself), for that, add to your /etc/apt/sources.list :
deb http://ftp.debian.org/debian/ jessie-backports main
Then, update & install :
# apt update
# apt install -t jessie-backports cmake

=== Getting ryzom code ===

$ cd ~
$ hg clone https://bitbucket.org/ryzom/ryzomcore
We just need to switch branch (very important)
$ cd ryzomcore
$ hg update -c compatibility-develop

If you need to update the code later, just type :
$ hg pull && hg update

== Dynamically linked version ==

=== Building ryzom ===
(Assuming you are in the ryzomcore folder you got in [[#Getting ryzom code]])

$ cmake -DWITH_RYZOM_CLIENT=ON -DWITH_STATIC=ON -DWITH_STATIC_DRIVERS=ON -DWITH_DRIVER_OPENGL=ON -DWITH_QT=OFF -DWITH_NEL_TESTS=OFF -DWITH_RYZOM_SERVER=OFF -DWITH_NEL_SAMPLES=OFF -DWITH_SNOWBALLS=OFF -DWITH_NEL_TOOLS=OFF -DWITH_RYZOM_TOOLS=OFF -DWITH_RYZOM_PATCH=ON ../code

Let's build ! replace n with the number of your cores
$ make -jn ryzom_client

=== Play ryzom ===

Copy the bin/ryzom_client executable in your ryzom folder (if you are using ryzom installer, it's in ~/.local/share/Ryzom/ryzom_live/). I recommend changing the file name to ryzom_client_compiled or something, or it will replace itself with a patched version everytime you run it (assuming you didn't disabled the patch at compilation), and change the executable your profile use (or directly change the value "client_filename_linux" in your server configuration, in ryzom_installer.ini)

That's it !

== Static version ==

=== Compiling ryzom dependencies ===

Note : this is done on a debian jessie, debian stretch (and possibly sid) will have multiples issues with -fPic, needing you to recompile a shitton of library(openssl, gif, curl, almost anything really), so i recommend sticking with jessie.

We just need to build curl ; Grab it from kervala's packaging repository :
$ hg clone http://hg.kervala.net/packaging/
$ cd packaging/curl
$ mkdir build && cd build
$ cmake -DCMAKE_BUILD_TYPE=Release -DCURL_ZLIB=ON -DBUILD_CURL_EXE=OFF -DBUILD_CURL_TESTS=OFF -DCURL_STATICLIB=ON -DHTTP_ONLY=ON -DENABLE_IPV6=ON -DCMAKE_USE_OPENSSL=ON -DOPENSSL_SSL_LIBRARIES=/usr/lib/libssl.a -DOPENSSL_CRYPTO_LIBRARIES=/usr/lib/libcrypto.a -DCMAKE_USE_LIBSSH2=OFF -DZLIB_LIBRARY=/usr/lib/libz.a ..
$ make
# make install

=== Building Ryzom ===

(Assuming you are in the ryzomcore folder you got in [[#Getting ryzom code]])
$ mkdir build_static && cd build_static
(Cmake options are almost the same, we need to use our compiled curl library, and use static_external):

Let's build ! replace n with the number of your cores
$ make -jn ryzom_client

=== Further reading on static building ===

If you actually want to regularely build static ryzom client, you should check [[http://hg.kervala.net/packaging/file/5b4bf439aa91/ryzom/steam|kervala's scripts]], they are very complete and allow you to completely automate your build process.

<references />
{{In_Category|Linux}}
{{TPInWikiRyzom‎}}
[[Category:Support]]
[[Category:Linux]]
[[Category:EN]]