Common.dat

The master configuration file. Defines who this GameServer is, how it reaches the other services, and every server-wide gameplay rule. Loaded first at startup; every other .dat file layers on top.

File Location#

GameServer/Data/GameServerInfo - Common.dat

All keys live under the single section [GameServerInfo]. Changes require a GameServer restart.

Account Level (AL0-AL3)#

Many keys come in groups of four with _AL0, _AL1, _AL2, _AL3 suffixes. Each suffix maps to a VIP tier read from the account's stored AccountLevel:

If VIP is disabled for the server, keep all four suffixes equal to the _AL0 value.

Server Settings#

Performance#

Neither key ships in the default Common.dat. Add the line to change it. Both are read once at startup.

Connection Settings#

This GameServer's public IP must appear in DataServer's and JoinServer's AllowableIpList.txt.

Server Manager Control Settings#

The control channel lets the Axiom Server Manager see this GameServer's status and logs and send it commands (notice, kick, start events, graceful shutdown). None of these keys ship in the default Common.dat. Add the lines to change them. Read once at startup.

Log Settings#

Each flag toggles one log category. Logs are written to the GameServer working directory.

Set to 0 to suppress that category. Logs rotate daily.

Hack Settings#

Server-side validators run on the potion use and movement paths. Not all of them disconnect - see the Action column.

Common Settings#

Elemental jewelry levels#

JewelryLevelEnable and JewelryLevelMax control the level an elemental ring or pendant may carry. That level is what makes the item's resistance do anything: the resistance granted is the item's *Res value multiplied by its level, so a +0 ring grants nothing no matter how its *Res columns are set in Item.xml.

Resistance translates into a chance to nullify the matching elemental effect:

Movement / Warp Level Requirements#

The per-destination level requirements themselves live in Gate.txt and Move.txt; this key only decides whether the three special classes get a discount on them.

PC Point Currency#

Monster Settings#

Health Bar#

PK Settings#

Trade Settings#

Personal Shop Settings#

Duel Settings#

Guild Settings#

Elf Buffer Settings#

Controls Elf Soldier buff caps and formula constants. Four-tier keys apply per-account-level (see Account Level).

Experience Settings#

All rates are per-mille (out of 1000). 1000 = 1x, 2000 = 2x. Each group has four _AL0-3 keys.

Monster Kill EXP Formula#

The base EXP a monster gives before any rate above is applied. Defaults equal the vanilla formula, so leaving them alone changes nothing.

The party bonus uses the party's average level. Older builds used the killer's level for every member.

Death Penalty#

Dying to a monster costs EXP. Never zen and never items. On by default.

