Configuration

From WCell Wiki

Config:RealmServer

Config:AuthServer

The configuration files are called "Config.xml" and located in the Binary folders:

• RealmServer: Run/RealmServer/{BuildMode}/Config.xml and
• AuthServer: Run/AuthServer/{BuildMode}/Config.xml

{BuildMode} stands for the mode in which WCell was built: Debug or Release The files are created automatically after the first run as of rev 665.

Contents 1 Database Settings 1.1 MySQL 1.2 Charsets and encoding 2 AddonDir 3 Autoexec

Database Settings

Yyou have to change two configuration Parameters in the Config-file of the AuthServer and/or RealmServer correspondingly:

• DBType
• DBConnectionString

You can find a list of all ConnectionString-formats of all Databases on http://www.connectionstrings.com/.

NOTE: All fields of the ConnectionString are case-sensitive NOTE: Make sure, it doesn't contain any leading/trailing spaces ( ), semicolons (;) or unwanted quotation marks (")

If WCell fails to start due to anything Database-related, make sure, that these settings are correct!

MySQL

in your Run\AuthServer\{BuildMode}\Config.xml file:

   <DBType>mysql5</DBType>
   <DBConnectionString>Server=SERVERADRESS;Port=3306;Database=AUTHDATABASE;CharSet=utf8;Uid=USER;Pwd=PASSWORD;</DBConnectionString>

in your Run\RealmServer\{BuildMode}\Config.xml file:

   <DBType>mysql5</DBType>
   <DBConnectionString>Server=SERVERADRESS;Port=3306;Database=REALMDATABASE;CharSet=utf8;Uid=USER;Pwd=PASSWORD;</DBConnectionString>

Replace:

• SERVERADDRESS: Address of the machine, which is running the database - eg. localhost
• AUTHDATABASE: Name of the database which you want to use for the AuthServer - default: WCellAuthServer
• REALMDATABASE: Name of the database which you want to use for the RealmServer - default: WCellRealmServer
• USER: The username to use to log into the SQL server with - e.g. root
• PASSWORD: The password of the user

Charsets and encoding

Make sure that:

• The CharSet parameter in the ConnectionString is lower-case! (Yes, connectionstrings.com says something different but the default .NET MySql connector lib (MySql.Data.dll) does not do ignore-case comparisons of charsets)
• The CharSet matches the DefaultCharset parameter

AddonDir

The directory from which Addons should be loaded.

Check out the Addons article for more information.

Autoexec

Both, Auth- and RealmServer have settings for Automatic execution of files on startup/player login. The RealmServer looks for these files in the Content folder: Run/RealmServer/Content/ The AuthServer looks for these files in the it's root directory: Run/AuthServer/{BuildMode}/

 <CommandHandler>
  <AutoExecDir>AutoExec</AutoExecDir>
  <AutoExecStartup>AutoExec/_Startup.txt</AutoExecStartup>
 </CommandHandler>