MangosD Configuration Guide

What is mangosd.conf?

The mangosd.conf file is the main configuration file for a Massive Network Game Object Servers (MaNGOS) server. It contains settings that control how the server operates, including server name, rates, logging, and more.

Think of it as the control center for your emulator server: if you need to tweak gameplay rates or game data, you’ll find the relevant settings here.

Example Configuration

The mangosd.conf is made available in the predefined git repositories, set alongside a docker compose compose.yaml. These are "mounted" into the containers, making the configuration files available to the server.

Below is a basic example of how the mounting of the mangosd.conf file into a Docker Compose container works:

services:
  mangos:
    image: thoriumlxc/mockserver:2025.01.01
    volumes:
      - ./mangosd.conf:/opt/mangos/mangosd.conf
    # Additional environment variables or configurations can go here

This works by being relative to the path of the compose.yaml file. So, if your file is located at /some/path/to/file/compose.yaml, then your file would be next to it within the same directory at /some/path/to/file/mangosd.conf.

.
├── compose.yaml
├── mangosd.conf
├── README.md
└── realmd.conf

For Windows

On Windows, these paths will be in the form of C:\some\path\to\file\, as Windows uses \ and MacOS/Linux use / for indicating paths. Most likely your path is somewhere in your home directory like C:\Users\LocalUser\ThoriumLXC.

Configuration Options

Here are the settings from the mangosd.conf file.

