Run Client On Windows¶

We supposed you have finish the 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, before run your own client, you can use the pre-build client execute file to confirm whether your shard is okay. Then if your client meets problem, you know it isn't your shard's fault. Pre-build client here:
https://docs.google.com/leaf?id=0B3LX3q7MsUEGNDU5MDIzNWQtZmFhMi00ZGFmLTg0NzgtZjE4NTkwYjhjOGJh

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

Data¶

The Mercurial repository doesn't contains all big data like textures, 3d objects... so you need first to "Download the client archive".

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:
https://docs.google.com/leaf?id=0B3LX3q7MsUEGN2UwMGY3MjAtYzlmZS00Yjg4LTljYTgtNDA3MmFiNWQ1Nzg5

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.

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.

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 an annoying problem.

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:

StartupHost = "ip.of.your.server:40916";

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

StartupHost = "open.ryzom.com:40916";

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.

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 client connect errors.

NOTE for the legacy client:

1) You'll need to add the following lines to your client cfg for now:

TexturesInterface = "texture_interfaces_v3";
TexturesInterfaceDXTC = "texture_interfaces_dxtc";

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.