EXP never drops below the start of the current level, so nobody loses a level. No penalty for PvP deaths (killed by a player or a player's summon), event maps (Blood Castle, Devil Square, Chaos Castle, Illusion Temple, Doppelganger, Imperial Guardian, Custom Arena), or Crywolf during the battle. The player sees a notice and the new EXP arrives with the respawn.

Item Drop Settings#

Money Drop Settings#

Monster Stat Multipliers#

All percentages. 100 = unchanged, 200 = 2x, etc.

Monster Hit Damage Reset Settings#

Controls the damage credit table, which decides who owns a monster's drop and EXP. This is not aggro — clearing it does not make a monster stop chasing.

Monster Leash Settings#

Vanilla MU has no leash. Once a monster is aggroed, ActionState.Emotion is set and the wander-radius check is skipped entirely, so the monster can be dragged across the whole map. Aggro also re-arms every time the target is re-found in view range, so a kiting player drags it indefinitely. When aggro finally lapses, the monster stands frozen wherever it stopped, because its wander targets are still measured from its spawn tile and all of them now fail.

Leave MonsterLeashHealOnReturn at 1: without it a player can tag a monster, drag it past the leash, and still own the drop when someone else finishes the healed monster.

If the spawn tile turns out to be unreachable (walled off, built over), the walk home is abandoned after 30 seconds and the monster resumes normal behaviour where it stands. The original spawn tile is restored on death like always.

Why the distance is relative#

MonsterLeashDistance is added to the monster's own wander radius; it is not an absolute distance from spawn. That radius is the per-spawn Dis in Data/Monster/MonsterSetBase/*.xml, or 30 for invasion-spawned monsters.

Dis is wildly inconsistent across the spawn files:

An absolute leash would have to exceed 30 to avoid firing on Dis="30" spawns during normal wandering, which would make it nearly useless on the Dis="05" spawns that make up most of the classic maps. Relative gives every spawn the same chase room: with the suggested 15, a Dis="05" spawn leashes at 20 tiles and a Dis="30" spawn at 45.

Invasions#

Invasion monsters (InvasionManager) are spawned outside MonsterSetBase and get WanderRange 30, or the boss ClusterRadius when the invasion uses cluster mode. They are leashed like anything else, measured from the random tile each one spawned on. With 15 an invasion mob gives up 45 tiles from where it appeared; cluster trash gives up at ClusterRadius + 15, so a tight ClusterRadius also tightens that invasion's leash.

Not affected#

These keep vanilla behaviour entirely:

• NPCs, guards and traps (Dis="00", no wander radius)
• Stationary monsters (MoveRange 0)
• Summons (Attribute 100) and monster-summoned adds
• Every monster on Blood Castle, Chaos Castle, Devil Square, Kalima, Illusion Temple, Doppelganger, Imperial Guardian and Castle Siege maps - those events need monsters to chase players anywhere on the map

The event-map exclusion is by map number, not by spawn type. Blood Castle, Chaos Castle and Devil Square monsters are ordinary MonsterSetBase entries carrying Dis="30", so nothing else would have caught them.

Advanced Money Drop Settings#

Chooses how the base zen amount for a monster kill is derived. Player bonuses are applied on top of whichever base is used.

Full order of operations:

base   = MoneyValue > 0 ? (MoneyValue * MonsterLevel)
                        : (MonsterZen * MoneyAmountDropRate / 100)
amount = base * PlayerZenBonus% / 100     <- item options, item implicits, master skill tree
amount = amount * (100 + CatchUpBonus%) / 100

Item Durability Settings#

Percentage of baseline durability consumed. 100 = normal, 200 = items break twice as fast, 50 = half rate.

Trade Item Block Settings#

Each flag blocks a category from being traded when 1.

Level Up Settings#

Create Character Settings#

Controls which advanced classes can be created and the prerequisites. Each advanced class (MG, DL, SU, RF) has four keys: a master CreateType, plus per-tier CreateLevel_AL0-3, CreateReset_AL0-3, and CreateMasterReset_AL0-3.

Valid class prefixes: MG, DL, SU, RF.

Shield Gauge Settings#

Master Skill Tree Settings#

Gens System Settings#

Faction-vs-faction contribution system.

Helper Settings (MuHelper)#

HelperMaxLevel, HelperExpRate, OffAttackMinLevel, and OffAttackMaxLevel are the four server-wide fallbacks for the per-map MuHelper and Offline Mode limits. When a map in MapManager.xml sets one of these attributes to *, the value here is used for that map. See that page for the per-map overrides.

MuHelper Offline Bridge#

When a player ticks the OffLine checkbox in the MuHelper window and then presses Start, the server skips the normal helper billing loop and instead transitions the character directly into the same offline-attack mode used by the /offattack chat command.

Flow:

1. Player ticks the OffLine box and configures their primary attack skill in the MuHelper window. Closing the window saves the config to DataServer.
2. Player presses Start on MuHelper.
3. If the OffLine flag is set and the location allows it, the server starts custom-attack mode using the player's primary MuHelper attack skill, switches it to offline, and signals the client to fully exit the process (not just disconnect to the login screen). The character keeps attacking server-side until killed or the time limit runs out. Helper itself never runs - no Zen billing, no client-side helper logic.
4. If the OffLine flag is set but the location does not allow offline-attack (safezone, event map, trade/duel, no skill resolved), the server emits a chat notice and the helper does not start - the player stays online and must untick the box (or move to a valid map) before pressing Start again.
5. If the OffLine flag is not set, Start behaves normally: helper billing kicks in, client runs MuHelper.

Stop on MuHelper always behaves normally (stops helper). It is not part of the offline bridge.

On reconnect: the auto-resume entry written when offline-attack starts is force-cleared by the bridge, so when the player relaunches the client and logs back in, the offline attack stops and the character is back to a clean online state. This differs from /attack followed by /offattack chat commands - the chat-command path leaves auto-resume intact (per the existing /offattack behavior).

Restrictions inherited from /offattack:

• Map must allow custom attack (MapManager.xml Attack flag).
• Character must not be in safezone, trade, duel, or any event map (Chaos Castle, Doppelganger, Blood Castle, Crywolf, Illusion Temple, Deathmatch Arena, Doppelganger, Imperial Guardian).
• Character must have at least one valid attack skill (the primary MuHelper attack skill, falling back to the class default).

What carries over from MuHelper#

Built-in defaults (what offline mode does on its own)#

These run server-side regardless of MuHelper config, driven by the CustomAttack* keys. Most live in this file; the auto-potion cooldown lives in Custom.dat:

The hardcoded class buffs (when autobuff is enabled by chat command, not the bridge) cycle through:

• Elf: Infinity Arrow, Greater Defense, Greater Damage, Heal
• DW / DK / DL / SU / RF: class-specific class buffs (Soul Barrier, Swell Life, Greater Critical Damage, Damage Reflection / Berserker, Ignore Defense / Increase Health / Increase Block)

Disabling offline mode#

Recommended: use OffAttackSwitch=0 for a single-key global lockout - it's the only gate that blocks both entry points (chat command and MuHelper bridge) cleanly. When the bridge cannot proceed, it sends a chat notice and the helper does not fall back to online mode - the player must untick the OffLine box to start the helper online.

Cash Shop Settings#

Event Inventory and Mu Rummy#

Party Settings#

Party XP distribution for party sizes 1-5. A party never has more than 5 members.

Potion Settings#

Per-potion restore rates, percent of max pool.

Transformation Ring Settings#

Map slots 1-6 to a transformation item index. Values are item subtypes in the Miscellaneous item category.

Jewel Settings#

Success rates (percent) for jewel and stone operations. Each group has four _AL0-3 keys.

Fruit Settings#

Stat point redistribution via fruits. _AL0-3 rate keys of -1 mean the engine uses built-in formulas.

HP Bonus System#

Grants bonus HP per master reset.

Bonus HP = master resets x HpBonus_ALn, cut down to HpBonus_MAX. The shipped cap of 1 makes the system almost do nothing (at most +1 HP). Raise HpBonus_MAX to use it.

Die System#

Chat announcements on death.

Online User System#

Experience Message#

Pushback Effects#

Each flag removes the push/fall animation triggered by the named skill when 1.

Wing Class Mix Restrictions#

Per-class blocks on wing creation in the Chaos Machine.

PK Event Access#

PK Item Drop#

Controls item drops from PKed characters.

Disconnect Online Account#

Castle Siege Skills#

Combo System#

EnableComboToAllSwitch remains the master toggle. The CustomCombo plugin (Data/Plugins/Characters/CustomCombo.xml) extends the system by defining which skills count as primary and secondary in a combo for the classes that unlock it. CustomCombo does not shadow this switch; a class with combos disabled here stays without combos regardless of plugin content.

Online Rewards#

Periodic zen / coin rewards for connected players. OnlineRewardOfflineSystems = 1 extends this to offline accounts. Coin1 = WC, Coin2 = WP, Coin3 = GP.

Skill Timing / Attack Speed#

Global attack speed formula for every skill. Server is authoritative; client display is cosmetic.

delay = max(MinSkillDelay, BaseSkillDelay * 1000 / (1000 + speed * SpeedGrowthFactor))
APS   = (1000 + speed * SpeedGrowthFactor) / BaseSkillDelay

At the shipped defaults, stat speed caps at 290 (130 ms delay, 7.69 casts/sec) and bonuses may carry a character to 340.

Cross-File Dependencies#

Common Issues#

• Stuck at "Loading files..." - LicenseKey empty or invalid
• Port in use - ServerPort conflicts with another process or a previous crashed instance
• Duplicate "GameServer online/offline" in ConnectServer log - ServerCode matches another running GameServer
• Players report wrong server name - ServerName mismatch with what ConnectServer's ServerList.xml advertises
• VIP users get the same rates as free accounts - _AL1/_AL2/_AL3 keys all set to the same value as _AL0
• Players rubber-banded or disconnected for moving too fast - check the hack log for [MoveSpeed] lines; raise MoveSpeedGuardTolerance/MoveSpeedGuardSlack, or set MoveSpeedGuardMode to 1 (log-only) while you look into it
• Cannot create Rage Fighter - RFCreateLevel_AL* set to 250 (known bug)
• Castle Siege schedule does nothing - EnableCastleSiege = 0