Configuration Key	Description
RealmID	RealmID must match the realmlist inside the realmd database.
DataDir	Data directory setting. Important: DataDir needs to be quoted, as it is a string which may contain space characters. Example: "/opt/mangos/share/mangos".
LogsDir	Logs directory setting. Logs dir must exists, or all logs need to be disabled. Default: "" - no log directory prefix.
LoginDatabaseInfo	Database connection settings for the world server. See details for MySQL and PostgreSQL formats.
WorldDatabaseInfo	Database connection settings for the world server.
CharacterDatabaseInfo	Database connection settings for the world server.
LogsDatabaseInfo	Database connection settings for the world server.
LoginDatabaseConnections	Amount of connections to database used for SELECT queries. Maximum 16 connections per database. Default: 1 connection for SELECT statements.
WorldDatabaseConnections	Amount of connections to database used for SELECT queries. Maximum 16 connections per database. Default: 1 connection for SELECT statements.
CharacterDatabaseConnections	Amount of connections to database used for SELECT queries. Maximum 16 connections per database. Default: 1 connection for SELECT statements.
LogsDatabaseConnections	Amount of connections to database used for SELECT queries. Maximum 16 connections per database. Default: 1 connection for SELECT statements.
MaxPingTime	Settings for maximum database-ping interval (minutes between pings).
WorldServerPort	Port on which the server will listen.
BindIP	Bind World Server to specific IP address. Useful for running multiple worldd/realmd instances.
SD2ErrorLogFile	Log File for SD2-Errors.
UseProcessors	Used processors mask for multi-processors system (Used only at Windows). Default: 0 (selected by OS).
ProcessPriority	Process priority setting (Used only at Windows). Default: 1 (HIGH).
Compression	Compression level for update packages sent to client (1..9). Default: 1 (speed).
PlayerLimit	Maximum number of players in the world. Excluding Mods, GM's, and Admins. Default: 100.
SaveRespawnTimeImmediately	Save respawn time for creatures at death and for gameobjects at use/open. Default: 1.
MaxOverspeedPings	Maximum overspeed ping count before player kick. Default: 2.
GridUnload	Unload grids. Default: 1 (unload grids).
LoadAllGridsOnMaps	Load grids of maps at server startup. Default: "" (don't load all grids at startup).
Autoload.Active	Load active creatures. Default: True.
GridCleanUpDelay	Grid clean up delay in milliseconds. Default: 300000 (5 min).
MapUpdateInterval	Map update interval in milliseconds. Default: 100.
ChangeWeatherInterval	Weather update interval in milliseconds. Default: 600000 (10 min).
PlayerSave.Interval	Player save interval in milliseconds. Default: 900000 (15 min).
PlayerSave.Stats.MinLevel	Minimum level for saving character stats for external usage in database. Default: 0.
PlayerSave.Stats.SaveOnlyOnLogout	Enable/Disable saving of character stats only on logout. Default: 1.
vmap.enableLOS	Enable/Disable VMaps support for line of sight calculation. Default: 1 (enable).
vmap.enableHeight	Enable/Disable VMaps support for height calculation. Default: 1 (enable).
vmap.enableIndoorCheck	Enable/Disable VMap based indoor check to remove outdoor-only auras. Default: 1 (Enabled).
DetectPosCollision	Check for visible collision with other objects. Default: 1 (enable).
mmap.enabled	Enable/Disable pathfinding using mmaps. Default: 1 (enable).
mmap.ignoreMapIds	Disable mmap pathfinding on the listed maps.
mmap.preload	Enable/Disable preloading on first mapId load. Default: 0 (disable).
PathFinder.OptimizePath	Use or not path finder path optimization. Default: 1 (enable).
PathFinder.NormalizeZ	Correct calculated path points Z. Default: 0 (disable).
UpdateUptimeInterval	Update realm uptime period in minutes. Default: 10 (minutes).
MapUpdate.Threads	Number of threads to use for maps update. Default: 3.
MaxCoreStuckTime	Periodically check if the process is stuck. Default: 0 (Disabled).
AddonChannel	Permit/disable the use of the addon channel through the server. Default: 1 (permit addon channel).
CleanCharacterDB	Perform character db cleanups on startup. Default: 1 (Enable).
LogSQL	Enable logging of GM commands. Default: 1 (Write SQL code to logfile).
PidFile	World daemon PID file. Default: "" (do not create PID file).
LogLevel	Server console level of logging. Default: 3 (Full/Debug).
LogTime	Include time in server console output. Default: 0 (no time).
LogFile	Logfile name. Default: "Server.log".
PacketLogFile	Binary packet logging file for the world server. Default: "" (Disabled).
LogTimestamp	Logfile with timestamp of server start in name. Default: 0 (no timestamp in name).
LogFileLevel	Server file level of logging. Default: 0 (Minimum).
WorldLogFile	Packet logging file for the worldserver. Default: "" (no log file created).
DBErrorLogFile	Log file of DB errors detected at server run. Default: "DBErrors.log".
EventAIErrorLogFile	Log file of EventAI errors detected at server run. Default: "EventAIErrors.log".
CharLogFile	Character operations logfile name. Default: "Char.log".
GmLogFile	GM Log file of GM commands. Default: "" (Disable).
GmLogTimestamp	GM Logfile with timestamp of server start in name. Default: 0 (no timestamp in name).
GmLogPerAccount	GM Logfiles with GM account id. Default: 0 (add GM log data to single log file).
RaLogFile	Log file of RA commands. Default: "Ra.log".
LogColors	Color for messages. Default: "" (none colors).
GameType	Server realm style. Default: 1 (PVP).
RealmZone	Server realm zone. Default: 1 (Development).
DBC.Locale	DBC Language Settings. Default: 255 (Auto Detect).
StrictPlayerNames	Limit player name to language specific symbols set. Default: 0 (disable).
MinPlayerName	Minimal name length. Default: 2.
CharactersCreatingDisabled	Disable characters creating. Default: 0 (enabled).
MaxPlayerLevel	Max level that can be reached by a player for experience. Default: 60.
StartPlayerLevel	Starting level of character. Default: 1.
StartPlayerMoney	Starting money for new players. Default: 0.
MaxHonorPoints	Max honor points a player can have. Default: 75000.
StartHonorPoints	Starting honor points for new players. Default: 0.
MaintenanceDay	The day of the week for server maintenance. Default: 3 (Wednesday).
InstantLogout	Enable or disable instant logout for security level. Default: 1 (Mods/GMs/Admins).
DisableWaterBreath	Enable or disable waterbreathing. Default: 4.
AlwaysShowQuestGreeting	Controls whether quest greetings are always shown. Default: 0 (disabled).
TaxiFlightChatFix	Workaround for client bug on taxi flight. Default: 0 (disabled).
MaxSpellCastsInChain	Max number of triggered spell casts in chain. Default: 20.
RabbitDay	Set to Rabbit Day (date in unix time). Default: 0 (off).
Instance.IgnoreLevel	Ignore level requirement to enter instance. Default: 0 (false).
Instance.IgnoreRaid	Ignore raid requirement to enter instance. Default: 0 (false).
Instance.ResetTimeHour	The hour of the day for global instance resets. Default: 4.
Instance.UnloadDelay	Unload instance map from memory after a set time. Default: 1800000 (30 minutes).
Instance.DisableRelocate	Disables player relocation after 15 minutes or instance reset. Default: 0 (false).
Quests.LowLevelHideDiff	Quest level difference to hide low level quests. Default: 5.
Quests.HighLevelHideDiff	Quest level difference to hide high level quests. Default: 7.
Group.OfflineLeaderDelay	Grace period for offline group leader to reconnect. Default: 300 (5 minutes).
Guild.EventLogRecordsCount	Count of guild event log records stored. Default: 100.
MaxPrimaryTradeSkill	Max number of primary trade skills a player can learn. Default: 2.
MailDeliveryDelay	Mail delivery delay for item sending. Default: 3600 sec (1 hour).
PetUnsummonAtMount	Permanent pet will unsummon at player mount. Default: 0 (not unsummon).
AutoDownrank	Automatically select correct rank when buffing/healing lower level players. Default: 0 (false).
BeepAtStart	Beep at mangosd start finished. Default: 1 (true).
ShowProgressBars	Show progress bars for load steps at server startup. Default: 0 (false).
WaitAtStartupError	Wait after startup error report. Default: 0 (not wait).
Motd	Message of the Day displayed at world login.
PlayerCommands	Should player chat be parsed for GM commands. Default: 1 (parse commands).