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
The name of your server. Must be 15 characters or fewer.
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.
| Setting | Default | Expansion |
|---|---|---|
ENABLE_COP | 1 | Chains of Promathia |
ENABLE_TOAU | 1 | Treasures of Aht Urhgan |
ENABLE_WOTG | 1 | Wings of the Goddess |
ENABLE_ACP | 1 | A Crystalline Prophecy |
ENABLE_AMK | 1 | A Moogle Kupo d’Etat |
ENABLE_ASA | 1 | A Shantotto Ascension |
ENABLE_ABYSSEA | 1 | Abyssea |
ENABLE_SOA | 1 | Seekers of Adoulin |
ENABLE_ROV | 1 | Rhapsodies of Vana’diel |
ENABLE_TVR | 1 | The Voracious Resurgence |
ENABLE_VOIDWATCH | 1 | Voidwatch (not an expansion, but has its own storyline; not fully implemented) |
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
Enable Fields of Valor (FoV).
Enable Grounds of Valor (GoV).
Enable Survival Guides. Not yet implemented.
When
1, players must wait until 00:00 game time before repeating a regime, matching retail behavior. Set to 0 to remove the wait.Allow FoV rewards while in an alliance. Default
0 matches retail.Allow GoV rewards while in an alliance. Default
1 matches retail.Daily points and Gobbie Mystery Box
Allow players to accumulate daily points for the Gobbie Mystery Box.
Points awarded per day.
Maximum daily points a character can hold.
Minimum character age in days before a character can sign up for the Gobbie Mystery Box.
A.M.A.N. Assist Channel
Enable the Assist Channel for new and returning players.
How long (in playtime hours) new players and returnees retain access to the Assist Channel.
Number of days that must have elapsed before a returning player is added to the Assist Channel.
Records of Eminence
Enable Records of Eminence.
Enable 4-hour timed records.
Enforce the weekly sparks/accolades spending cap. Default
1 matches retail.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.| Setting | Default |
|---|---|
CAP_CURRENCY_ACCOLADES | 99999 |
CAP_CURRENCY_BALLISTA | 2000 |
CAP_CURRENCY_SPARKS | 99999 |
CAP_CURRENCY_VALOR | 50000 |
Character config
Starting level cap for new characters. Hard cap is 255.
Maximum attainable level. Lowers the cap by disabling Limit Break quests above this value.
Lower bound of the normal mob max-level range.
0 means uncapped.Upper bound of the normal mob max-level range.
0 means uncapped.Gil given to a newly created character.
Starting inventory and satchel size. Values below 30 are ignored. Do not set above 80.
Show the opening cutscene for new characters. Set to
0 to skip it.Minimum level to accept either subjob quest. Set to
0 to begin the game with subjobs unlocked.Minimum level to accept advanced job quests. Set to
0 to begin the game with advanced jobs unlocked.Set to
1 to give new characters all maps.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.
| Setting | Default | Description |
|---|---|---|
SHOP_PRICE | 1.000 | NPC shop prices |
GIL_RATE | 1.000 | Gil earned from quests |
BAYLD_RATE | 1.000 | Bayld earned from quests |
EXP_RATE | 1.000 | Experience points (excludes FoV/GoV) |
CAPACITY_RATE | 1.000 | Capacity points |
BOOK_EXP_RATE | 1.000 | Experience from FoV/GoV book pages |
TABS_RATE | 1.000 | Tabs earned from FoV |
ROE_EXP_RATE | 1.000 | Experience from Records of Eminence |
SPARKS_RATE | 1.000 | Sparks earned from Records of Eminence |
CURE_POWER | 1.000 | Amount healed by Healing Magic (includes relevant Blue Magic) |
ELEMENTAL_POWER | 1.000 | Damage dealt by Elemental and non-drain Dark Magic |
DIVINE_POWER | 1.000 | Damage dealt by Divine Magic |
NINJUTSU_POWER | 1.000 | Damage dealt by Ninjutsu Magic |
BLUE_POWER | 1.000 | Damage dealt by Blue Magic |
DARK_POWER | 1.000 | Amount drained by Dark Magic |
ITEM_POWER | 1.000 | Effect of items such as Potions and Ethers |
WEAPON_SKILL_POWER | 1.000 | Damage dealt by Weapon Skills |
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
| Setting | Default | Notes |
|---|---|---|
TWO_HANDED_STR_ATTACK_MULTIPLIER | 1.0 | Was 0.5 and 0.75 in previous eras |
HAND_TO_HAND_STR_ATTACK_MULTIPLIER | 1.0 | Was 0.5 and 0.625 in previous eras |
ONE_HAND_MAIN_HAND_STR_ATTACK_MULTIPLIER | 0.75 | Was 0.5 in previous eras |
ONE_HAND_OFF_HAND_STR_ATTACK_MULTIPLIER | 0.5 | Has always been 0.5 |
RANGED_STR_ATTACK_MULTIPLIER | 1.0 | Was 0.5 and 0.75 in previous eras |
DEX to Accuracy
| Setting | Default |
|---|---|
TWO_HANDED_DEX_ACCURACY_MULTIPLIER | 0.75 |
HAND_TO_HAND_DEX_ACCURACY_MULTIPLIER | 0.75 |
ONE_HAND_MAIN_HAND_DEX_ACCURACY_MULTIPLIER | 0.75 |
ONE_HAND_OFF_HAND_DEX_ACCURACY_MULTIPLIER | 0.75 |
1 AGI to Ranged Accuracy ratio for players. Mobs are hardcoded to 0.5.
1 VIT to DEF ratio for players and allies. Mobs and charmed mobs are hardcoded to 0.5.
Gameplay flags
Use new Adoulin-era weapon skill damage calculations.
Remove the party experience penalty.
Allow immunobreaks to occur.
Trusts
Enable Trust NPC summoning.
Enable Trust unlock quests.
Enable custom Trust engagement behavior.
Alter Ego campaigns
Alter Ego Extravaganza campaign.
0 = disabled, 1 = summer/NY, 2 = spring/autumn, 3 = both.Alter Ego Expo campaign (boosts Trust HP, MP, and status resistance).
0 = disabled, 1 = expo, 2 = expo plus (not implemented).Gathering
| Setting | Default | Description |
|---|---|---|
HARVESTING_BREAK_CHANCE | 33 | % chance for the sickle to break |
EXCAVATION_BREAK_CHANCE | 33 | % chance for the pickaxe to break |
LOGGING_BREAK_CHANCE | 33 | % chance for the hatchet to break |
MINING_BREAK_CHANCE | 33 | % chance for the pickaxe to break |
HARVESTING_RATE | 50 | % chance to receive an item from harvesting |
EXCAVATION_RATE | 50 | % chance to receive an item from excavation |
LOGGING_RATE | 50 | % chance to receive an item from logging |
MINING_RATE | 50 | % chance to receive an item from mining |
DIGGING_RATE | 85 | % chance to receive an item from chocobo digging during favorable weather |
NM lottery
Multiplier applied to NM lottery spawn chance.
0 disables lottery spawns entirely. -1 forces 100% chance.Multiplier applied to NM lottery cooldown time.
2.0 = twice as long. 0 = no cooldowns.Dynamis
Hours before a player can re-enter Dynamis. Default is one Earth day.
When
true, the wait time is measured by the number of server midnights rather than a full 24-hour interval.Minimum level required to enter Dynamis.
Refund amount for the Timeless Hourglass.
Cost of the Prismatic Hourglass.
Amount of Tier 1 ancient currency that exchanges for 1 Tier 2, and so on. Do not set above 198.
Set to
1 to allow players to enter CoP Dynamis without completing CoP missions.Garrison
Enable Garrison functionality.
Seconds before a new Garrison can be started.
Seconds before an ongoing Garrison expires.
Limit to one Garrison per Conquest Tally Week.
Maximum number of party members allowed in a Garrison.
Minimum Nation Rank required to start a Garrison.
Abyssea
Drop rate (as a percentage, 0–100) for mobs affected by Abyssea lights. Pearl light significantly lowers drop rate.
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
| Setting | Default | Description |
|---|---|---|
STONESKIN_CAP | 350 | Soft cap for HP absorbed by Stoneskin |
BLINK_SHADOWS | 2 | Number of shadows supplied by Blink |
SPIKE_EFFECT_DURATION | 180 | Duration (seconds) of RDM/BLM spike effects (not Reprisal) |
ELEMENTAL_DEBUFF_DURATION | 120 | Base duration (seconds) of elemental debuffs |
AQUAVEIL_COUNTER | 1 | Base hits Aquaveil absorbs to prevent spell interrupts |
SNEAK_INVIS_DURATION_MULTIPLIER | 1 | Multiplier for Sneak/Invis/Deodorize duration |
Use the older cure formula
3*MND + VIT + 3*(healing skill/5). Cure VI always uses the newer formula regardless.Use older magic damage formulas.
Monstrosity
Enable Monstrosity features.
Ratio of experience gained to infamy gained when defeating a mob.
PvP mode for Monipulators.
0 = retail (full Belligerency required), 1 = players don’t need Belligerency, 2 = open PvP.Nyzul Isle
Allow any participant to save Nyzul progress. Set to
false so only the initiator can save.Enable Treasure Casket pops from Nyzul NMs.
Enable Vigil Weapon drops from Nyzul NMs.
Miscellaneous
Enable the homepoint teleport system.
Number of hours before a player can obtain the same key item for ENMs again. Retail is 5 days.
Successful digs allowed per day. Set to
0 to disable dig fatigue entirely.Set to
1 to remove ownership restrictions on the Chariot/Empress/Emperor Band trio.System
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.Interval in milliseconds between watchdog ticks.