Login settings

The settings/default/login.lua file controls the xi_connect login server: which client versions are accepted, whether new accounts can be created, maintenance mode, and what expansions and features appear on the client’s login screen. All values live under xi.settings.login.

Client version

CLIENT_VER

string

default:"'30260203_0'"

The expected FFXI client version string. Used together with VER_LOCK to control which client versions can connect.

VER_LOCK

number

default:"2"

Version enforcement mode:

0 — Disabled. Any client version is allowed.
1 — Strict. Only the exact CLIENT_VER is accepted.
2 — Greater-than-or-equal. Clients at CLIENT_VER or newer are accepted.

Locking the server to an older client version (VER_LOCK = 1 with an old CLIENT_VER) is strongly discouraged. It is a universally bad idea.

Maintenance mode

MAINT_MODE

number

default:"0"

Maintenance mode behavior:

0 — Normal operation.
1 — Only GM characters can log in. No new character creation is allowed.

Account management

ACCOUNT_CREATION

boolean

default:"true"

Allow new accounts to be created via the game loader.

CHARACTER_CREATION

boolean

default:"true"

Allow characters to be created through the in-game lobby.

CHARACTER_DELETION

boolean

default:"true"

Allow characters to be deleted through the in-game lobby.

Maximum simultaneous game sessions per IP address. 0 disables the limit.

LOG_USER_IP

boolean

default:"false"

Log the user’s IP address to the database on login.

Character name restrictions

DISABLE_MOB_NPC_CHAR_NAMES

boolean

default:"false"

Reject character names that match the name of any NPC or mob in the database (e.g., Fafnir, Shantotto).

BANNED_WORDS_LIST

array

default:"['badword']"

A list of words that will cause a character name to be rejected if the name contains them in any position. Matching is case-insensitive.

BANNED_WORDS_LIST =
{
    'slur',
    'another_banned_term',
}

Be aware of the Scunthorpe problem — substring matching can block legitimate names. Review your list carefully.

These settings control which expansions are shown as owned on the client’s login screen. They have no effect on in-game content — use the expansion toggles in Main settings for that.

Setting	Default	Expansion
`RISE_OF_ZILART`	`true`	Rise of Zilart
`CHAINS_OF_PROMATHIA`	`true`	Chains of Promathia
`TREASURES_OF_AHT_URGHAN`	`true`	Treasures of Aht Urhgan
`WINGS_OF_THE_GODDESS`	`true`	Wings of the Goddess
`A_CRYSTALLINE_PROPHECY`	`true`	A Crystalline Prophecy
`A_MOOGLE_KUPOD_ETAT`	`true`	A Moogle Kupo d’Etat
`A_SHANTOTTO_ASCENSION`	`true`	A Shantotto Ascension
`VISIONS_OF_ABYSSEA`	`true`	Visions of Abyssea
`SCARS_OF_ABYSSEA`	`true`	Scars of Abyssea
`HEROES_OF_ABYSSEA`	`true`	Heroes of Abyssea
`SEEKERS_OF_ADOULIN`	`true`	Seekers of Adoulin

These settings control feature indicators on the login screen. They have no effect on in-game content.

Setting	Default	Feature
`SECURE_TOKEN`	`false`	Two-factor authentication (not yet supported)
`MOG_WARDROBE_3`	`true`	Mog Wardrobe 3
`MOG_WARDROBE_4`	`true`	Mog Wardrobe 4
`MOG_WARDROBE_5`	`true`	Mog Wardrobe 5
`MOG_WARDROBE_6`	`true`	Mog Wardrobe 6
`MOG_WARDROBE_7`	`true`	Mog Wardrobe 7
`MOG_WARDROBE_8`	`true`	Mog Wardrobe 8

Mog Wardrobes are per-character, so login screen display cannot reflect per-account inventory. Any custom configuration here applies universally.

Server Settings

Expansions & Content

Client version

Maintenance mode

Account management

Character name restrictions

Build docs developers (and LLMs) love

Server Settings

Expansions & Content

​Client version

​Maintenance mode

​Account management

​Character name restrictions

​Login screen: expansion display

​Login screen: feature display

Build docs developers (and LLMs) love

Client version

Maintenance mode

Account management

Character name restrictions

Login screen: expansion display

Login screen: feature display