MapManager.xml

One entry per map. Controls PK mode, drop rates, experience scaling, MuHelper/custom-feature toggles, and the respawn gate used when a character dies on that map.

File Location#

Data/MapManager.xml

Loaded at GameServer startup. /reload common (or reload.common in the Server Manager) reloads it without a restart, with two limits: MaxItems is only read at startup, so changing it needs a restart; and the map display names sent to the client are not rebuilt by /reload common - run /reload plugins after it, then players relog to see new names.

Schema#

<MapList>
    <Map Index="..." Name="..." NonPK="..." PKLimit="..." PKLimitResetInterval="..."
         ViewRange="..." ExperienceRate="..." ItemDropRate="..."
         ExcItemDropRate="..." SetItemDropRate="..."
         SocketItemDrop="..." ExcOptionsRateIndex="..."
         HelperEnable="..." GensBattle="..."
         CustomAttack="..." PkDropItem="..." DeathGate="..."
         HelperMinLevel="..." HelperMaxLevel="..."
         HelperExpRate="..." HelperCostMultiplier="..."
         OffAttackMinLevel="..." OffAttackMaxLevel="..."
         OffAttackMaxTime="..." OffAttackExpRate="..." MaxItems="..."
         MonsterDamageRate="..." />
</MapList>

Ship every map you want players to reach. Maps without an entry fall back to the server-wide defaults (non-PK state from Common.dat, view range 15, experience and drop multipliers 100, all feature toggles 0, death gate 17).

Attributes#

Identity#

PK and Visibility#

Drop Rates#

All rates are out of 1,000,000 (one million). 10000 = 1%, 100000 = 10%, 1000000 = 100%.

Excellent Options Source#

ExcOptionsRateIndex picks which ItemOptionRate.xml index controls excellent option counts:

See ItemOptionRate.xml.

Feature Toggles#

Per-map MuHelper and Offline Mode limits#

Eight attributes tune MuHelper and offline-attack behavior per map. Set any of them to * to inherit the server-wide value. Level caps count combined level (character Level + Master Level); 0 on a max-level cap means no cap.

Four of these have a server-wide fallback key in Common.dat: HelperMaxLevel, HelperExpRate, OffAttackMinLevel, and OffAttackMaxLevel. HelperMinLevel falls back to HelperActiveLevel; HelperCostMultiplier and OffAttackExpRate fall back to 100; OffAttackMaxTime falls back to no per-map limit. Maps with no entry in this file also use these fallbacks.

Respawn#

Ground Items#

The shipped file does not set MaxItems, so every map uses 500. Raise it on maps where many drops pile up at once, such as dungeon or instance maps that hold every run's drops on one map.

Drop Rate Math#

Excellent and Set rolls use random(0, 999999); if roll < rate and monster level >= 25, drop is excellent/set.

Examples#

<Map Index="0"  NonPK="*" ViewRange="12"
     ExperienceRate="100" ItemDropRate="100"
     ExcItemDropRate="100000" SetItemDropRate="0"
     SocketItemDrop="0" ExcOptionsRateIndex="*"
     HelperEnable="1" GensBattle="0"
     CustomAttack="1"
     PkDropItem="1" DeathGate="17" Name="Lorencia"/>

<Map Index="11" NonPK="*" ViewRange="10"
     ExperienceRate="100" ItemDropRate="100"
     ExcItemDropRate="100000" SetItemDropRate="0"
     SocketItemDrop="0" ExcOptionsRateIndex="*"
     HelperEnable="1" GensBattle="0"
     CustomAttack="0"
     PkDropItem="0" DeathGate="22" Name="Blood Castle 1"/>

<Map Index="33" NonPK="*" ViewRange="12"
     ExperienceRate="100" ItemDropRate="100"
     ExcItemDropRate="100000" SetItemDropRate="0"
     SocketItemDrop="0" ExcOptionsRateIndex="100"
     HelperEnable="1" GensBattle="0"
     CustomAttack="1"
     PkDropItem="1" DeathGate="119" Name="Aida"/>

Cross-File Dependencies#

Common Issues#

• PK allowed on a town - NonPK="*" instead of "1". Safe-zone towns need the 1 value
• Excellent drops never happen - monster level is below 25; check monster definitions in Monster.xml
• Characters respawn in the wrong place - DeathGate points at the wrong gate index; check Gate.txt
• MuHelper works in Lorencia but not in an event map - event maps ship with HelperEnable="0" by design
• MuHelper or offline attack rejected on a specific map for high-level characters - HelperMaxLevel or OffAttackMaxLevel on that map (or its Common.dat fallback) is set below the character's combined level; use 0 for no cap
• PK blocked with a "try again" notice on one map - PKLimit on that map is reached for the player's IP; the window clears after PKLimitResetInterval ms (default 900000)
• Missing map produces invalid warp errors - every map the player can reach needs an entry; gaps in Index are allowed but the referenced map must exist