docs.xiv.zone

Logging into Sapphire Servers

Luckily Sapphire has a much, much easier login process than the official servers, which only consist of one or two requests.

Logging in

POST http(s)://{sapphire_lobby_url}/sapphire-api/lobby/login

You’ll need to construct a JSON body as follows:

{
    "username": {username},
    "pass": {pass}
}

Of course, {username} and {password} is the user account credentials.

The response is also JSON, and if it’s not empty (which indicates a login error) it will be constructed like this:

{
    "sId": {SID},
    "lobbyHost": {lobby_host},
    "frontierHost": {frontier_host}
}

Now you can launch the game! See ffxiv.exe for more information. For a quick rundown:

  • Set DEV.TestSID to {SID}.
  • Set DEV.MaxEntitledExpansionID to your desired expansion level.
  • Set SYS.Region to 3.
  • Set DEV.GMServerHost to {frontier_host}.
  • Set DEV.LobbyHost01DEV.LobbyHost09 to {lobby_host}.
  • Set DEV.LobbyPort01DEV.LobbyPort09 to your Sapphire lobby’s port - usually 54994.

Registering an account

POST http(s)://{sapphire_lobby_url}/sapphire-api/lobby/createAccount

This request is identical to the one used for logging in, so refer to the section above for details.