settings/default/map.lua file configures the xi_map process: game administration, zone behavior, combat math, mob tuning, crafting, and more. All values live under xi.settings.map.
Packet and SQL
Maximum time (in seconds) between packet updates before the server considers a connection stale.
Maximum retries when verifying a written server variable via
serverutils::PersistServerVar().Block and report packets that aren’t on the allow-list for a player’s current state.
Minimum number of 0x3A packets used to detect light-luggage exploits. Set to
0 to disable detection.Item handling
Leak item extdata to the client when moving items between inventory containers, matching retail behavior. Useful for edge cases like weapon skill points.
Enable the recycle bin so items are held briefly before permanent deletion. Set to
false for immediate drops.Self-unstuck
Enable the self-unstuck command, which sends the player to their homepoint via the Help Desk.
Cooldown in seconds between uses of the self-unstuck command. Default is 24 hours.
Auction house
Base fee in gil to list a single-item auction.
Base fee in gil to list a stacked auction.
Tax rate multiplier for single-item auctions.
Tax rate multiplier for stack auctions.
Maximum auction house fee in gil.
Maximum number of open listings per player.
0 removes the limit. Settings above 7 may require a client-side plugin.Enmity
Total enmity cap per entity on the enmity table. Approximately matches current retail. Lower values cause mobs to bounce between targets more easily.
Experience points
Experience point multiplier. Also influenced by the
conf setting.Multiplier for experience points lost on death.
Fraction of experience normally lost that is retained on death.
0 = full loss, 1 = no loss.Minimum level at which experience can be lost on death.
Apply experience penalties for wide level gaps within a party.
Level difference threshold above which a party member receives zero experience.
0 disables nullification regardless of gap.Capacity point multiplier.
Level sync and gear
Enable Level Sync.
Prevent equipping higher-level gear while under a level cap or sync effect.
Time and world
Unix timestamp defining the Vana’diel time epoch.
0 defaults to the SE epoch (JP midnight 1 January 2002, timestamp 1009810800). Safe range: 1 to the current Unix timestamp.Minimum level at which a player loses regional Conquest influence on death. Level 5 and below never lose influence.
Movement speed
| Setting | Default | Description |
|---|---|---|
BASE_SPEED | 50 | Base player movement speed |
SPEED_LIMIT | 80 | Player movement speed cap |
MOUNT_SPEED | 80 | Mount speed (can exceed SPEED_LIMIT) |
ANIMATION_SPEED_DIVISOR | 1.0 | Player movement animation speed divisor — raise to increase animation speed |
MOB_RUN_SPEED_MULTIPLIER | 2.5 | Multiplier for engaged mob speed when their target is out of melee range |
Combat and skills
Fame gain multiplier. Use
0.25 for the older fame calculation.Multiplier for the constant in the skill-up rate formula. Significantly affects how often skills increase.
Multiplier for skill-up amounts. Values above
1 break the 0.5 cap, raising it to 0.9. Set to 5 for maximum skill-up amounts.Enable skill-ups from blood pacts.
Disable Treasure Hunter procs. Enable for era-accurate behavior.
Weapon skill point base (before skillchain bonus) for breaking a latent. Retail value is
5.Weapon skill points granted per skillchain level. Retail value is
2.Multiplier for ability recast timers.
Enable a shared recast timer across all blood pacts.
Prevent players from performing weapon skills while unengaged via packet injection.
Parry, block, and guard skill-up style
| Setting | Default | Description |
|---|---|---|
PARRY_OLD_SKILLUP_STYLE | false | Require the action to fully resolve for a parry skill-up |
BLOCK_OLD_SKILLUP_STYLE | false | Require the action to fully resolve for a block skill-up |
GUARD_OLD_SKILLUP_STYLE | false | Require the action to fully resolve for a guard skill-up |
Mob settings
HP and MP multipliers
Valid range:0.1 to 2.0.
| Setting | Default | Applies to |
|---|---|---|
NM_HP_MULTIPLIER | 1.0 | Named monsters |
MOB_HP_MULTIPLIER | 1.0 | Regular mobs |
ALTER_EGO_HP_MULTIPLIER | 1.0 | Trusts and fellows |
NM_MP_MULTIPLIER | 1.0 | Named monsters |
MOB_MP_MULTIPLIER | 1.0 | Regular mobs |
ALTER_EGO_MP_MULTIPLIER | 1.0 | Trusts and fellows |
Stat multipliers
Adjust base stats (STR, VIT, etc.). Valid range:0.1 to 2.0.
| Setting | Default | Applies to |
|---|---|---|
NM_STAT_MULTIPLIER | 1.0 | Named monsters |
MOB_STAT_MULTIPLIER | 1.0 | Regular mobs |
ALTER_EGO_STAT_MULTIPLIER | 1.0 | Trusts and fellows |
ALTER_EGO_SKILL_MULTIPLIER | 1.0 | Trust and fellow skill caps |
TP multipliers
| Setting | Default | Applies to |
|---|---|---|
MOB_TP_MULTIPLIER | 1.0 | Regular mobs |
PET_TP_MULTIPLIER | 1.0 | Pets (including charmed) |
PLAYER_TP_MULTIPLIER | 1.0 | Players |
TRUST_TP_MULTIPLIER | 1.0 | Trusts |
FELLOW_TP_MULTIPLIER | 1.0 | Fellows |
Drop rates and gil
Global mob drop rate multiplier.
Multiplier for gil naturally dropped by mobs. Does not affect the
ALL_MOBS_GIL_BONUS bonus.Extra gil per mob level dropped by every mob, even those with no natural gil drop.
Maximum bonus gil that can be dropped. Default is 9,999 gil.
Despawn behavior
Allow mobs to walk back to their home position instead of despawning after losing aggro.
Extra seconds added to the mob de-aggro timer. Base timer is 25 seconds.
Subjobs
Divisor controlling how much MP a subjob provides. Retail is half, so default is
2.Subjob-to-main-job level ratio.
0 = no subjob, 1 = 1/2 (retail default: 75/37, 99/49), 2 = 2/3, 3 = equal levels.Apply
SUBJOB_RATIO adjustments to monster subjobs as well.Crafting
Multiplier for the skill-up chance formula in crafting.
Multiplier for crafting skill-up amounts.
Use current retail skill-up rates and margins. Retail allows skill-ups at or under 10 levels above the recipe level.
Craft level at which specialization points begin to count. Retail =
700; Level 75 era = 600.Points available for crafts above
CRAFT_COMMON_CAP. Retail = 400. Setting all skills to max requires 3200.Multiplier for high-quality craft chance.
Gardening
By default all gardening factors are disabled to match retail behavior. Only change these if you have verifiable proof that retail uses them.| Setting | Default |
|---|---|
GARDEN_DAY_MATTERS | false |
GARDEN_MOONPHASE_MATTERS | false |
GARDEN_POT_MATTERS | false |
GARDEN_MH_AURA_MATTERS | false |
Fishing
Enable all fishing functionality, including quests. Enable at your own risk.
Minimum character level required to fish.
Multiplier for fishing skill-up chance. Default is very hard to skill up.
Battlefields
Adjust all battlefield level caps by this many levels globally.
Enable level caps stored in the database for mission battlefields.
Allow players to enter BCNMs flagged as experimental.
Maximum merit points a player can hold. Classic era is
10; Abyssea era is 30.Healing
Seconds between healing ticks while resting.
Pets
Keep jug pets when the player zones.
Despawn jug pets whose minimum summon level exceeds the zone’s level restriction. Note: this is retail-accurate but raises balance concerns (e.g., 1000 Needles at low level).
Chat and audit
Minimum seconds between uses of the
/yell command.Prevent players from sending
/tell to a hidden GM. GMs can still receive tells from other GMs.Log GM commands to the audit log. Commands issued to non-GMs are never logged.
Chat audit
Each channel can be audited independently:| Setting | Default | Channel |
|---|---|---|
AUDIT_CHAT | false | All chat (global toggle) |
AUDIT_SAY | false | /say |
AUDIT_SHOUT | false | /shout |
AUDIT_TELL | false | /tell |
AUDIT_YELL | false | /yell |
AUDIT_LINKSHELL | false | Linkshell |
AUDIT_UNITY | false | Unity chat |
AUDIT_PARTY | false | Party chat |
AUDIT_BALLISTA | false | Ballista |
AUDIT_ASSISTE | false | Assist channel (English) |
AUDIT_ASSISTJ | false | Assist channel (Japanese) |
Item transaction audit
| Setting | Default | What is logged |
|---|---|---|
AUDIT_PLAYER_TRADES | false | Player-to-player trades |
AUDIT_PLAYER_BAZAAR | false | Bazaar purchases |
AUDIT_PLAYER_DBOX | false | Delivery box transactions |
AUDIT_PLAYER_VENDOR | false | NPC vendor purchases |
Error reporting
Minimum GM level required to receive Lua stack traces in-game after a caught error. The max GM level is
5, so the default of 6 disables this for everyone. Set to 0 to enable for all players.Calculate auto attack damage in Lua instead of C++.