From Project: Ouroboros
Jump to navigation Jump to search

servers.cfg is the main configuration file for the dbserver. Other components load the file as well, including the launcher, arenaserver, raidserver, and statserver.

The directives in the file are used to populate the global ServerCfg configuration. Directive names are also case-insensitive. Lines with a leading # are ignored.

Configuration directives

servers.cfg is a list of config options, one per line. If a config option is repeated, the last one in the file overrides all others. Each line has several words, separated by spaces or tabs. If there are extra words on the end of the line, they are ignored. Spaces can be included in a word by surrounding it with double quotes.

Anywhere that DNS names are used, IP addresses can be used instead.


DBServer <ip>

The DNS name of the dbserver. This is used by other components to determine where to connect.

DBServer<n> <ip>

Auxiliary dbservers. Launchers can connect to multiple dbservers; more servers are specified as DBServer2, DBServer3, etc.

ShardName <name>

The name of the shard this dbserver manages. This must match a shard name in turnstile_server.cfg.

LocalIp <ips...>

Local IP addresses. If an address matches the top two octets of any address specified here, the dbserver considers it local. What is this actually for?

AdvertisedIp <ip>

Force mapservers to advertise this IP address to clients rather than what the mapserver wants. This is useful for NATed servers.

This really shouldn't be in servers.cfg. It belongs in individual launcher configurations instead.

NoStats <1/0>

Disable the statserver; have the launcher send -nostats to mapservers.

ChatServer <ip>

Set the IP address of the chatserver.

ClientCommands "<commands>"

A list of commands to be executed by the client upon connection. See Client-to-dbserver#DBGAMESERVER_SEND_PLAYERS.

Locale <name>

The locale of the shard. This must either be a locale name or 0 (in which case English is chosen). Possible values are:

en: English
test: Test locale
zh: Chinese
ko: Korean
ja: Japanese
de: German
fr: French
es: Spanish

IsBetaShard <1/0>

Whether or not this shard is a beta shard. On beta shards, users can use the broken mission fix every 10 minutes, rather than every 3 days.

IsVIPShard <1/0>

Whether or not this shard is a VIP shard. Only accounts marked as VIP can log into this shard.

MARTYEnabled <1/0>

Enable/disable the MARTY anti-cheat.

ForceOverloadProtection <1/0>

Forces overload protection to be enabled.

OverloadProtection_LauncherHighWaterMarkPercent <decimal>

Launcher upper bound for overload protection. When the percentage of launchers that cannot launch a server rises above this percentage, engage overload protection.

OverloadProtection_LauncherLowWaterMarkPercent <decimal>

Launcher lower bound for overload protection. When the percentage of launchers that cannot launch a server drops below this percentage, disengage overload protection.

OverloadProtection_SQLQueueHighWaterMark <n>

SQL upper bound for overload protection. When the size of the SQL queue grows larger than this, engage overload protection.

OverloadProtection_SQLQueueLowWaterMark <n>

SQL lower bound for overload protection. When the size of the SQL queue drops below this, disengage overload protection.


SqlDbProvider <prov>

The SQL database type. The supported configurations are mssql and postgresql, but only MSSQL is properly tested on i24.

SqlDbName <db>

The name of the dbserver database. Most common name is cohdb.

SqlLogin <connstring>

The connection string for the database connection. Example:

SqlLogin "DRIVER={SQL Server Native Client 11.0};Server=localhost\SQLEXPRESS;Uid=sa;Pwd=YourL33TPASS!;"

SqlInit <query>

An SQL query to initialize the dbserver database for the first time. If SqlDbName is cohdb, this could be:

SqlInit "CREATE DATABASE cohdb;"

SqlAllowDDL <1/0>

Enable or disable the use of DDL for manipulating the database. This is the master switch for all of the related SQL directives. DDL must be enabled in order to perform many operations for altering the database schema. If a required DDL command is not allowed, the server will exit.

SqlAllowAllDDL <1/0>

Same as SqlAllowDDL.

SqlAddAttributes <1/0>

