settings/default/main.lua file controls the majority of gameplay behavior: experience rates, expansion toggles, character creation defaults, content-specific tuning, and more. All values live under xi.settings.main.
Server identity
string
default:"'Nameless'"
The name of your server. Must be 15 characters or fewer.
string
Message shown to players on login. Supports
\n for line breaks and Lua string concatenation.Expansion toggles
Each expansion can be individually enabled (1) or disabled (0). See Expansions for a full breakdown of what each toggle controls.
number
default:"0"
Lock content to match only the enabled expansions above. Uses the
content_tag column in SQL files to prevent out-of-era content from loading. See Content restrictions.Fields/Grounds of Valor
number
default:"1"
Enable Fields of Valor (FoV).
number
default:"1"
Enable Grounds of Valor (GoV).
number
default:"1"
Enable Survival Guides. Not yet implemented.
number
default:"1"
When
1, players must wait until 00:00 game time before repeating a regime, matching retail behavior. Set to 0 to remove the wait.number
default:"0"
Allow FoV rewards while in an alliance. Default
0 matches retail.number
default:"1"
Allow GoV rewards while in an alliance. Default
1 matches retail.Daily points and Gobbie Mystery Box
number
default:"1"
Allow players to accumulate daily points for the Gobbie Mystery Box.
number
default:"10"
Points awarded per day.
number
default:"50000"
Maximum daily points a character can hold.
number
default:"45"
Minimum character age in days before a character can sign up for the Gobbie Mystery Box.
A.M.A.N. Assist Channel
boolean
default:"true"
Enable the Assist Channel for new and returning players.
number
default:"240"
How long (in playtime hours) new players and returnees retain access to the Assist Channel.
number
default:"48"
Number of days that must have elapsed before a returning player is added to the Assist Channel.
Records of Eminence
number
default:"1"
Enable Records of Eminence.
number
default:"1"
Enable 4-hour timed records.
number
default:"1"
Enforce the weekly sparks/accolades spending cap. Default
1 matches retail.number
default:"100000"
Maximum sparks or accolades that can be spent per week. Retail default is
100000.Currency caps
These caps limit how much of each currency a character can hold. Change with caution.Character config
number
default:"50"
Starting level cap for new characters. Hard cap is 255.
number
default:"99"
Maximum attainable level. Lowers the cap by disabling Limit Break quests above this value.
number
default:"0"
Lower bound of the normal mob max-level range.
0 means uncapped.number
default:"0"
Upper bound of the normal mob max-level range.
0 means uncapped.number
default:"10"
Gil given to a newly created character.
number
default:"30"
Starting inventory and satchel size. Values below 30 are ignored. Do not set above 80.
number
default:"1"
Show the opening cutscene for new characters. Set to
0 to skip it.number
default:"18"
Minimum level to accept either subjob quest. Set to
0 to begin the game with subjobs unlocked.number
default:"30"
Minimum level to accept advanced job quests. Set to
0 to begin the game with advanced jobs unlocked.number
default:"0"
Set to
1 to give new characters all maps.number
default:"0"
Set to
1 to give new characters all outpost warps. Set to 2 to also include Tu’Lia and Tavnazia.Rate multipliers
These are floating-point multipliers applied to the corresponding game values.1.0 is the retail baseline.
float
default:"0.80"
Cap for melee swing haste.
0.80 = retail delay reduction max (80%). 0.93 = ToAU era value.Combat stat ratios (players only)
These multipliers control how much stat points convert to combat stats. Mob values are hardcoded to0.5 in C++.
STR to Attack/Ranged Attack
DEX to Accuracy
float
default:"0.75"
1 AGI to Ranged Accuracy ratio for players. Mobs are hardcoded to 0.5.
float
default:"1.5"
1 VIT to DEF ratio for players and allies. Mobs and charmed mobs are hardcoded to 0.5.
Gameplay flags
boolean
default:"true"
Use new Adoulin-era weapon skill damage calculations.
boolean
default:"false"
Remove the party experience penalty.
boolean
default:"true"
Allow immunobreaks to occur.
Trusts
number
default:"1"
Enable Trust NPC summoning.
number
default:"1"
Enable Trust unlock quests.
number
default:"0"
Enable custom Trust engagement behavior.
Alter Ego campaigns
number
default:"0"
Alter Ego Extravaganza campaign.
0 = disabled, 1 = summer/NY, 2 = spring/autumn, 3 = both.number
default:"0"
Alter Ego Expo campaign (boosts Trust HP, MP, and status resistance).
0 = disabled, 1 = expo, 2 = expo plus (not implemented).Gathering
NM lottery
float
default:"1.0"
Multiplier applied to NM lottery spawn chance.
0 disables lottery spawns entirely. -1 forces 100% chance.float
default:"1.0"
Multiplier applied to NM lottery cooldown time.
2.0 = twice as long. 0 = no cooldowns.Dynamis
number
default:"24"
Hours before a player can re-enter Dynamis. Default is one Earth day.
boolean
default:"true"
When
true, the wait time is measured by the number of server midnights rather than a full 24-hour interval.number
default:"65"
Minimum level required to enter Dynamis.
number
default:"500000"
Refund amount for the Timeless Hourglass.
number
default:"50000"
Cost of the Prismatic Hourglass.
number
default:"100"
Amount of Tier 1 ancient currency that exchanges for 1 Tier 2, and so on. Do not set above 198.
number
default:"0"
Set to
1 to allow players to enter CoP Dynamis without completing CoP missions.Garrison
boolean
default:"true"
Enable Garrison functionality.
number
default:"1800"
Seconds before a new Garrison can be started.
number
default:"1800"
Seconds before an ongoing Garrison expires.
boolean
default:"true"
Limit to one Garrison per Conquest Tally Week.
number
default:"18"
Maximum number of party members allowed in a Garrison.
number
default:"2"
Minimum Nation Rank required to start a Garrison.
Abyssea
number
default:"80"
Drop rate (as a percentage, 0–100) for mobs affected by Abyssea lights. Pearl light significantly lowers drop rate.
number
default:"0"
Bonus light amount added when a player enters Abyssea. Useful for events. Recommended range: 0–100. Individual light caps are enforced automatically.
Spell-specific settings
boolean
default:"false"
Use the older cure formula
3*MND + VIT + 3*(healing skill/5). Cure VI always uses the newer formula regardless.boolean
default:"false"
Use older magic damage formulas.
Monstrosity
number
default:"0"
Enable Monstrosity features.
float
default:"0.1"
Ratio of experience gained to infamy gained when defeating a mob.
number
default:"0"
PvP mode for Monipulators.
0 = retail (full Belligerency required), 1 = players don’t need Belligerency, 2 = open PvP.Nyzul Isle
boolean
default:"true"
Allow any participant to save Nyzul progress. Set to
false so only the initiator can save.boolean
default:"true"
Enable Treasure Casket pops from Nyzul NMs.
boolean
default:"true"
Enable Vigil Weapon drops from Nyzul NMs.
Miscellaneous
number
default:"1"
Enable the homepoint teleport system.
number
default:"120"
Number of hours before a player can obtain the same key item for ENMs again. Retail is 5 days.
number
default:"100"
Successful digs allowed per day. Set to
0 to disable dig fatigue entirely.number
default:"0"
Set to
1 to remove ownership restrictions on the Chariot/Empress/Emperor Band trio.System
boolean
default:"false"
Disable the watchdog that detects if the main loop has stalled. When
false (default), the watchdog will kill the process if the main loop stops ticking.number
default:"2000"
Interval in milliseconds between watchdog ticks.