Operator Guide

Server Operators

Connect your EQEmu world server to this login server so players can find and join your world.

Quick Start — Add login.eqemulator.dev

Add a new loginserver entry to your eqemu_config.json. Your server will appear in the directory within seconds of connecting.

{
  "server": {
    "world": {
      "loginserver2": {
        "host": "login.eqemulator.dev",
        "port": "5998"
      }
    }
  }
}

Restart your world server after saving the config. That's it — your server is now listed on eqemulator.dev.

Running Both Login Servers

Your world server can register with multiple login servers simultaneously. Keep your existing loginserver1 entry for eqemulator.net and add eqemulator.dev as a second:

{
  "server": {
    "world": {
      "loginserver1": {
        "host": "login.eqemulator.net",
        "port": "5998",
        "legacy": "1"
      },
      "loginserver2": {
        "host": "login.eqemulator.dev",
        "port": "5998"
      }
    }
  }
}

Your server appears on both server lists. Players connecting through either login server can reach your world. The "legacy": "1" flag is required for login.eqemulator.net (auto-detected if hostname contains "login.eqemulator.net").

Configuration Options

Loginserver entry fields

FieldRequiredDescription
hostYesLogin server hostname or IP
portYesLogin server port (usually 5998)
accountNoWorld server account name (for registered servers)
passwordNoWorld server account password
legacyNoSet to "1" for login.eqemulator.net compatibility

Naming convention

Loginserver entries are numbered sequentially: loginserver1, loginserver2, loginserver3, etc. The world server iterates through all numbered entries on startup.

Registration

This login server currently accepts unregistered servers. You do not need an account/password to list your server — just add the config entry and connect.

In the future, server registration may be required to claim your server profile, add a description, and manage your listing.

How Player Authentication Works

This login server runs LSPX (Login Server Proxy), which means existing eqemulator.net accounts work here automatically.

Transparent to players

When a player logs in with their eqemulator.net credentials, they are verified against eqemulator.net and cached locally. No re-registration needed. Password changes on eqemulator.net are synced automatically on next login.

What this means for your server

Players connecting through eqemulator.dev use their existing eqemulator.net credentials. From your world server's perspective, it works identically to connecting via eqemulator.net. Players keep their same account IDs and characters.

Troubleshooting

My server isn't appearing in the list

Check your world server logs for loginserver connection messages. Ensure login.eqemulator.dev is reachable from your server on port 5998 (TCP). Verify the config key is named loginserver2 (not loginserver_2).

My server shows 0 players even though people are online

Player count is reported by the world server to each login server independently. Make sure your world server is running a recent enough version that supports multi-loginserver player count reporting.

Can I connect to login.eqemulator.dev only (not eqemulator.net)?

Yes. Just configure a single loginserver1 pointing at login.eqemulator.dev. Players using their eqemulator.net credentials will still work thanks to LSPX account proxying.

Need Help?

Join the EQEmulator Discord for support from the community and other server operators.

Join Discord