Allow the SqlAddAttributes DDL command.

SqlAddColumnOrTable <1/0>

Allow the SqlAddColumnOrTable DDL command.

SqlDeleteColumnOrTable <1/0>

Allow the SqlDeleteColumnOrTable DDL command.

SqlRebuildTable <1/0>

Allow the SqlRebuildTable DDL command. This has the same effect as setting SqlAllowDDL.

SqlAlterColumn <1/0>

Allow the SqlAlterColumn DDL command.

ChangeDbOwnerFrom <name>

Runs some kind of stored procedure. // requested by joe phillips

Auth & Queue

UseFakeAuth <0/1>

Enable fake auth. This lets clients log in directly to the dbserver (with any account) instead of going via an authserver.

AuthServer <ip> <port>

The DNS name and port to use when connecting to the authserver. Either this or UseFakeAuth must be present in the file.

UseQueueServer <1/0>

Enable or disable the use of the queueserver.

LoginsPerMinute <num>

Number of players that the queueserver is allowed to admit per minute. Default is 100.

BlockFreePlayersIfNoAccountServer <1/0>

Put F2P players in the queue if the account server is down. Presumably? clientcomm s_skipQueue

EnqueueWithAuthLimiter <1/0>

Let people into the shard even if we would queue them normally?

AuthnameLimiterEnabled <1/0>

This is associated with BlockFreePlayersIfNoAccountServer and EnqueueWithAuthLimiter, but I'm really not sure what it's for.

AuthnameLimiterAccessLevel <n>

Characters greater than this access level can bypass the auth limiter.

OverrideAuthBit <names...>

Force user authbits to be set regardless of the state in the database. The format is comma or space-separated authbit names; see authUserData.c:authUserSetFieldByName.

OwnsGoingRogue <1/0>

Set/unset the Going Rogue authbit. Only works on FakeAuth shards.

DefaultLoyaltyPointsFakeAuth <n>

Number of loyalty points automatically granted to FakeAuth accounts.

DefaultLoyaltyLegacyPointsFakeAuth <n>

Number of loyalty legacy points automatically granted to FakeAuth accounts. Legacy?

Players, Accounts & Characters

DefaultAccessLevel <n>

Set the access level of new characters. This should be 0 for any production system.

MaxPlayers <num>

The maximum number of players that can be connected at any time. The maximum value is AUTH_SIZE_MAX (8191):

#define AUTH_SIZE_MAX (((1<<14)/2)-1)	//so Auth server treats any number (1<<14) or bigger as being zero.  So we're saying that you
                                        //can't have a max size > 1<<13-1 so that you can have 1<<13 available for the queue.

MinPlayers <num>

Unsure about this. It's only ever sent to authserver when it queries how many are online, but that code is dead:

  if (server_cfg.min_players && 0 /*sqlFifoNearFull()*/)

MaxDualSlots <n>

Number of shared H/V character slots per player? Default is 12, maximum is 48.

BackupDays <days>

Number of days to keep stored backups (characters?) for. Minimum is 30 days.

OfflineProtectLevel <level>

Highest level of character that can be moved to offline storage. Default is 35. Probably?

OfflineIdleDays <days>

Number of days before a character is moved to offline storage.

XPScale <decimal>

Experience multiplier. Default is 1.0.

NameLockTimeout <n>

Number of seconds to keep character names temporarily reserved when performing a name lookup. This must be greater than the client refresh time, which is 600. Default is 1200.

Mapserver & beaconserver

MapServerParams "<params>"

Extra parameters to send to launched mapservers.

CompleteBrokenTasks <1/0>

Sends -completebrokentasks to launched mapservers. Document what this does.

DoNotLaunchMapServerTSR <1/0>

Don't launch any TSR mapservers. TSR mapservers preload data to shared memory to make loading other mapservers faster.

RaidTimeZoneDelta <decimal>

Difference in hours between the time on the mapserver and the dbserver. Default comes from the OS. This is sent from dbserver to mapserver, but doesn't seem used?

