Troubleshooting - luskaner/ageLANServer GitHub Wiki
General
Q: My antivirus detect some of the executables as virus, why?
A: There are no viruses, some antivirus can falsely detect some files as virus, likely due to being programmed in the Go language. You may use VirusTotal to check with multiple antivirus and see that the vast majority of Antiviruses do not flag it as a virus. If you are still not convinced, as this is an open-source project, you may review the code and build it yourself.
Q: I run server
binary but the window quickly disappears, what is wrong?
A: If you run server
for the first time (and not via the launcher
), the required server certificate might not have been generated. You may simply generate it by running genCert
in bin
directory.
Q: I cannot detect the server, 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 fix it, 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).
Q: Why I cannot join another lobby but can host my own?
A: Ensure the lobby host's firewall is not blocking incoming connections.
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.
Q: Every time I start the launcher I get an error and I'm told to run cleanup but it does not fix it, 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.
Q: 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
, how do I fix it?
A: Try running the proper cleanup-...
script and re-running the launcher, if that does not work, disable temporarily backing up the metadata by opening launcher\resources\config.toml
with Notepad and setting IsolateMetadata
to false
. Please create an issue to address it.
Q: Launcher exits with the error Failed to backup profiles
, how do I fix it?
A: Try running the proper cleanup-...
script and re-running the launcher, if that does not work, disable temporarily backing up the profiles by opening launcher\resources\config.toml
with Notepad and setting IsolateProfiles
to false
. Please create an issue to address it.
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'm using the arm64 version of the launcher but I cannot play through Steam, why?
A: Since the game is actually x86-64, a compatibility layer is needed to run on arm64 machines. Steam is working on it already. I'm providing an arm64 variant just in anticipation for this compatibility to happen. So, in the mean time, you might have some luck tinkering with the CPU emulation that Valve 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.
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.
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:
- Make sure the process
BattleServer.exe
is running (e.g using Task Manager) - Disable your windows firewall temporarily.
- Disable/De-prioritize other windows adapters (like 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. - On the launcher config, set
CanBroadcastBattleServer
tofalse
. - Host the lobby with another PC.
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.