Skip to content

Troubleshooting

David Fernández Aldana edited this page Mar 31, 2026 · 46 revisions

General

Q: My antivirus detect some of the executables as virus, how do I proceed?

A: Please look for your antivirus documentation on how to add an exception (see QA on why this occurs).

Q: I run server binary but the window quickly disappears, what is wrong?

A: If server is ran for the first time, the required server certificate will be missing. You may simply generate it by running genCert in bin directory.

Q: I cannot detect the server in LAN, how do I fix it?

A: Ensure the firewall is not preventing the communication (see QA for the specific ports and protocols). Try setting in the server [Announcement].Multicast to false. If that does not work, use a direct connection setting the launcher config [Server].Host to the host name (or IPv4).

Q: Why I can't see my friend's lobby?

A: Make sure the lobby is set as public, then ensure the lobby host's firewall is not blocking incoming connections. If that does not work, make sure the lobby's filters match the lobby's configuration, have the same Data Mod installed (if any) and game version. Finally, make sure the network adapter you want to use it the top priority (lowest non-zero metric in Windows). Hidden or virtual network adapters might also cause problems. If you are using a VPN make sure Broadcast is enabled and working properly. Using an Online-like Battle Server could be a solution.

Q: Why I cannot join another lobby but can host my own? (LAN Battle Server)

A: Ensure the lobby host's firewall is not blocking incoming connections and the host. The hidden or virtual network adapters might also cause problems.

Q: I receive an error shortly after hosting (or connecting to) a match, why is that?

A: Update your game. Also, ensure the firewall is not blocking the connections. The host hidden or virtual network adapters might also cause problems. Using an Online-like Battle Server could be a workaround that.

Q: Every time I start the launcher I get an error, what can I do?

A: Open the task manager and (if existing) kill the following processes:

  • agent.
  • config-admin-agent (will require admin rights).
  • server.

If you are not confortable doing that, just restart your computer.

Also, do a manual cleanup just in case: Open the windows hosts file (c:\Windows\System32\Drivers\etc\hosts) with Notepad with administrador rights and delete any lines with #ageLANServer and finally, open certlm.msc -> Personal -> Certificates; remove any with name aoe-api.worldsedgelink.com or ageLANServer.

Q: After running the launcher I can't no longer access the official server, what can I do?

A: In the launcher folder, bin subfolder run config revert -g -a <game> where game is either age1, age2, age3 or athens. If this does not work, try the previous answer.

Q: Creating/Joining matches is very slow or after a while (typically after a match ends), I can no longer create a new lobby or there are issues, why is that?

A: When a user wants to gain an achievement, the server will not allow it (to disallow cheating) and that will cause issues unrelated to the launcher or server programs. You can use a configured custom launcher as shown here to fix this issue. If you use the official game launchers, the only solution is to restart the game (for the user with issues only). As a workaround, you may try not to gain achievements by, for example, allowing the use of 'cheats' in a lobby and every player using a harmless cheat at the start of the game as using cheats in-game will disable achievements altogether.

Q: Whenever a user connects to my server I get disconnected (or the reverse), why is that?

A: If you are using a "Custom" launcher, make certain no user shares the same Steam User ID or set in the server's config file GeneratePlatformUserId to true.

Q: Launcher exits with the error Failed to backup metadata or profiles, how do I fix it?

A: Disable temporarily backing up the metadata/profiles by opening launcher\resources\config.toml with Notepad and setting IsolateMetadata/IsolateProfiles to "false". Also if you have enabled the Ransom protection in Windows Defender please add %USERPROFILE%\Games as a folder exception. In the case of profiles make sure any Cloud sync (like the Steam/Xbox one or something line Onedrive) is disabled. Please create an issue to address it otherwise.

Q: Can I run multiple instances of the same game on the same PC?

A: The server will work (unless using an old version with GeneratePlatformUserId enabled). However, there is no support for it in the launcher and you will likely find issues with the games themselves.

Q: I cannot run the server on my PC as I already have an application listening on TCP port 443, what can I do?

A: The port is not configurable, you might be able to run it listening to another network interface or using a Virtualization software with Bridged network mode. As a last resort, just run it on one of the other PC's of the people you play with.

Linux

Q: The server won't start with an error of unable to listen, how do I fix it?

A: Run sudo setcap CAP_NET_BIND_SERVICE=+eip './server' to give permissions to listen to the 443 (HTTPS) port.

Q: I run server but nothing happens, what is wrong?

A: If you run server through the file explorer, it will run in the background without a window. If you want to see the output either run server-....sh or run server through a terminal.

Q: I cannot create a new LAN lobby, what is wrong?

A: Some distros, like Ubuntu, maps by default the hostname to a loopback address like 127.0.1.1 in /etc/hosts this makes the game client not be able to discover its own LAN server, either change that to your LAN IP or remove the entry altogether.

Q: I'm using the arm64 version of the launcher but I cannot play, why?

A: Since the game is actually x86-64, a compatibility layer is needed to run on arm64 machines. You need a translation layer like what's Steam is trying to use, FEX, or Box64 as an alternative.

Age of Empires: Definitive Edition

Q: Why do I receive an error when trying to host a lobby?

A: Make sure you are creating the lobby while inside the "LAN" section (button) you access directly through the main menu if you aren't using Online-like Battle Servers.

Q: Why is the main menu button "LAN" greyed out?

A: Look at the answer I don't have the option to select "Use Local LAN server"... for AoE II.

Age of Empires II: Definitive Edition

Q: Why do I receive an error when trying to host a lobby?

A: Make sure you are selecting the "Use Local LAN server" option when creating the lobby if you aren't using Online-like Battle Servers.

Q: I don't have the option to select "Use Local LAN server" in the server dropdown when trying to host a lobby, how do I fix it?

A: Follow the next steps:

  1. Make sure the process BattleServer.exe is running (e.g using Task Manager)
  2. Disable your firewall temporarily.
  3. Disable/De-prioritize other windows adapters (including hidden ones and virtual adapters) making sure your main LAN adapter priority is at the top when you run ipconfig. Look on the internet on how to do it.
  4. On the launcher config, set CanBroadcastBattleServer to false.

If nothing else works, you will need to host the lobby with another PC or use Online-like Battle Servers.

Q: When creating a lobby the option is greyed out and there is a loading spinner, how do I fix it?

A: See previous answer. Also, if you are using a custom launcher try a different (newer maybe) version, or as a test, use the official Steam/Xbox launchers. If you are also using DLL's, you can try to remove them.

Q: The mod browser does not work, how do I install mods?

A: You can only search and install mods online when using the official launcher. If you want to use them on other profiles when not using the official launcher, simply copy a given mod folder from %userprofile%\Age of Empires 2 DE\<profileIdSource>\mods\subscribed to %userprofile%\Age of Empires 2 DE\<profileIdDestination>\mods\local. See here for more information.

Age of Empires III: Definitive Edition

Q: Why do I receive an error when trying to host a lobby?

A: Make sure you are selecting the "LAN" option before creating the lobby if you aren't using Online-like Battle Servers.

Clone this wiki locally