BlockedMapKey <maps...>

A comma delimited list of map keys to not load.

DisabledZoneEvents <events...>

A comma delimited list of disabled zone events.

MapserverIdleExit <n>

Shut down mapservers if they are idle for this many minutes. Default is 0 (idle shutdown is disabled). Keep in mind that maps without Transient in their maps.db entry will never shut down, even after being idle.

MapserverIdleUpkeep <n>

Number of minutes a mapserver must be idle before performing idle maintenance. Idle maintenance will attempt to minimize the memory footprint of the mapserver by compacting the working set. Default is 20 minutes.

MapserverDailyUpkeep <start> <end>

Specify an hour range (24-hour clock) for when to perform daily maintenance on static mapservers. Daily maintenance is disabled by default.

SendDoorsToAllMaps <1/0>

Whether door updates should be sent to all mapservers. This is a legacy behavior; by default, updates are only sent to static maps and supergroup bases, and not mission maps, raid maps and arena maps.

MasterBeaconServer <host>

Hostname for the master beaconserver.

DoNotLaunchMasterBeaconServer <1/0>

Don't launch the master beaconserver.

RequestBeaconServerCount <n>

Number of beaconrequestservers to launch. Negative values correspond to 2. Default is -1.

BeaconRequestCacheDir <dir>

Cache directory for requests made to the beaconservers. Probably.

DoNotLaunchBeaconClients <1/0>

Don't launch any beaconclients.

Logging & Metrics

LogDir <dir>

Set the log file directory. Default is logs inside the game data directory.

AssertMode "<modes>"

Set the behavior of assertion failures. Multiple modes can be specified if the argument is wrapped in quotes. Possible modes are:


Create minidumps (.mdmp) on failure.


Create full dumps (.dmp) on failure.


Exit on failure.


Don't name dump files with timestamps.


Same as NoTimestamp.


Zip the dump files.


Enable the ignore button on assertions.

UseLogServer <1/0>

Enable the logserver.

LogServer <ip>

Set the IP address of the logserver. This implies enabling the logserver.

LogRelayVerbose <1/0>

Enable verbose logging. Of what? Inter-server handover?

SetLogLevel <logtype> <level>

Set the log level of the various log types. This directive can appear multiple times. Possible levels are:


DISABLED; do not log anything.


ALERT; this is so important that someone should be notified.


IMPORTANT; only the most important information. Default value.


VERBOSE; information that we would like, but has the possibility of spamming the logs with too much data.


DEPRECATED; there are old things that are doubtful we should even be logging.


DEBUG; lots of information for debugging only.

Possible log types are listed below. They are case-insensitive.



Crash reports


Logs for debugging purposes. Usually temporary, while the bug is being tracked down.


Logs for the text journaling system


Errors we want to know about sent here


Log messages that are probably worthless are sent here, on the off-chance we still need them


Used to generate output from test clients


Packet logging



Proof they deleted their character


Players getting moved out of the db into text


Log users system specs when the connect to db


Overload protection messages


Proof they committed a character slot to a shard



General log of things on entities (no chat, powers, or rewards related)


Power Info (may be redundant since chat records lots of powers information)


Supergroup specific things


Player reported bugs




Egregious cheats sent here


Anything to do with player inventory should go here


Scripted zone event reward logs


Seems to be some special kind of bug report from the client.


Access level commands. These are commands with AccessLevel < ACCESS_DEBUG (9).


Internal commands. These are commands with AccessLevel >= ACCESS_DEBUG.


MARTY (anti-cheat system) logs.


Logs admin commands. Seems to mostly be used for logging the stuck mission complete function.


Performance logs


Log for duplicate message ids. Probably for duplicate localization string hashes.



Generic account log


Account transaction log



In depth arena event logs.



Auction log


Auction transaction log



Log for deleted/deleting arcs.


Generic missionserver logs.



Items of Power log.



Statserver log.



Turnstileserver log.

IsLoggingMaster <1/0>

If 1, this server will propagate the configured loglevels to all of the connected servers.

