Ryzom

h1. Run Client On Windows

We supposed you have finish the [[BuildForWindowsCmake|compilation]] and now you want to run your own client to connect on the open shard.

NOTE:

1、You may want to check the known issues section at the bottom of the page before you proceed.
2、If you are using your own shard, you may want to use a pre-built client executable file to confirm whether your shard is okay.
Then if your client has problems, you can know it isn't your shard's fault. Direct link to the client:

http://ks35074.kimsufi.com:8080/client_win_x86_stlport-0.8.0.1627.7z also in the [[WindowsBinaries]] page (there may be a newer version there.)

After download, launch ryzom_client_r.exe to test the shard.

h2. Data

The Mercurial repository (pre-built client) doesn't contains all big data like textures, 3d objects... so you need first to "Download the client archive" before starting Ryzom

Legacy client for old shards (such as open.ryzom):
https://sourceforge.net/projects/ryzom/files/ryzom_client_open.7z/download.

That client will work with open.ryzom.

New client for recent shards builds: [Does this also work with open.ryzom? If it does, should say so and people can avoid downloading twice.]

http://ks35074.kimsufi.com:8080/client_win_x86_stlport-0.8.0.1627.7z or [[WindowsBinaries]]

[Neither which runs, complaining of some Direct3D issue with NL3D, despite the config set to use OpenGL. Is there a dependency chain? Do you *need* to compile to run Ryzom Core?]

That client won't work with open.ryzom.

Extract the archive anywhere, for example in @c:\ryzom_client@.
Then replace the binary and the drivers with your own.

h2. Running under Visual studio

Right click on @"client"@ project on the left tree then click on *Set as Startup Project*

Right click on @"client"@ project on the left tree then click on *Properties*

In @Configuration Properties->Debugging->Working Directory@ set the path to the client directory, for example @c:\ryzom_client@. Press "OK"

Press *F5* to run the client.

h2. Running outside Visual Studio

Create a shortcut @R:\code\ryzom\bin\client_ryzom_r.exe@ inside @c:\ryzom_client@.

Edit the properties of the shortcut and be sure "Start in" point to @c:\ryzom_client@.

Double click on the shortcut.

This step is extremely important. It is not an option to use the "client_ryzom_r.exe" packaged with the client archive, since this is often outdated, and can cause [[ClientConnectErrors#None-of-the-accountscharacters-you-create-show-up-in-the-database|an annoying problem]].

h2. Connect on another shard

By default, the client will try to connect on @open.ryzom.com:40916@. But if you want to client to connect on another shard, add this line in @client.cfg@:

<pre>
StartupHost = "ip.of.your.server:40916";
</pre>

So it'll override the @StartupHost in the @client_default.cfg that is :

<pre>
StartupHost = "open.ryzom.com:40916";
</pre>

h2. Create a user account

To create a user account, run the client, fill login/password and click 4 times on connect.
Validate the popup you will get.
The account is created.

h2. Client Errors and Known Issues

There is a good chance you'll come across an error or two. If you find one, visit the Page detailing client connect errors [[ClientConnectErrors|client connect errors]].

NOTE for the legacy client:

1) You'll need to add the following lines to your client cfg for now:
<pre>
TexturesInterface = "texture_interfaces_v3";
TexturesInterfaceDXTC = "texture_interfaces_dxtc";
</pre>

If you have issues with icons missing in the game. This is the reason.

2) There are missing textures in the current client archive related to the login screen. You'll notice a grey screen at 2 points while running the client. This should be remedied eventually with update of the client archive.

You can unpack client\data\interface.bnp, copy launcher_bg.dds to launcher_bg_0.dds and launcher_bg_1.dds and repack using bnp_make.

3) Before your client will connect to your newly built server, you'll need to update 2 XML files that it uses for communication.

In your c:\ryzom_client\data directory create a new directory called data_common

Copy database.xml and msg.xml from \ryzom\code\ryzom\common\data_common\ and place into your c:\ryzom_client\data\data_common directory.

You can unpack client\data\data_common.bnp instead, replace the two files and repack using bnp_make.

These steps will not be needed eventually.