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
number
default:"60"
Maximum time (in seconds) between packet updates before the server considers a connection stale.
number
default:"3"
Maximum retries when verifying a written server variable via
serverutils::PersistServerVar().boolean
default:"true"
Block and report packets that aren’t on the allow-list for a player’s current state.
number
default:"4"
Minimum number of 0x3A packets used to detect light-luggage exploits. Set to
0 to disable detection.Item handling
boolean
default:"true"
Leak item extdata to the client when moving items between inventory containers, matching retail behavior. Useful for edge cases like weapon skill points.
boolean
default:"true"
Enable the recycle bin so items are held briefly before permanent deletion. Set to
false for immediate drops.Self-unstuck
boolean
default:"false"
Enable the self-unstuck command, which sends the player to their homepoint via the Help Desk.
number
default:"86400"
Cooldown in seconds between uses of the self-unstuck command. Default is 24 hours.
Auction house
number
default:"1"
Base fee in gil to list a single-item auction.
number
default:"4"
Base fee in gil to list a stacked auction.
float
default:"1.0"
Tax rate multiplier for single-item auctions.
float
default:"0.5"
Tax rate multiplier for stack auctions.
number
default:"10000"
Maximum auction house fee in gil.
number
default:"7"
Maximum number of open listings per player.
0 removes the limit. Settings above 7 may require a client-side plugin.Enmity
number
default:"30000"
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
float
default:"1.0"
Experience point multiplier. Also influenced by the
conf setting.float
default:"1.0"
Multiplier for experience points lost on death.
float
default:"0"
Fraction of experience normally lost that is retained on death.
0 = full loss, 1 = no loss.number
default:"31"
Minimum level at which experience can be lost on death.
boolean
default:"true"
Apply experience penalties for wide level gaps within a party.
number
default:"0"
Level difference threshold above which a party member receives zero experience.
0 disables nullification regardless of gap.float
default:"1.0"
Capacity point multiplier.
Level sync and gear
boolean
default:"true"
Enable Level Sync.
boolean
default:"false"
Prevent equipping higher-level gear while under a level cap or sync effect.
Time and world
number
default:"0"
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.number
default:"6"
Minimum level at which a player loses regional Conquest influence on death. Level 5 and below never lose influence.
Movement speed
Combat and skills
float
default:"1.00"
Fame gain multiplier. Use
0.25 for the older fame calculation.float
default:"1.0"
Multiplier for the constant in the skill-up rate formula. Significantly affects how often skills increase.
number
default:"1"
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.boolean
default:"true"
Enable skill-ups from blood pacts.
boolean
default:"false"
Disable Treasure Hunter procs. Enable for era-accurate behavior.
number
default:"5"
Weapon skill point base (before skillchain bonus) for breaking a latent. Retail value is
5.number
default:"2"
Weapon skill points granted per skillchain level. Retail value is
2.float
default:"1.0"
Multiplier for ability recast timers.
Enable a shared recast timer across all blood pacts.
boolean
default:"false"
Prevent players from performing weapon skills while unengaged via packet injection.
Parry, block, and guard skill-up style
Mob settings
HP and MP multipliers
Valid range:0.1 to 2.0.
Stat multipliers
Adjust base stats (STR, VIT, etc.). Valid range:0.1 to 2.0.
TP multipliers
Drop rates and gil
float
default:"1.0"
Global mob drop rate multiplier.
float
default:"1.0"
Multiplier for gil naturally dropped by mobs. Does not affect the
ALL_MOBS_GIL_BONUS bonus.number
default:"0"
Extra gil per mob level dropped by every mob, even those with no natural gil drop.
number
default:"9999"
Maximum bonus gil that can be dropped. Default is 9,999 gil.
Despawn behavior
boolean
default:"false"
Allow mobs to walk back to their home position instead of despawning after losing aggro.
number
default:"0"
Extra seconds added to the mob de-aggro timer. Base timer is 25 seconds.
Subjobs
float
default:"2.0"
Divisor controlling how much MP a subjob provides. Retail is half, so default is
2.number
default:"1"
Subjob-to-main-job level ratio.
0 = no subjob, 1 = 1/2 (retail default: 75/37, 99/49), 2 = 2/3, 3 = equal levels.boolean
default:"false"
Apply
SUBJOB_RATIO adjustments to monster subjobs as well.Crafting
float
default:"1.0"
Multiplier for the skill-up chance formula in crafting.
number
default:"1"
Multiplier for crafting skill-up amounts.
boolean
default:"true"
Use current retail skill-up rates and margins. Retail allows skill-ups at or under 10 levels above the recipe level.
number
default:"700"
Craft level at which specialization points begin to count. Retail =
700; Level 75 era = 600.number
default:"400"
Points available for crafts above
CRAFT_COMMON_CAP. Retail = 400. Setting all skills to max requires 3200.float
default:"1.0"
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.Fishing
boolean
default:"false"
Enable all fishing functionality, including quests. Enable at your own risk.
number
default:"1"
Minimum character level required to fish.
float
default:"1.0"
Multiplier for fishing skill-up chance. Default is very hard to skill up.
Battlefields
number
default:"0"
Adjust all battlefield level caps by this many levels globally.
boolean
default:"false"
Enable level caps stored in the database for mission battlefields.
boolean
default:"true"
Allow players to enter BCNMs flagged as experimental.
number
default:"30"
Maximum merit points a player can hold. Classic era is
10; Abyssea era is 30.Healing
number
default:"10"
Seconds between healing ticks while resting.
Pets
boolean
default:"false"
Keep jug pets when the player zones.
boolean
default:"false"
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
number
default:"30"
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.boolean
default:"false"
Log GM commands to the audit log. Commands issued to non-GMs are never logged.
Chat audit
Each channel can be audited independently:Item transaction audit
Error reporting
number
default:"6"
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.boolean
default:"false"
Calculate auto attack damage in Lua instead of C++.