DroppedPacketLogging <1/0>

Log when packets are dropped or received out of order.

AuthBadPacketReconnect <1/0>

Extra verification on auth packets?

DiffDebug <1/0>

Possibly perform extra verification checks on containers? Sends -diffdebug to launched mapservers.

ContainerSizeDebug <1/0>

Possibly perform extra verification checks on containers?

MetricsEnabled <1/0>

Enable ZeroMQ metrics. Disabled by default.

MetricsIPAddress <ip>

IP address for the ZeroMQ instance.

MetricsPortNumber <port>

Port for the ZeroMQ instance.

MetricsMQType <n>

This is "the socket type of the metrics system's ZeroMQ connection".

MetricsHighWaterMark <n>

The high water mark of the ZeroMQ connection.


ClientProject <name>

Set the "registry name". This is used to construct the path to the Windows registry keys. Default is CoH.

MaxLevel <n>

Appears to be global max level for NPCs. It doesn't seem to be max level for characters, which you might think.

MaxCoHLevel <n>

NPC max level for blue zones?

MaxCoVLevel <n>

NPC max level for red zones?

DoNotPreloadCrashReportDLL <1/0>

Don't preload the crash report DLL.

DisableContainerBackups <1/0>

Disable on-disk container backups.

AuctionInvMaxLastLoginDays <n>

Auction entries for accounts that have not logged in in this many days are not sent. Default is 60.

MissionserverMaxSendQueueSize <n>

The maximum amount of bytes allowed in the send queue to the missionserver. Default is DB_MISSIONSERVER_MAX_SENDQUEUE_SIZE_DEFAULT (1000000).

MissionserverMaxSendQueuePublishSize <n>

The maximum amount of bytes allowed in the publish queue to the missionserver. Default is DB_MISSIONSERVER_MAX_SENDQUEUE_SIZE_DEFAULT (500000).

GoingRogueNagAndPurchase <1/0>

Show the nag dialogs and buy button for Going Rogue.

KarmaEventHistoryDays <1/0>

How many days of past karma event history to read on load. Default is 30.

DebugSendPlayersDelayMS <n>

When sending the list of characters to a client, delay the SQL query by this many milliseconds.















UseFakeAuth 1
DefaultAccessLevel 255
NoStats 1
MaxPlayers 300
AssertMode Fulldump
UseQueueServer 0
UseLogServer 0
OverrideAuthBit RogueAccess
KarmaEventHistoryDays 30
MapserverIdleUpkeep 20
MapserverIdleExit 20
FastStart 1
MaxPlayerSlots 1000
MaxDualSlots 1000
AuctionInvMaxLastLoginDays 1000
// BeaconMasterServer
RequestBeaconServerCount 0
BeaconRequestCacheDir "c:\beaconrequestcache"
DoNotLaunchBeaconClients 1
DoNotLaunchMapserverTSRs 0
AuthnameLimiterEnabled 0
AuthnameLimiterAccessLevel 20
SetLogLevel "Auction" -2
SetLogLevel "Chat" 1
SetLogLevel "Admin" -2
SetLogLevel "Bug" -2
SetLogLevel "CharSlotApply" -2
SetLogLevel "Debug" -2
SetLogLevel "Delete" -2
SetLogLevel "deletion" -2
SetLogLevel "entity" -2
SetLogLevel "Error" -2
SetLogLevel "cheaters" -2
SetLogLevel "MARTY" -2
SetLogLevel "Offline" -2
SetLogLevel "Powers" -2
SetLogLevel "Rewards" -2
SetLogLevel "SuperGroup" -2
SetLogLevel "SystemSpecs" -2
SetLogLevel "sze_rewards" -2
SetLogLevel "turnstile" -2
SetLogLevel "cmds" -2
SetLogLevel "internalcmds" 1
SqlDbProvider mssql
SqlDbName coh
SqlAllowDDL 1
SqlLogin "Driver={SQL Server Native Client 11.0};server=localhost;database=coh;trusted_connection=Yes;"
SqlInit 1