v1.14.0

What's Changed

Hosts handling

• 🔝 Enhancement: Try to detect the encoding of the hosts file to properly read and write it. Before it was assumed it was UTF-8.
• 🔝 Enhancement: modifying the hosts file comments lines that are not valid or are in conflict with the changes needed to be made ensuring the new mappings take effect but the rest is kept as much as possible, for example, keeping partially valid lines.
• 🔝 Enhancement: before doing any modification a backup file (hosts.bak) is created.
• 🔝 Enhancement: restoring of the original hosts entries now has two methods:
  • In-place: the old method but improved to ensure as close to the original file as possible (ensured to work the same). Only applied if the hosts was modified after the backup was made or if the backup does not exist at all.
  • Restore: default method if the backup exists and is up-to-date. Ensures the exact original hosts file is restored.
• 🔝 🪟 Enhancement: Add UTF-16 support. Some tools or Powershell itself could modify the file changing the standard UTF-8 encoding. This fixes the case where when modifying the hosts file it could become corrupted with mixed encoding.
• 🆕 🪟 Enhancement: Add many locales specific ANSI support.
• 🐧 Enhancement: Only allow UTF-8 encoding.
• 🐧 Enhancement: Only allow up to 256 characters per line for wide compatibility.
• 🐛 Fix: Ensure hosts are properly read/written using IDNA denormalization/normalization.
• Enhancement: use the standard file locking mechanism the rest of the project uses.

General

• 🔝 Enhancement: Migrated poorly maintaned command line arguments (cobra) and configuration (viper) libraries to pflag and koanf respectively to have less indirect dependencies thus better security and less size. This a necessary step in order to support the upcoming GUI configuration programs to save files.
• Enhancement: Add more checks to ensure an error is returned when trying to run a subprocess with invalid combination of options.
• 🐛 Fix: api-dr.ageofempires.com (used for Mods) domain support for AoE 4.
• 🐛🐧 Fix: Running a process with shell and arguments.
• 🐛🐧 Fix: Waiting for process end when it's not a child process.

Server

• Enhancement: updated data for AoM that came with Blood and Bones Pack.

Launcher

• Enhancement: wait up to 1 minute for any running game to exit instead of erroring inmediately.
• (🆕 since pre-release) Enhancement: wait up to 10 seconds for agent and config-admin-agent to exit before trying to kill them at start.
• 🐛 Fix: Map old aoeliverelease1-api.worldsedgelink.com and aoeliverelease2-api.worldsedgelink.com domains for AoE 4.
• 🐛 Fix: config trying to reconnect to config-admin-agent after requesting exit.
• (🆕 since pre-release) 🐛 Fix: if CA cert cannot be added don't continue.
• 🐛 🪟 Fix: failed to run config-admin when logging is enabled and elevation is needed. Logging is disabled instead.
• 🐛 🐧 Fix: incorrectly detecting that it cannot stop server it started.
• 🐛 🐧 Fix: delay to continue after failed run of launcher-config-admin-agent (for example if the elevation dialog was denied) introducing unnecessary delay.
• (🆕 since pre-release) 🐛 🐧 Fix: CA game setup not working.

Battle Server Manager

• 🔝 🐧 Enhancement: Run BattleServer.exe using wine before assuming the user has binfmt working for Windows executables.

Other

• Enhancement: Updated Go from 1.26.0 to 1.26.1.
• (🆕 since pre-release) Enhancement: Updated Go from 1.26.1 to 1.26.2.

Developer changes

• 🐛 Fix: prepare-battle-server-manager task.
• 🐛 🐧 Fix: debugging tasks.
• (🆕 since pre-release) 🐛 🐧 Fix: debugging tasks (again).

What's coming in the future?

See this.

Sponsors/Donations

• @codabrink (GitHub monthly sponsor). See his AoE-Archiver that enables easy auto-configuration of this project in combination with the companion and steam emu for AoE II: DE on Windows!
• Skoop (one-time donation)
• Ghoulette (one-time donation)

There are multiples ways to help: starring the repo, spreading the word, contributing to the repository, making an issue report, sponsoring me monthly or a one-time donation!

See Github differences:

• Since last stable version: v1.13.1...v1.14.0
• Since last pre-release version: v1.14.0-rc.1...v1.14.0

Files

The following assets are directly compiled and listed next to the release notes:

• Full:
  • Windows:
    • 10 on x86-64: ..._full_v1.14.0_win10_x86-64.zip
    • 7 on x86-64: ..._full_v1.14.0_win7_x86-64.zip
    • 11 on ARM: ..._full_v1.14.0_win11_arm64.zip
  • Linux:
    • x86-64: ..._full_v1.14.0_linux_x86-64.tar.gz
    • ARM64: ..._full_v1.14.0_linux_arm64.tar.gz
• Launcher:
  • Windows:
    • 10 on x86-64: ..._launcher_v1.14.0_win10_x86-64.zip
    • 7 on x86-64: ..._launcher_v1.14.0_win7_x86-64.zip
    • 11 on ARM: ..._launcher_v1.14.0_win11_arm64.zip
  • Linux:
    • x86-64: ..._launcher_v1.14.0_linux_x86-64.tar.gz
    • ARM64: ..._launcher_v1.14.0_linux_arm64.tar.gz
• Battle Server Manager:
  • Windows:
    • 10 on x86-64: ..._battle-server-manager_v1.14.0_win10_x86-64.zip
    • 7 on x86-64: ..._battle-server-manager_v1.14.0_win7_x86-64.zip
    • 11 on ARM: ..._battle-server-manager_v1.14.0_win11_arm64.zip
  • Linux:
    • x86-64: ..._battle-server-manager_v1.14.0_linux_x86-64.tar.gz
    • ARM64: ..._battle-server-manager_v1.14.0_linux_arm64.tar.gz
• Server:
  • Windows:
    • 10 (IoT), Server (IoT) 2025 on ARM64: ..._server_v1.14.0_win10_arm64.zip
    • 10 (IoT), (Storage) Server 2016, Server IoT 2019 on x86-64: ..._server_v1.14.0_win10_x86-64.zip
    • 7, Server 2008 R2, Home Server 2011, Embedded 7 on x86-64: ..._server_v1.14.0_win7_x86-64.zip
    • 10 (IoT) on x86-32: ..._server_v1.14.0_win10_x86-32.zip
    • 7, Embedded 7, Thin PC on x86-32: ..._server_v1.14.0_win7_x86-32.zip
  • Linux:
    • ARM64: ..._server_v1.14.0_linux_arm64.tar.gz
    • ARM32:
      • ARMv5 (armel): ..._server_v1.14.0_linux_arm-5.tar.gz
      • ARMv6 (sometimes called armhf): ..._server_v1.14.0_linux_arm-6.tar.gz
    • x86-64: ..._server_v1.14.0_linux_x86-64.tar.gz
    • x86-32: ..._server_v1.14.0_linux_x86-32.tar.gz
  • macOS - Monterey (v12): ..._server_v1.14.0_mac.tar.gz

Note: If you are using Antivirus it may flag one or more executables as virus, this is a false positive.

Verification

The verification process ensures that the files you download are the same as the ones that were uploaded by the
maintainer.

1. Download the ageLANLanServer_v1.14.0_checksums.txt and ageLANLanServer_v1.14.0_checksums.txt.sig files.
2. Import the release public key and import it to your keyring if you haven't already.
3. Verify the ageLANServer_v1.14.0_checksums.txt file with the ageLANLanServer_v1.14.0_checksums.txt.sig file.
4. Verify the SHA-256 checksum list inside ageLANServer_v1.14.0_checksums.txt with the downloaded archives.

Simplest way to use it

1. Download the proper full asset.
2. Uncompress it somewhere.
3. Windows Optional: You may need to add the launcher/server binaries to the exception list of your Antivirus.
4. Windows Optional: Unblock the .exe files as explained here
5. If not using the Steam or Xbox launcher, edit the launcher/resources/config.<game_title>.toml file with a text editor (like Notepad) and modify the Client.Executable section to point to the game launcher path. In this case, you also need to modify Client.Path to point to the game's directory. You will need to use a custom launcher (plus what my other repo provides) for 100% offline play.
6. If you are using a custom launcher, (or you are using AoE IV/AoM and don't have AoE II: DE installed) edit the battle-server-manager/resources/config.athens.toml file and point Executable.Path to the game's "BattleServer.exe" (or specifically AoE II: DE one for AoM) executable (it's portable), for example, 'S:\SteamLibrary\steamapps\common\AoE2DE\BattleServer\BattleServer.exe'.
7. Execute launcher/start_<game_title> script: you will be asked for admin elevation and confirmation of other dialogs as needed, you will also need to allow the connections via the Microsoft Defender Firewall or any other.
8. Repeat the above steps for every PC (except the point 6) you want to play in LAN with by running the launcher, the first PC to launch it will host the "server" and the rest will auto-discover and be prompted to connnect to it.
9. In the game, just host a new lobby via the Multiplayer section. Setting it to public visibility is recommended.
10. If the lobby is Public, they can join directly in the browser or you can Invite friends by searching them by name and sending an invite as needed. If the game allows, you can share the link to join the lobby automatically (only works if already in-game).

Help

Look for the Troubleshooting if you have any issues (or QA for any doubt), create an [issue](https://github.com/luskaner/ageLANServer...

v1.14.0-rc.1

What's Changed since last stable release

Hosts handling

• 🔝 Enhancement: Try to detect the encoding of the hosts file to properly read and write it. Before it was assumed it was UTF-8.
• 🔝 Enhancement: modifying the hosts file comments lines that are not valid or are in conflict with the changes needed to be made ensuring the new mappings take effect but the rest is kept as much as possible, for example, keeping partially valid lines.
• 🔝 Enhancement: before doing any modification a backup file (hosts.bak) is created.
• 🔝 Enhancement: restoring of the original hosts entries now has two methods:
  • In-place: the old method but improved to ensure as close to the original file as possible (ensured to work the same). Only applied if the hosts was modified after the backup was made or if the backup does not exist at all.
  • Restore: default method if the backup exists and is up-to-date. Ensures the exact original hosts file is restored.
• 🔝 🪟 Enhancement: Add UTF-16 support. Some tools or Powershell itself could modify the file changing the standard UTF-8 encoding. This fixes the case where when modifying the hosts file it could become corrupted with mixed encoding.
• 🆕 🪟 Enhancement: Add many locales specific ANSI support.
• 🐧 Enhancement: Only allow UTF-8 encoding.
• 🐧 Enhancement: Only allow up to 256 characters per line for wide compatibility.
• 🐛 Fix: Ensure hosts are properly read/written using IDNA denormalization/normalization.
• Enhancement: use the standard file locking mechanism the rest of the project uses.

General

• 🔝 Enhancement: Migrated poorly maintaned command line arguments (cobra) and configuration (viper) libraries to pflag and koanf respectively to have less indirect dependencies thus better security and less size. This a necessary step in order to support the upcoming GUI configuration programs to save files.
• Enhancement: Add more checks to ensure an error is returned when trying to run a subprocess with invalid combination of options.
• 🐛 Fix: api-dr.ageofempires.com (used for Mods) domain support for AoE 4.
• 🐛🐧 Fix: Running a process with shell and arguments.
• 🐛🐧 Fix: Waiting for process end when it's not a child process.

Server

• Enhancement: updated data for AoM that came with Blood and Bones Pack.

Launcher

• Enhancement: wait up to 1 minute for any running game to exit instead of erroring inmediately.
• 🐛 Fix: Map old aoeliverelease1-api.worldsedgelink.com and aoeliverelease2-api.worldsedgelink.com domains for AoE 4.
• 🐛 Fix: config trying to reconnect to config-admin-agent after requesting exit.
• 🐛 🪟 Fix: failed to run config-admin when logging is enabled and elevation is needed. Logging is disabled instead.
• 🐛 🐧 Fix: incorrectly detecting that it cannot stop server it started.
• 🐛 🐧 Fix: delay to continue after failed run of launcher-config-admin-agent (for example if the elevation dialog was denied) introducing unnecessary delay.

Battle Server Manager

• 🔝 🐧 Enhancement: Run BattleServer.exe using wine before assuming the user has binfmt working for Windows executables.

Other

• Enhancement: Updated Go from 1.26.0 to 1.26.1.

Developer changes

• 🐛 Fix: prepare-battle-server-manager task.
• 🐛 🐧 Fix: debugging tasks.

What's coming in the future?

See this.

Sponsors/Donations

• Thanks to @codabrink for the continued monthly sponshorship!

There are multiples ways to help: starring the repo, spreading the word, contributing to the repository, making an issue report, sponsoring me monthly or a one-time donation!

See Github differences v1.13.1...v1.14.0-rc.1

Files

The following assets are directly compiled and listed next to the release notes:

• Full:
  • Windows:
    • 10 on x86-64: ..._full_v1.14.0_win10_x86-64.zip
    • 7 on x86-64: ..._full_v1.14.0_win7_x86-64.zip
    • 11 on ARM: ..._full_v1.14.0_win11_arm64.zip
  • Linux:
    • x86-64: ..._full_v1.14.0_linux_x86-64.tar.gz
    • ARM64: ..._full_v1.14.0_linux_arm64.tar.gz
• Launcher:
  • Windows:
    • 10 on x86-64: ..._launcher_v1.14.0_win10_x86-64.zip
    • 7 on x86-64: ..._launcher_v1.14.0_win7_x86-64.zip
    • 11 on ARM: ..._launcher_v1.14.0_win11_arm64.zip
  • Linux:
    • x86-64: ..._launcher_v1.14.0_linux_x86-64.tar.gz
    • ARM64: ..._launcher_v1.14.0_linux_arm64.tar.gz
• Battle Server Manager:
  • Windows:
    • 10 on x86-64: ..._battle-server-manager_v1.14.0_win10_x86-64.zip
    • 7 on x86-64: ..._battle-server-manager_v1.14.0_win7_x86-64.zip
    • 11 on ARM: ..._battle-server-manager_v1.14.0_win11_arm64.zip
  • Linux:
    • x86-64: ..._battle-server-manager_v1.14.0_linux_x86-64.tar.gz
    • ARM64: ..._battle-server-manager_v1.14.0_linux_arm64.tar.gz
• Server:
  • Windows:
    • 10 (IoT), Server (IoT) 2025 on ARM64: ..._server_v1.14.0_win10_arm64.zip
    • 10 (IoT), (Storage) Server 2016, Server IoT 2019 on x86-64: ..._server_v1.14.0_win10_x86-64.zip
    • 7, Server 2008 R2, Home Server 2011, Embedded 7 on x86-64: ..._server_v1.14.0_win7_x86-64.zip
    • 10 (IoT) on x86-32: ..._server_v1.14.0_win10_x86-32.zip
    • 7, Embedded 7, Thin PC on x86-32: ..._server_v1.14.0_win7_x86-32.zip
  • Linux:
    • ARM64: ..._server_v1.14.0_linux_arm64.tar.gz
    • ARM32:
      • ARMv5 (armel): ..._server_v1.14.0_linux_arm-5.tar.gz
      • ARMv6 (sometimes called armhf): ..._server_v1.14.0_linux_arm-6.tar.gz
    • x86-64: ..._server_v1.14.0_linux_x86-64.tar.gz
    • x86-32: ..._server_v1.14.0_linux_x86-32.tar.gz
  • macOS - Monterey (v12): ..._server_v1.14.0_mac.tar.gz

Note: If you are using Antivirus it may flag one or more executables as virus, this is a false positive.

Verification

The verification process ensures that the files you download are the same as the ones that were uploaded by the
maintainer.

1. Download the ageLANLanServer_v1.14.0_checksums.txt and ageLANLanServer_v1.14.0_checksums.txt.sig files.
2. Import the release public key and import it to your keyring if you haven't already.
3. Verify the ageLANServer_v1.14.0_checksums.txt file with the ageLANLanServer_v1.14.0_checksums.txt.sig file.
4. Verify the SHA-256 checksum list inside ageLANServer_v1.14.0_checksums.txt with the downloaded archives.

Simplest way to use it

1. Download the proper full asset.
2. Uncompress it somewhere.
3. Windows Optional: You may need to add the launcher/server binaries to the exception list of your Antivirus.
4. Windows Optional: Unblock the .exe files as explained here
5. If not using the Steam or Xbox launcher, edit the launcher/resources/config.<game_title>.toml file with a text editor (like Notepad) and modify the Client.Executable section to point to the game launcher path. In this case, you also need to modify Client.Path to point to the game's directory. You will need to use a custom launcher (plus what my other repo provides) for 100% offline play.
6. If you are using a custom launcher, (or you are using AoE IV/AoM and don't have AoE II: DE installed) edit the battle-server-manager/resources/config.athens.toml file and point Executable.Path to the game's "BattleServer.exe" (or specifically AoE II: DE one for AoM) executable (it's portable), for example, 'S:\SteamLibrary\steamapps\common\AoE2DE\BattleServer\BattleServer.exe'.
7. Execute launcher/start_<game_title> script: you will be asked for admin elevation and confirmation of other dialogs as needed, you will also need to allow the connections via the Microsoft Defender Firewall or any other.
8. Repeat the above steps for every PC (except the point 6) you want to play in LAN with by running the launcher, the first PC to launch it will host the "server" and the rest will auto-discover and be prompted to connnect to it.
9. In the game, just host a new lobby via the Multiplayer section. Setting it to public visibility is recommended.
10. If the lobby is Public, they can join directly in the browser or you can Invite friends by searching them by name and sending an invite as needed. If the game allows, you can share the link to join the lobby automatically (only works if already in-game).

Help

Look for the Troubleshooting if you have any issues (or QA for any doubt), create an issue or look for other related issues.

v1.13.1

What's Changed since last stable release

General

• 🐛 Critical Fix: not always using the system DNS resolver and sometimes using the builtin one, specially affecting the launcher causing the dreaded Failed to read certificate from aoe-api.reliclink.com. line or similar messages as it did not give priority to the local hosts file.

Launcher

• 🐛 Fix: not sending the host header when trying to read the server CA certificate.

What's coming in the future?

See this.

Sponsors/Donations

• Thanks to @codabrink for the continued monthly sponshorship and for AoE-Archiver that enables easy auto-configuration of this project in combination with the companion and steam emu for AoE II: DE on Windows!

There are multiples ways to help: starring the repo, spreading the word, contributing to the repository, making an issue report, sponsoring me monthly or a one-time donation!

See Github differences v1.13.0...v1.13.1

Files

The following assets are directly compiled and listed next to the release notes:

• Full:
  • Windows:
    • 10 on x86-64: ..._full_v1.13.1_win10_x86-64.zip
    • 7 on x86-64: ..._full_v1.13.1_win7_x86-64.zip
    • 11 on ARM: ..._full_v1.13.1_win11_arm64.zip
  • Linux:
    • x86-64: ..._full_v1.13.1_linux_x86-64.tar.gz
    • ARM64: ..._full_v1.13.1_linux_arm64.tar.gz
• Launcher:
  • Windows:
    • 10 on x86-64: ..._launcher_v1.13.1_win10_x86-64.zip
    • 7 on x86-64: ..._launcher_v1.13.1_win7_x86-64.zip
    • 11 on ARM: ..._launcher_v1.13.1_win11_arm64.zip
  • Linux:
    • x86-64: ..._launcher_v1.13.1_linux_x86-64.tar.gz
    • ARM64: ..._launcher_v1.13.1_linux_arm64.tar.gz
• Battle Server Manager:
  • Windows:
    • 10 on x86-64: ..._battle-server-manager_v1.13.1_win10_x86-64.zip
    • 7 on x86-64: ..._battle-server-manager_v1.13.1_win7_x86-64.zip
    • 11 on ARM: ..._battle-server-manager_v1.13.1_win11_arm64.zip
  • Linux:
    • x86-64: ..._battle-server-manager_v1.13.1_linux_x86-64.tar.gz
    • ARM64: ..._battle-server-manager_v1.13.1_linux_arm64.tar.gz
• Server:
  • Windows:
    • 10 (IoT), Server (IoT) 2025 on ARM64: ..._server_v1.13.1_win10_arm64.zip
    • 10 (IoT), (Storage) Server 2016, Server IoT 2019 on x86-64: ..._server_v1.13.1_win10_x86-64.zip
    • 7, Server 2008 R2, Home Server 2011, Embedded 7 on x86-64: ..._server_v1.13.1_win7_x86-64.zip
    • 10 (IoT) on x86-32: ..._server_v1.13.1_win10_x86-32.zip
    • 7, Embedded 7, Thin PC on x86-32: ..._server_v1.13.1_win7_x86-32.zip
  • Linux:
    • ARM64: ..._server_v1.13.1_linux_arm64.tar.gz
    • ARM32:
      • ARMv5 (armel): ..._server_v1.13.1_linux_arm-5.tar.gz
      • ARMv6 (sometimes called armhf): ..._server_v1.13.1_linux_arm-6.tar.gz
    • x86-64: ..._server_v1.13.1_linux_x86-64.tar.gz
    • x86-32: ..._server_v1.13.1_linux_x86-32.tar.gz
  • macOS - Monterey (v12): ..._server_v1.13.1_mac.tar.gz

Note: If you are using Antivirus it may flag one or more executables as virus, this is a false positive.

Verification

The verification process ensures that the files you download are the same as the ones that were uploaded by the
maintainer.

1. Download the ageLANLanServer_v1.13.1_checksums.txt and ageLANLanServer_v1.13.1_checksums.txt.sig files.
2. Import the release public key and import it to your keyring if you haven't already.
3. Verify the ageLANServer_v1.13.1_checksums.txt file with the ageLANLanServer_v1.13.1_checksums.txt.sig file.
4. Verify the SHA-256 checksum list inside ageLANServer_v1.13.1_checksums.txt with the downloaded archives.

Simplest way to use it

1. Download the proper full asset.
2. Uncompress it somewhere.
3. Windows Optional: You may need to add the launcher/server binaries to the exception list of your Antivirus.
4. Windows Optional: Unblock the .exe files as explained here
5. If not using the Steam or Xbox launcher, edit the launcher/resources/config.<game_title>.toml file with a text editor (like Notepad) and modify the Client.Executable section to point to the game launcher path. In this case, you also need to modify Client.Path to point to the game's directory. You will need to use a custom launcher (plus what my other repo provides) for 100% offline play.
6. If you are using a custom launcher, (or you are using AoE IV/AoM and don't have AoE II: DE installed) edit the battle-server-manager/resources/config.athens.toml file and point Executable.Path to the game's "BattleServer.exe" (or specifically AoE II: DE one for AoM) executable (it's portable), for example, 'S:\SteamLibrary\steamapps\common\AoE2DE\BattleServer\BattleServer.exe'.
7. Execute launcher/start_<game_title> script: you will be asked for admin elevation and confirmation of other dialogs as needed, you will also need to allow the connections via the Microsoft Defender Firewall or any other.
8. Repeat the above steps for every PC (except the point 6) you want to play in LAN with by running the launcher, the first PC to launch it will host the "server" and the rest will auto-discover and be prompted to connnect to it.
9. In the game, just host a new lobby via the Multiplayer section. Setting it to public visibility is recommended.
10. If the lobby is Public, they can join directly in the browser or you can Invite friends by searching them by name and sending an invite as needed. If the game allows, you can share the link to join the lobby automatically (only works if already in-game).

Help

Look for the Troubleshooting if you have any issues (or QA for any doubt), create an issue or look for other related issues.

v1.13.0

What's Changed since last stable release

Age of Empires IV: Anniversary Edition support

Added support for this game on Steam and Microsoft Store/Xbox, however, as of writing, has the following specific issues:

• #402
• #403
• #404
• #406
• #407
• #417

Authentication

The server is introducing authentication options so the server owner has the option to properly authenticate the user, configurable as follows:

• required: the server will authenticate the user with the official servers everytime.
• cached: the server will force the clients to authenticate with the official server at least once every 30 days. The cache would be tied to the user platform user id (as the other info saved per user).
• adaptive: the server will use cached if internet is detected on the server or disabled otherwise.
• disabled (default). No authentication as before this release. The server's owner (and to a lesser degree their clients) is/are legally responsible and must ensure that they own the game (and any DLC's) in the proper platform.

This is necessary to support AoE IV game as the server can decide which DLC's the user has access to and give the users the choice on how strict the server is so the repo is not seen as a piracy tool but rather as a way to keep games alive and allow true offline functionality

General

• 🔝 Enhancement: added support for age4 game.
• Enhancement: now client requests include the header User-Agent to ageLANServer/1.0 so it's identifiable as this software to others.

Server

• 🔝Enhancement: added support authentication with the new config Authentication key (default 'disabled'), not compatible with GeneratePlatformUserId unless it is 'disabled'.
• 🔝Enhancement: added support for AoM update 18.65484 including the modifications to Gauntlet mode
• 🔝Enhancement: improved support for managing user items and now are saved persistently.
• 🆕 Enhancement: added support for groups (used in age4).
• 🆕 Enhancement: added support for lobbies/groups to change leader.
• 🆕 Enhancement: Added support for user presence (including its properties).
• 🆕 Enhancement: Added support for user properties.
• 🆕 Enhancement: Added partial support for managing item loadouts.
• Enhancement: added Playfab support for age4.
• Enhancement: now LAN lobbies are detected more reliable and faster when hosting them.
• 🐛 Fix: persistent data not being read correctly
• 🐛 Fix: Log setting/param being ignored.
• 🐛 Fix: lobbies/groups now properly return when is observing enabled and the observer password.
• 🐛 Fix: cloud/getFileURL when there are not URLs.
• 🐛 Fix: item/getInventoryByProfileIDs now properly return correct location IDs.
• 🚧 Update: login data for all age of empires games.
• 🚧 Update: modernized proxy implementation and made the configured/server hosts coherent by launcher/server respectively.

Launcher

• 🆕 Enhancement: add option Server.StartWithoutConfirmation so pressing enter is not needed when starting a server if no other servers are found.
• 🆕 Enhancement: added option to choose not to add the certificate to game's store with Config.Certificate.CanTrustInGame.
• Enhancement: moved checks and messages earlier so it fails faster if it needs to.
• 🐛 Fix on Windows: failing to get the steam installation path after a Steam Emu messed up the registry.
• 🐛 Fix: properly restore the configuration at start if the previous unclean finish was a different game.
• 🐛 Fix: print config when logging to file.
• 🚧 Update: Renamed Config.CanTrustCertificate to Config.Certificate.CanTrustInPc.

Battle Server Manager

• 🐛 Fix: printing the configuration even without logRoot being passed.

Other

• 🐛 Fix: server/BattleServers.md doc.

Developer changes

• 🆕 Enhancement: integrated the building for Windows 7 archives in the CI pipeline with the rest of archives.
• 🐛 Fix: missing generateGoreleaserConfig.go in CodeQL.
• 🆕 Enhancement: added go.work and go.work.sum and removed go.work.template to simplify and make it more predictable.
• 🚧 Update: Go minimum version updated to 1.26.
• 🚧 Update: golang dependencies updated.
• 🚧 Update: removed go.work.sum and added to .gitignore.

What's coming in the future?

See this.

Sponsors/Donations

• Thanks to @codabrink for the continued monthly sponshorship and for AoE-Archiver that enables easy auto-configuration of this project in combination with the companion and steam emu for AoE II: DE on Windows!

There are multiples ways to help: starring the repo, spreading the word, contributing to the repository, making an issue report, sponsoring me monthly or a one-time donation!

See Github differences v1.12.3...v1.13.0

Files

The following assets are directly compiled and listed next to the release notes:

• Full:
  • Windows:
    • 10 on x86-64: ..._full_v1.13.0_win10_x86-64.zip
    • 7 on x86-64: ..._full_v1.13.0_win7_x86-64.zip
    • 11 on ARM: ..._full_v1.13.0_win11_arm64.zip
  • Linux:
    • x86-64: ..._full_v1.13.0_linux_x86-64.tar.gz
    • ARM64: ..._full_v1.13.0_linux_arm64.tar.gz
• Launcher:
  • Windows:
    • 10 on x86-64: ..._launcher_v1.13.0_win10_x86-64.zip
    • 7 on x86-64: ..._launcher_v1.13.0_win7_x86-64.zip
    • 11 on ARM: ..._launcher_v1.13.0_win11_arm64.zip
  • Linux:
    • x86-64: ..._launcher_v1.13.0_linux_x86-64.tar.gz
    • ARM64: ..._launcher_v1.13.0_linux_arm64.tar.gz
• Battle Server Manager:
  • Windows:
    • 10 on x86-64: ..._battle-server-manager_v1.13.0_win10_x86-64.zip
    • 7 on x86-64: ..._battle-server-manager_v1.13.0_win7_x86-64.zip
    • 11 on ARM: ..._battle-server-manager_v1.13.0_win11_arm64.zip
  • Linux:
    • x86-64: ..._battle-server-manager_v1.13.0_linux_x86-64.tar.gz
    • ARM64: ..._battle-server-manager_v1.13.0_linux_arm64.tar.gz
• Server:
  • Windows:
    • 10 (IoT), Server (IoT) 2025 on ARM64: ..._server_v1.13.0_win10_arm64.zip
    • 10 (IoT), (Storage) Server 2016, Server IoT 2019 on x86-64: ..._server_v1.13.0_win10_x86-64.zip
    • 7, Server 2008 R2, Home Server 2011, Embedded 7 on x86-64: ..._server_v1.13.0_win7_x86-64.zip
    • 10 (IoT) on x86-32: ..._server_v1.13.0_win10_x86-32.zip
    • 7, Embedded 7, Thin PC on x86-32: ..._server_v1.13.0_win7_x86-32.zip
  • Linux:
    • ARM64: ..._server_v1.13.0_linux_arm64.tar.gz
    • ARM32:
      • ARMv5 (armel): ..._server_v1.13.0_linux_arm-5.tar.gz
      • ARMv6 (sometimes called armhf): ..._server_v1.13.0_linux_arm-6.tar.gz
    • x86-64: ..._server_v1.13.0_linux_x86-64.tar.gz
    • x86-32: ..._server_v1.13.0_linux_x86-32.tar.gz
  • macOS - Monterey (v12): ..._server_v1.13.0_mac.tar.gz

Note: If you are using Antivirus it may flag one or more executables as virus, this is a false positive.

Verification

The verification process ensures that the files you download are the same as the ones that were uploaded by the
maintainer.

1. Download the ageLANLanServer_v1.13.0_checksums.txt and ageLANLanServer_v1.13.0_checksums.txt.sig files.
2. Import the release public key and import it to your keyring if you haven't already.
3. Verify the ageLANServer_v1.13.0_checksums.txt file with the ageLANLanServer_v1.13.0_checksums.txt.sig file.
4. Verify the SHA-256 checksum list inside ageLANServer_v1.13.0_checksums.txt with the downloaded archives.

Simplest way to use it

1. Download the proper full asset.
2. Uncompress it somewhere.
3. Windows Optional: You may need to add the launcher/server binaries to the exception list of your Antivirus.
4. Windows Optional: Unblock the .exe files as explained here
5. If not using the Steam or Xbox launcher, edit the launcher/resources/config.<game_title>.toml file with a text editor (like Notepad) and modify the Client.Executable section to point to the game launcher path. In this case, you also need to modify Client.Path to point to the game's directory. You will need to use a custom launcher (plus what my other repo provides) for 100% offline play.
6. If you are using a custom launcher, (or you are using AoE IV/AoM and don't have AoE II: DE installed) edit the battle-server-manager/resources/config.athens.toml file and point Executable.Path to the game's "BattleServer.exe" (or specifically AoE II: DE one for AoM) executable (it's portable), for example, 'S:\SteamLibrary\steamapps\common\AoE2DE\BattleServer\BattleServer.exe'.
7. Execute launcher/start_<game_title> script: you will be asked for admin elevation and confirmation of other dialogs as needed, you will also need to allow the connections via the Microsoft Defender Firewall or any other.
8. Repeat the above steps for every PC (except the point 6) you want to play in LAN with by running the launcher, the first PC to launch it will host the "server" and the rest will auto-discover and be prompted to connnect to it.
9. In the game, just host a new lobby via the Multiplayer section. Setting it to public visibility is recommended.
10. If the lobby is Public, they can join directly in the browser or you can Invite friends by searching them by name and sending an invite as needed. If the game a...

v1.13.0-rc.2

What's Changed since last pre-release

Server

• 🐛 Fix: bug making age1 not working.
• 🚧 Update: login data for all age of empires games.

What's coming in the future?

See this.

Sponsors/Donations

• Thanks to @codabrink for the continued monthly sponshorship!

There are multiples ways to help: starring the repo, spreading the word, contributing to the repository, making an issue report, sponsoring me monthly or a one-time donation!

See Github differences v1.13.0-rc.1...v1.13.0-rc.2

Files

The following assets are directly compiled and listed next to the release notes:

• Full:
  • Windows:
    • 10 on x86-64: ..._full_v1.13.0_win10_x86-64.zip
    • 7 on x86-64: ..._full_v1.13.0_win7_x86-64.zip
    • 11 on ARM: ..._full_v1.13.0_win11_arm64.zip
  • Linux:
    • x86-64: ..._full_v1.13.0_linux_x86-64.tar.gz
    • ARM64: ..._full_v1.13.0_linux_arm64.tar.gz
• Launcher:
  • Windows:
    • 10 on x86-64: ..._launcher_v1.13.0_win10_x86-64.zip
    • 7 on x86-64: ..._launcher_v1.13.0_win7_x86-64.zip
    • 11 on ARM: ..._launcher_v1.13.0_win11_arm64.zip
  • Linux:
    • x86-64: ..._launcher_v1.13.0_linux_x86-64.tar.gz
    • ARM64: ..._launcher_v1.13.0_linux_arm64.tar.gz
• Battle Server Manager:
  • Windows:
    • 10 on x86-64: ..._battle-server-manager_v1.13.0_win10_x86-64.zip
    • 7 on x86-64: ..._battle-server-manager_v1.13.0_win7_x86-64.zip
    • 11 on ARM: ..._battle-server-manager_v1.13.0_win11_arm64.zip
  • Linux:
    • x86-64: ..._battle-server-manager_v1.13.0_linux_x86-64.tar.gz
    • ARM64: ..._battle-server-manager_v1.13.0_linux_arm64.tar.gz
• Server:
  • Windows:
    • 10 (IoT), Server (IoT) 2025 on ARM64: ..._server_v1.13.0_win10_arm64.zip
    • 10 (IoT), (Storage) Server 2016, Server IoT 2019 on x86-64: ..._server_v1.13.0_win10_x86-64.zip
    • 7, Server 2008 R2, Home Server 2011, Embedded 7 on x86-64: ..._server_v1.13.0_win7_x86-64.zip
    • 10 (IoT) on x86-32: ..._server_v1.13.0_win10_x86-32.zip
    • 7, Embedded 7, Thin PC on x86-32: ..._server_v1.13.0_win7_x86-32.zip
  • Linux:
    • ARM64: ..._server_v1.13.0_linux_arm64.tar.gz
    • ARM32:
      • ARMv5 (armel): ..._server_v1.13.0_linux_arm-5.tar.gz
      • ARMv6 (sometimes called armhf): ..._server_v1.13.0_linux_arm-6.tar.gz
    • x86-64: ..._server_v1.13.0_linux_x86-64.tar.gz
    • x86-32: ..._server_v1.13.0_linux_x86-32.tar.gz
  • macOS - Monterey (v12): ..._server_v1.13.0_mac.tar.gz

Note: If you are using Antivirus it may flag one or more executables as virus, this is a false positive.

Verification

The verification process ensures that the files you download are the same as the ones that were uploaded by the
maintainer.

1. Download the ageLANLanServer_v1.13.0_checksums.txt and ageLANLanServer_v1.13.0_checksums.txt.sig files.
2. Import the release public key and import it to your keyring if you haven't already.
3. Verify the ageLANServer_v1.13.0_checksums.txt file with the ageLANLanServer_v1.13.0_checksums.txt.sig file.
4. Verify the SHA-256 checksum list inside ageLANServer_v1.13.0_checksums.txt with the downloaded archives.

Simplest way to use it

1. Download the proper full asset.
2. Uncompress it somewhere.
3. Windows Optional: You may need to add the launcher/server binaries to the exception list of your Antivirus.
4. Windows Optional: Unblock the .exe files as explained here
5. If not using the Steam or Xbox launcher, edit the launcher/resources/config.<game_title>.toml file with a text editor (like Notepad) and modify the Client.Executable section to point to the game launcher path. In this case, you also need to modify Client.Path to point to the game's directory. You will need to use a custom launcher (plus what my other repo provides) for 100% offline play.
6. If you are using a custom launcher, (or you are using AoE IV/AoM and don't have AoE II: DE installed) edit the battle-server-manager/resources/config.athens.toml file and point Executable.Path to the game's "BattleServer.exe" (or specifically AoE II: DE one for AoM) executable (it's portable), for example, 'S:\SteamLibrary\steamapps\common\AoE2DE\BattleServer\BattleServer.exe'.
7. Execute launcher/start_<game_title> script: you will be asked for admin elevation and confirmation of other dialogs as needed, you will also need to allow the connections via the Microsoft Defender Firewall or any other.
8. Repeat the above steps for every PC (except the point 6) you want to play in LAN with by running the launcher, the first PC to launch it will host the "server" and the rest will auto-discover and be prompted to connnect to it.
9. In the game, just host a new lobby via the Multiplayer section. Setting it to public visibility is recommended.
10. If the lobby is Public, they can join directly in the browser or you can Invite friends by searching them by name and sending an invite as needed. If the game allows, you can share the link to join the lobby automatically (only works if already in-game).

Help

Look for the Troubleshooting if you have any issues (or QA for any doubt), create an issue or look for other related issues.

v1.13.0-rc.1

Important

AoE I is known not to work, will be fixed in next pre-release

What's Changed

Age of Empires IV: Anniversary Edition support

Added support for this game on Steam and Microsoft Store/Xbox, however, as of writing, has the following specific issues:

• #402
• #403
• #404
• #406
• #407

Authentication

The server is introducing authentication options so the server owner has the option to properly authenticate the user, configurable as follows:

• required: the server will authenticate the user with the official servers everytime.
• cached: the server will force the clients to authenticate with the official server at least once every 30 days. The cache would be tied to the user platform user id (as the other info saved per user).
• adaptive: the server will use cached if internet is detected on the server or disabled otherwise.
• disabled (default). No authentication as before this release. The server's owner (and to a lesser degree their clients) is/are legally responsible and must ensure that they own the game (and any DLC's) in the proper platform.

This is necessary to support AoE IV game as the server can decide which DLC's the user has access to and give the users the choice on how strict the server is so the repo is not seen as a piracy tool but rather as a way to keep games alive and allow true offline functionality

General

• 🔝 Enhancement: added support for age4 game.
• Enhancement: now client requests include the header User-Agent to ageLANServer/1.0 so it's identifiable as this software to others.

Server

• 🔝Enhancement: added support authentication with the new config Authentication key (default 'disabled'), not compatible with GeneratePlatformUserId unless it is 'disabled'.
• 🔝Enhancement: added support for AoM update 18.65484 including the modifications to Gauntlet mode
• 🔝Enhancement: improved support for managing user items and now are saved persistently.
• 🆕 Enhancement: added support for groups (used in age4).
• 🆕 Enhancement: added support for lobbies/groups to change leader.
• 🆕 Enhancement: Added support for user presence (including its properties).
• 🆕 Enhancement: Added support for user properties.
• 🆕 Enhancement: Added partial support for managing item loadouts.
• Enhancement: added Playfab support for age4.
• Enhancement: now LAN lobbies are detected more reliable and faster when hosting them.
• 🐛 Fix: persistent data not being read correctly
• 🐛 Fix: Log setting/param being ignored.
• 🐛 Fix: lobbies/groups now properly return when is observing enabled and the observer password.
• 🐛 Fix: cloud/getFileURL when there are not URLs.
• 🐛 Fix: item/getInventoryByProfileIDs now properly return correct location IDs.

Launcher

• 🆕 Enhancement: add option Server.StartWithoutConfirmation so pressing enter is not needed when starting a server if no other servers are found.
• 🆕 Enhancement: added option to choose not to add the certificate to game's store with Config.Certificate.CanTrustInGame.
• 🐛 Fix: properly restore the configuration at start if the previous unclean finish was a different game.
• 🚧 Update: Renamed Config.CanTrustCertificate to Config.Certificate.CanTrustInPc.

Battle Server Manager

• 🐛 Fix: printing the configuration even without logRoot being passed.

Other

• 🐛 Fix: server/BattleServers.md doc.

Developer changes

• 🆕 Enhancement: integrated the building for Windows 7 archives in the CI pipeline with the rest of archives.
• 🐛 Fix: missing generateGoreleaserConfig.go in CodeQL.
• 🆕 Enhancement: added go.work and go.work.sum and removed go.work.template to simplify and make it more predictable.
• 🚧 Update: Go minimum version updated to 1.26.
• 🚧 Update: golang dependencies updated.

What's coming in the future?

See this.

Sponsors/Donations

• Thanks to @codabrink for the continued monthly sponshorship!

There are multiples ways to help: starring the repo, spreading the word, contributing to the repository, making an issue report, sponsoring me monthly or a one-time donation!

See Github differences v1.12.3...v1.13.0-rc.1

Files

The following assets are directly compiled and listed next to the release notes:

• Full:
  • Windows:
    • 10 on x86-64: ..._full_v1.13.0_win10_x86-64.zip
    • 7 on x86-64: ..._full_v1.13.0_win7_x86-64.zip
    • 11 on ARM: ..._full_v1.13.0_win11_arm64.zip
  • Linux:
    • x86-64: ..._full_v1.13.0_linux_x86-64.tar.gz
    • ARM64: ..._full_v1.13.0_linux_arm64.tar.gz
• Launcher:
  • Windows:
    • 10 on x86-64: ..._launcher_v1.13.0_win10_x86-64.zip
    • 7 on x86-64: ..._launcher_v1.13.0_win7_x86-64.zip
    • 11 on ARM: ..._launcher_v1.13.0_win11_arm64.zip
  • Linux:
    • x86-64: ..._launcher_v1.13.0_linux_x86-64.tar.gz
    • ARM64: ..._launcher_v1.13.0_linux_arm64.tar.gz
• Battle Server Manager:
  • Windows:
    • 10 on x86-64: ..._battle-server-manager_v1.13.0_win10_x86-64.zip
    • 7 on x86-64: ..._battle-server-manager_v1.13.0_win7_x86-64.zip
    • 11 on ARM: ..._battle-server-manager_v1.13.0_win11_arm64.zip
  • Linux:
    • x86-64: ..._battle-server-manager_v1.13.0_linux_x86-64.tar.gz
    • ARM64: ..._battle-server-manager_v1.13.0_linux_arm64.tar.gz
• Server:
  • Windows:
    • 10 (IoT), Server (IoT) 2025 on ARM64: ..._server_v1.13.0_win10_arm64.zip
    • 10 (IoT), (Storage) Server 2016, Server IoT 2019 on x86-64: ..._server_v1.13.0_win10_x86-64.zip
    • 7, Server 2008 R2, Home Server 2011, Embedded 7 on x86-64: ..._server_v1.13.0_win7_x86-64.zip
    • 10 (IoT) on x86-32: ..._server_v1.13.0_win10_x86-32.zip
    • 7, Embedded 7, Thin PC on x86-32: ..._server_v1.13.0_win7_x86-32.zip
  • Linux:
    • ARM64: ..._server_v1.13.0_linux_arm64.tar.gz
    • ARM32:
      • ARMv5 (armel): ..._server_v1.13.0_linux_arm-5.tar.gz
      • ARMv6 (sometimes called armhf): ..._server_v1.13.0_linux_arm-6.tar.gz
    • x86-64: ..._server_v1.13.0_linux_x86-64.tar.gz
    • x86-32: ..._server_v1.13.0_linux_x86-32.tar.gz
  • macOS - Monterey (v12): ..._server_v1.13.0_mac.tar.gz

Note: If you are using Antivirus it may flag one or more executables as virus, this is a false positive.

Verification

The verification process ensures that the files you download are the same as the ones that were uploaded by the
maintainer.

1. Download the ageLANLanServer_v1.13.0_checksums.txt and ageLANLanServer_v1.13.0_checksums.txt.sig files.
2. Import the release public key and import it to your keyring if you haven't already.
3. Verify the ageLANServer_v1.13.0_checksums.txt file with the ageLANLanServer_v1.13.0_checksums.txt.sig file.
4. Verify the SHA-256 checksum list inside ageLANServer_v1.13.0_checksums.txt with the downloaded archives.

Simplest way to use it

1. Download the proper full asset.
2. Uncompress it somewhere.
3. Windows Optional: You may need to add the launcher/server binaries to the exception list of your Antivirus.
4. Windows Optional: Unblock the .exe files as explained here
5. If not using the Steam or Xbox launcher, edit the launcher/resources/config.<game_title>.toml file with a text editor (like Notepad) and modify the Client.Executable section to point to the game launcher path. In this case, you also need to modify Client.Path to point to the game's directory. You will need to use a custom launcher (plus what my other repo provides) for 100% offline play.
6. If you are using a custom launcher, (or you are using AoE IV/AoM and don't have AoE II: DE installed) edit the battle-server-manager/resources/config.athens.toml file and point Executable.Path to the game's "BattleServer.exe" (or specifically AoE II: DE one for AoM) executable (it's portable), for example, 'S:\SteamLibrary\steamapps\common\AoE2DE\BattleServer\BattleServer.exe'.
7. Execute launcher/start_<game_title> script: you will be asked for admin elevation and confirmation of other dialogs as needed, you will also need to allow the connections via the Microsoft Defender Firewall or any other.
8. Repeat the above steps for every PC (except the point 6) you want to play in LAN with by running the launcher, the first PC to launch it will host the "server" and the rest will auto-discover and be prompted to connnect to it.
9. In the game, just host a new lobby via the Multiplayer section. Setting it to public visibility is recommended.
10. If the lobby is Public, they can join directly in the browser or you can Invite friends by searching them by name and sending an invite as needed. If the game allows, you can share the link to join the lobby automatically (only works if already in-game).

Help

Look for the Troubleshooting if you have any issues (or QA for any doubt), create an issue or look for other related issues.

v1.12.3

What's Changed

Server

• 🔝 Enhancement: Added support for AoE 2 - 169123 (update of The Last Chieftains DLC).

What's coming in the future?

See this.

Sponsors/Donations

• Thanks to @codabrink for the continued monthly sponshorship and for AoE-Archiver that enables easy auto-configuration of this project in combination with the companion and steam emu for AoE II: DE on Windows!

There are multiples ways to help: starring the repo, spreading the word, contributing to the repository, making an issue report, sponsoring me monthly or a one-time donation!

See Github differences v1.12.2...v1.12.3

Files

Assets

The following assets are directly compiled and listed next to the release notes:

• Full:
  • Windows:
    • 10 on x86-64: ..._full_1.12.3_win10_x86-64.zip
    • 11 on ARM: ..._full_1.12.3_win11_arm64.zip
  • Linux:
    • x86-64: ..._full_1.12.3_linux_x86-64.tar.gz
    • ARM64: ..._full_1.12.3_linux_arm64.tar.gz
• Launcher:
  • Windows:
    • 10 on x86-64: ..._launcher_1.12.3_win10_x86-64.zip
    • 11 on ARM: ..._launcher_1.12.3_win11_arm64.zip
  • Linux:
    • x86-64: ..._launcher_1.12.3_linux_x86-64.tar.gz
    • ARM64: ..._launcher_1.12.3_linux_arm64.tar.gz
• Battle Server Manager:
  • Windows:
    • 10 on x86-64: ..._battle-server-manager_1.12.3_win10_x86-64.zip
    • 11 on ARM: ..._battle-server-manager_1.12.3_win11_arm64.zip
  • Linux:
    • x86-64: ..._battle-server-manager_1.12.3_linux_x86-64.tar.gz
    • ARM64: ..._battle-server-manager_1.12.3_linux_arm64.tar.gz
• Server:
  • Windows:
    • 10 (IoT), Server (IoT) 2025 on ARM64: ..._server_1.12.3_win10_arm64.zip
    • 10 (IoT), (Storage) Server 2016, Server IoT 2019 on x86-64: ..._server_1.12.3_win10_x86-64.zip
    • 10 (IoT) on x86-32: ..._server_1.12.3_win10_x86-32.zip
  • Linux:
    • ARM64: ..._server_1.12.3_linux_arm64.tar.gz
    • ARM32:
      • ARMv5 (armel): ..._server_1.12.3_linux_arm-5.tar.gz
      • ARMv6 (sometimes called armhf): ..._server_1.12.3_linux_arm-6.tar.gz
    • x86-64: ..._server_1.12.3_linux_x86-64.tar.gz
    • x86-32: ..._server_1.12.3_linux_x86-32.tar.gz
  • macOS - Monterey (v12): ..._server_1.12.3_mac.tar.gz

Note: If you are using Antivirus it may flag one or more executables as virus, this is a false positive.

Verification

The verification process ensures that the files you download are the same as the ones that were uploaded by the
maintainer.

1. Download the ageLANLanServer_1.12.3_checksums.txt and ageLANLanServer_1.12.3_checksums.txt.sig files.
2. Import the release public key and import it to your keyring if you haven't already.
3. Verify the ageLANServer_1.12.3_checksums.txt file with the ageLANLanServer_1.12.3_checksums.txt.sig file.
4. Verify the SHA-256 checksum list inside ageLANServer_1.12.3_checksums.txt with the downloaded archives.

Windows 7

These archives are compiled manually and attached below:

• Full:
  • Windows:
    • 7 on x86-64: ageLANServer_full_1.12.3_win7_x86-64.zip
• Launcher:
  • Windows:
    • 7 on x86-64: ageLANServer_launcher_1.12.3_win7_x86-64.zip
• Battle Server Manager:
  • Windows:
    • 7 on x86-64: ageLANServer_battle-server-manager_1.12.3_win7_x86-64.zip
• Server:
  • Windows:
    • 7, Server 2008 R2, Home Server 2011, Embedded 7 on x86-64: ageLANServer_server_1.12.3_win7_x86-64.zip
    • 7, Embedded 7, Thin PC on x86-32: ageLANServer_server_1.12.3_win7_x86-32.zip

Note: If you are using Antivirus it may flag one or more executables as virus, this is a false positive.
Note 2: URL shortener is only used to track number of downloads.

Simplest way to use it

1. Download the proper full asset.
2. Uncompress it somewhere.
3. Windows Optional: You may need to add the launcher/server binaries to the exception list of your Antivirus.
4. Windows Optional: Unblock the .exe files as explained here
5. If not using the Steam or Xbox launcher, edit the launcher/resources/config.<game_title>.toml file with a text editor (like Notepad) and modify the Client.Executable section to point to the game launcher path. In this case, you also need to modify Client.Path to point to the game's directory. You will need to use a custom launcher (plus what my other repo provides) for 100% offline play.
6. If you are using a custom launcher, (or you are using AoM and don't have AoE II: DE installed on Steam) edit the battle-server-manager/resources/config.athens.toml file and point Executable.Path to the game's "BattleServer.exe" (or specifically AoE II: DE one for AoM) executable (it's portable), for example, 'S: \SteamLibrary\steamapps\common\AoE2DE\BattleServer\BattleServer.exe'.
7. Execute launcher/start_<game_title> script: you will be asked for admin elevation and confirmation of other dialogs as needed, you will also need to allow the connections via the Microsoft Defender Firewall or any other.
8. Repeat the above steps for every PC (except the point 6) you want to play in LAN with by running the launcher, the first PC to launch it will host the "server" and the rest will auto-discover and be prompted to connnect to it.
9. In the game, just host a new lobby via the Multiplayer section. Setting it to public visibility is recommended.
10. If the lobby is Public, they can join directly in the browser or you can Invite friends by searching them by name and sending an invite as needed. If the game allows, you can share the link to join the lobby automatically (only works if already in-game).

Help

Look for the Troubleshooting if you have any issues (or QA for any doubt), create an issue or look for other related issues.

v1.12.2

What's Changed

General

• 🐛 Fix: launcher and server may not work without internet access.

Launcher

• 🐛 Fix: not showing alternate IPs when detecting servers if it is a single one.

Other

• 🐛 Fix: win11-only archives being named win10.

What's coming in the future?

See this.

Sponsors/Donations

• Thanks to @codabrink for the continued monthly sponshorship and for AoE-Archiver that enables easy auto-configuration of this project in combination with the companion and steam emu for AoE II: DE on Windows!

There are multiples ways to help: starring the repo, spreading the word, contributing to the repository, making an issue report, sponsoring me monthly or a one-time donation!

See Github differences v1.12.1...v1.12.2

Files

Assets

The following assets are directly compiled and listed next to the release notes:

• Full:
  • Windows:
    • 10 on x86-64: ..._full_1.12.2_win10_x86-64.zip
    • 11 on ARM: ..._full_1.12.2_win11_arm64.zip
  • Linux:
    • x86-64: ..._full_1.12.2_linux_x86-64.tar.gz
    • ARM64: ..._full_1.12.2_linux_arm64.tar.gz
• Launcher:
  • Windows:
    • 10 on x86-64: ..._launcher_1.12.2_win10_x86-64.zip
    • 11 on ARM: ..._launcher_1.12.2_win11_arm64.zip
  • Linux:
    • x86-64: ..._launcher_1.12.2_linux_x86-64.tar.gz
    • ARM64: ..._launcher_1.12.2_linux_arm64.tar.gz
• Battle Server Manager:
  • Windows:
    • 10 on x86-64: ..._battle-server-manager_1.12.2_win10_x86-64.zip
    • 11 on ARM: ..._battle-server-manager_1.12.2_win11_arm64.zip
  • Linux:
    • x86-64: ..._battle-server-manager_1.12.2_linux_x86-64.tar.gz
    • ARM64: ..._battle-server-manager_1.12.2_linux_arm64.tar.gz
• Server:
  • Windows:
    • 10 (IoT), Server (IoT) 2025 on ARM64: ..._server_1.12.2_win10_arm64.zip
    • 10 (IoT), (Storage) Server 2016, Server IoT 2019 on x86-64: ..._server_1.12.2_win10_x86-64.zip
    • 10 (IoT) on x86-32: ..._server_1.12.2_win10_x86-32.zip
  • Linux:
    • ARM64: ..._server_1.12.2_linux_arm64.tar.gz
    • ARM32:
      • ARMv5 (armel): ..._server_1.12.2_linux_arm-5.tar.gz
      • ARMv6 (sometimes called armhf): ..._server_1.12.2_linux_arm-6.tar.gz
    • x86-64: ..._server_1.12.2_linux_x86-64.tar.gz
    • x86-32: ..._server_1.12.2_linux_x86-32.tar.gz
  • macOS - Monterey (v12): ..._server_1.12.2_mac.tar.gz

Note: If you are using Antivirus it may flag one or more executables as virus, this is a false positive.

Verification

The verification process ensures that the files you download are the same as the ones that were uploaded by the
maintainer.

1. Download the ageLANLanServer_1.12.2_checksums.txt and ageLANLanServer_1.12.2_checksums.txt.sig files.
2. Import the release public key and import it to your keyring if you haven't already.
3. Verify the ageLANServer_1.12.2_checksums.txt file with the ageLANLanServer_1.12.2_checksums.txt.sig file.
4. Verify the SHA-256 checksum list inside ageLANServer_1.12.2_checksums.txt with the downloaded archives.

Windows 7

These archives are compiled manually and attached below:

• Full:
  • Windows:
    • 7 on x86-64: ageLANServer_full_1.12.2_win7_x86-64.zip
• Launcher:
  • Windows:
    • 7 on x86-64: ageLANServer_launcher_1.12.2_win7_x86-64.zip
• Battle Server Manager:
  • Windows:
    • 7 on x86-64: ageLANServer_battle-server-manager_1.12.2_win7_x86-64.zip
• Server:
  • Windows:
    • 7, Server 2008 R2, Home Server 2011, Embedded 7 on x86-64: ageLANServer_server_1.12.2_win7_x86-64.zip
    • 7, Embedded 7, Thin PC on x86-32: ageLANServer_server_1.12.2_win7_x86-32.zip

Note: If you are using Antivirus it may flag one or more executables as virus, this is a false positive.
Note 2: URL shortener is only used to track number of downloads.

Simplest way to use it

1. Download the proper full asset.
2. Uncompress it somewhere.
3. Windows Optional: You may need to add the launcher/server binaries to the exception list of your Antivirus.
4. Windows Optional: Unblock the .exe files as explained here
5. If not using the Steam or Xbox launcher, edit the launcher/resources/config.<game_title>.toml file with a text editor (like Notepad) and modify the Client.Executable section to point to the game launcher path. In this case, you also need to modify Client.Path to point to the game's directory. You will need to use a custom launcher (plus what my other repo provides) for 100% offline play.
6. If you are using a custom launcher, (or you are using AoM and don't have AoE II: DE installed on Steam) edit the battle-server-manager/resources/config.athens.toml file and point Executable.Path to the game's "BattleServer.exe" (or specifically AoE II: DE one for AoM) executable (it's portable), for example, 'S: \SteamLibrary\steamapps\common\AoE2DE\BattleServer\BattleServer.exe'.
7. Execute launcher/start_<game_title> script: you will be asked for admin elevation and confirmation of other dialogs as needed, you will also need to allow the connections via the Microsoft Defender Firewall or any other.
8. Repeat the above steps for every PC (except the point 6) you want to play in LAN with by running the launcher, the first PC to launch it will host the "server" and the rest will auto-discover and be prompted to connnect to it.
9. In the game, just host a new lobby via the Multiplayer section. Setting it to public visibility is recommended.
10. If the lobby is Public, they can join directly in the browser or you can Invite friends by searching them by name and sending an invite as needed. If the game allows, you can share the link to join the lobby automatically (only works if already in-game).

Help

Look for the Troubleshooting if you have any issues (or QA for any doubt), create an issue or look for other related issues.

v1.12.1

What's Changed

General

• 🐛 Fix: Auxiliar binaries names.

What's coming in the future?

See this.

Sponsors/Donations

• Thanks to @codabrink for the continued monthly sponshorship and for AoE-Archiver that enables easy auto-configuration of this project in combination with the companion and steam emu for AoE II: DE on Windows!

There are multiples ways to help: starring the repo, spreading the word, contributing to the repository, making an issue report, sponsoring me monthly or a one-time donation!

See Github differences v1.12.0...v1.12.1

Files

Assets

The following assets are directly compiled and listed next to the release notes:

• Full:
  • Windows:
    • 10 on x86-64: ..._full_1.12.1_win10_x86-64.zip
    • 11 on ARM: ..._full_1.12.1_win10_arm64.zip
  • Linux:
    • x86-64: ..._full_1.12.1_linux_x86-64.tar.gz
    • ARM64: ..._full_1.12.1_linux_arm64.tar.gz
• Launcher:
  • Windows:
    • 10 on x86-64: ..._launcher_1.12.1_win10_x86-64.zip
    • 11 on ARM: ..._launcher_1.12.1_win10_arm64.zip
  • Linux:
    • x86-64: ..._launcher_1.12.1_linux_x86-64.tar.gz
    • ARM64: ..._launcher_1.12.1_linux_arm64.tar.gz
• Battle Server Manager:
  • Windows:
    • 10 on x86-64: ..._battle-server-manager_1.12.1_win10_x86-64.zip
    • 11 on ARM: ..._battle-server-manager_1.12.1_win10_arm64.zip
  • Linux:
    • x86-64: ..._battle-server-manager_1.12.1_linux_x86-64.tar.gz
    • ARM64: ..._battle-server-manager_1.12.1_linux_arm64.tar.gz
• Server:
  • Windows:
    • 10 (IoT), Server (IoT) 2025 on ARM64: ..._server_1.12.1_win10_arm64.zip
    • 10 (IoT), (Storage) Server 2016, Server IoT 2019 on x86-64: ..._server_1.12.1_win10_x86-64.zip
    • 10 (IoT) on x86-32: ..._server_1.12.1_win10_x86-32.zip
  • Linux:
    • ARM64: ..._server_1.12.1_linux_arm64.tar.gz
    • ARM32:
      • ARMv5 (armel): ..._server_1.12.1_linux_arm-5.tar.gz
      • ARMv6 (sometimes called armhf): ..._server_1.12.1_linux_arm-6.tar.gz
    • x86-64: ..._server_1.12.1_linux_x86-64.tar.gz
    • x86-32: ..._server_1.12.1_linux_x86-32.tar.gz
  • macOS - Monterey (v12): ..._server_1.12.1_mac.tar.gz

Note: If you are using Antivirus it may flag one or more executables as virus, this is a false positive.

Verification

The verification process ensures that the files you download are the same as the ones that were uploaded by the
maintainer.

1. Download the ageLANLanServer_1.12.1_checksums.txt and ageLANLanServer_1.12.1_checksums.txt.sig files.
2. Import the release public key and import it to your keyring if you haven't already.
3. Verify the ageLANServer_1.12.1_checksums.txt file with the ageLANLanServer_1.12.1_checksums.txt.sig file.
4. Verify the SHA-256 checksum list inside ageLANServer_1.12.1_checksums.txt with the downloaded archives.

Other

These archives are compiled manually and attached below:

• Full:
  • Windows:
    • 7 on x86-64: ageLANServer_full_1.12.1_win7_x86-64.zip
• Launcher:
  • Windows:
    • 7 on x86-64: ageLANServer_launcher_1.12.1_win7_x86-64.zip
• Battle Server Manager:
  • Windows:
    • 7 on x86-64: ageLANServer_battle-server-manager_1.12.1_win7_x86-64.zip
• Server:
  • Windows:
    • 7, Server 2008 R2, Home Server 2011, Embedded 7 on x86-64: ageLANServer_server_1.12.1_win7_x86-64.zip
    • 7, Embedded 7, Thin PC on x86-32: ageLANServer_server_1.12.1_win7_x86-32.zip

Note: If you are using Antivirus it may flag one or more executables as virus, this is a false positive.
Note 2: URL shortener is only used to track number of downloads.

Simplest way to use it

1. Download the proper full asset.
2. Uncompress it somewhere.
3. Windows Optional: You may need to add the launcher/server binaries to the exception list of your Antivirus.
4. Windows Optional: Unblock the .exe files as explained here
5. If not using the Steam or Xbox launcher, edit the launcher/resources/config.<game_title>.toml file with a text editor (like Notepad) and modify the Client.Executable section to point to the game launcher path. In this case, you also need to modify Client.Path to point to the game's directory. You will need to use a custom launcher (plus what my other repo provides) for 100% offline play.
6. If you are using a custom launcher, (or you are using AoM and don't have AoE II: DE installed on Steam) edit the battle-server-manager/resources/config.athens.toml file and point Executable.Path to the game's "BattleServer.exe" (or specifically AoE II: DE one for AoM) executable (it's portable), for example, 'S: \SteamLibrary\steamapps\common\AoE2DE\BattleServer\BattleServer.exe'.
7. Execute launcher/start_<game_title> script: you will be asked for admin elevation and confirmation of other dialogs as needed, you will also need to allow the connections via the Microsoft Defender Firewall or any other.
8. Repeat the above steps for every PC (except the point 6) you want to play in LAN with by running the launcher, the first PC to launch it will host the "server" and the rest will auto-discover and be prompted to connnect to it.
9. In the game, just host a new lobby via the Multiplayer section. Setting it to public visibility is recommended.
10. If the lobby is Public, they can join directly in the browser or you can Invite friends by searching them by name and sending an invite as needed. If the game allows, you can share the link to join the lobby automatically (only works if already in-game).

Help

Look for the Troubleshooting if you have any issues (or QA for any doubt), create an issue or look for other related issues.

v1.12.0

Caution

There is a bug in the creation of server, launcher (and full) archives, use v1.12.1 instead.

What's Changed

Age of Mythology: Retold

🆕 Arena of the Gods - Challenge Mode

• 🔝 Challenge mode is now fully implemented:
  • 🔝 Lives are infinite.
  • 🔝 You have access to all legends.
  • 🔝 You are max level (99) by default.

Other

• 🔝 Favor stash is now truly infinite.

Persistent data

The data for each player is saved in the server in resources/userData/<PLATFORM>_<PLATFORM_USER_ID>.json and initially
it has support for the following:

• 🔝 Player profile icon.
• 🆕 Player stats.
• 🆕 Challenge mode progress in AoM: RT.

General

System Requirements

• 🔝 Enhancement: full support for Windows 7, 8, and 8.1 (and equivalent). See Files -> Other for the links.
• 🚧 Update: macOS minimum version changed from Big Sur (v11) to Monterey (v12).

Other

• 🐛 Fix: PID lock trying to kill processes not belonging to us.
• 🐛 Fix: finding process on Windows no longer errors out if process does not exist.
• 🐛 Fix: Bug report template now includes AoM: RT.
• 🚧 Update: archive format standardized - Windows now always uses .zip and other platforms use .tar.gz.
• 🚧 Update: windows archives changed from using win to win7, win10 and win11 indicating the minimum versions
  required.

Launcher

• 🔝 Enhancement: added Server.SingleAutoSelect config setting (and serverSingleAutoSelect argument), false by
  default. If true, it will automatically select the server if only one was discovered.
• 🔝 Enhancement: improved performance of server discovery by ~1s.
• 🔝 Enhancement: host cache is now properly used when checking if a host was a LAN server increasing performance.
• 🔝 Enhancement: check game CA if certificate needs adding, like with the regular CA certificate.
• 🆕 Enhancement: when logging is enabled, configuration files data is now written to logs.
• 🆕 Enhancement: log reason why the server's certificate cannot be read in advanced logging.
• 🆕 Enhancement: isolation settings now support 'required' value which resolves to true if using the official
  launcher,
  false otherwise.
• 🐛 Fix: fix sometimes not detecting the server and memory related leaks.
• 🐛 Fix: exit code data race.
• 🐛 Fix: interoperability with AgeFakeHost.dll.
• 🐛 Fix: stop the program and tell the user if an existing config file cannot be read instead of continuing (mostly
  silent) with defaults.
• 🚧 Update: Config.IsolateMetadata and Config.IsolateProfiles moved from general config to game config.
• 🚧 Update: isolation is now required when using an official launcher to prevent issues.

Server

• 🆕 Enhancement: implemented updating user profile data (avatar icon, player stats).
• 🐛 Fix: data race in session model.
• 🚧 Update: gauntlet.json and gauntlet_mission_pools.json added for Challenge mode configuration.
• 🚧 Update: fixed link to known_blessings.json in README.

Developer changes

• 🆕 Enhancement: Goreleaser configuration is now generated.
• 🆕 Server enhancement: games now define their functionality more generically with interfaces instead of structs,
  allowing
  games to better define specific functionality.

• 🆕 Enhancement: replace OS-specific debug commands with a Go script and cache tasks.
• 🚧 Update: use local viper instance, unmarshal to struct and set defaults.
• 🚧 Update: Taskfile.debug.yml commands renamed (e.g., debug-prepare-server → debug:prepare-server).
• 🚧 Update: DEVELOPMENT.md updated with new build instructions and Windows 7/8 requirements.
• 🚧 Update: Go minimum version updated to 1.25.
• 🚧 Update: golang dependencies updated.

What's coming in the future?

See this.

Sponsors/Donations

• Thanks to @codabrink for the continued monthly sponshorship!

There are multiples ways to help: starring the repo, spreading the word, contributing to the repository, making an issue report, sponsoring me monthly or a one-time donation!

See Github differences v1.11.2...v1.12.0

Files

Assets

The following assets are directly compiled and listed next to the release notes:

• Full:
  • Windows:
    • 10 on x86-64: ..._full_1.12.0_win10_x86-64.zip
    • 11 on ARM: ..._full_1.12.0_win11_arm64.zip
  • Linux:
    • x86-64: ..._full_1.12.0_linux_x86-64.tar.gz
    • ARM64: ..._full_1.12.0_linux_arm64.tar.gz
• Launcher:
  • Windows:
    • 10 on x86-64: ..._launcher_1.12.0_win10_x86-64.zip
    • 11 on ARM: ..._launcher_1.12.0_win11_arm64.zip
  • Linux:
    • x86-64: ..._launcher_1.12.0_linux_x86-64.tar.gz
    • ARM64: ..._launcher_1.12.0_linux_arm64.tar.gz
• Battle Server Manager:
  • Windows:
    • 10 on x86-64: ..._battle-server-manager_1.12.0_win10_x86-64.zip
    • 11 on ARM: ..._battle-server-manager_1.12.0_win11_arm64.zip
  • Linux:
    • x86-64: ..._battle-server-manager_1.12.0_linux_x86-64.tar.gz
    • ARM64: ..._battle-server-manager_1.12.0_linux_arm64.tar.gz
• Server:
  • Windows:
    • 10 (IoT), Server (IoT) 2025 on ARM64: ..._server_1.12.0_win10_arm64.zip
    • 10 (IoT), (Storage) Server 2016, Server IoT 2019 on x86-64: ..._server_1.12.0_win10_x86-64.zip
    • 10 (IoT) on x86-32: ..._server_1.12.0_win10_x86-32.zip
  • Linux:
    • ARM64: ..._server_1.12.0_linux_arm64.tar.gz
    • ARM32:
      • ARMv5 (armel): ..._server_1.12.0_linux_arm-5.tar.gz
      • ARMv6 (sometimes called armhf): ..._server_1.12.0_linux_arm-6.tar.gz
    • x86-64: ..._server_1.12.0_linux_x86-64.tar.gz
    • x86-32: ..._server_1.12.0_linux_x86-32.tar.gz
  • macOS - Monterey (v12): ..._server_1.12.0_mac.tar.gz

Note: If you are using Antivirus it may flag one or more executables as virus, this is a false positive.

Verification

The verification process ensures that the files you download are the same as the ones that were uploaded by the
maintainer.

1. Download the ageLANLanServer_1.12.0_checksums.txt and ageLANLanServer_1.12.0_checksums.txt.sig files.
2. Import the release public key and import it to your keyring if you haven't already.
3. Verify the ageLANServer_1.12.0_checksums.txt file with the ageLANLanServer_1.12.0_checksums.txt.sig file.
4. Verify the SHA-256 checksum list inside ageLANServer_1.12.0_checksums.txt with the downloaded archives.

Other

These archives are compiled manually and attached below:

• Full:
  • Windows:
    • 7 on x86-64: ageLANServer_full_1.12.0_win7_x86-64.zip
• Launcher:
  • Windows:
    • 7 on x86-64: ageLANServer_launcher_1.12.0_win7_x86-64.zip
• Battle Server Manager:
  • Windows:
    • 7 on x86-64: ageLANServer_battle-server-manager_1.12.0_win7_x86-64.zip
• Server:
  • Windows:
    • 7, Server 2008 R2, Home Server 2011, Embedded 7 on x86-64: ageLANServer_server_1.12.0_win7_x86-64.zip
    • 7, Embedded 7, Thin PC on x86-32: ageLANServer_server_1.12.0_win7_x86-32.zip

Note: If you are using Antivirus it may flag one or more executables as virus, this is a false positive.
Note 2: URL shortener is only used to track number of downloads.

Simplest way to use it

1. Download the proper full asset.
2. Uncompress it somewhere.
3. Windows Optional: You may need to add the launcher/server binaries to the exception list of your Antivirus.
4. Windows Optional: Unblock the .exe files as explained here
5. If not using the Steam or Xbox launcher, edit the launcher/resources/config.<game_title>.toml file with a text editor (like Notepad) and modify the Client.Executable section to point to the game launcher path. In this case, you also need to modify Client.Path to point to the game's directory. You will need to use a custom launcher (plus what my other repo provides) for 100% offline play.
6. If you are using a custom launcher, (or you are using AoM and don't have AoE II: DE installed on Steam) edit the battle-server-manager/resources/config.athens.toml file and point Executable.Path to the game's "BattleServer.exe" (or specifically AoE II: DE one for AoM) executable (it's portable), for example, 'S: \SteamLibrary\steamapps\common\AoE2DE\BattleServer\BattleServer.exe'.
7. Execute launcher/start_<game_title> script: you will be asked for admin elevation and confirmation of other dialogs as needed, you will also need to allow the connections via the Microsoft Defender Firewall or any other.
8. Repeat the above steps for every PC (except the point 6) you want to play in LAN with by running the launcher, the first PC to launch it will host the "server" and the rest will auto-discover and be prompted to connnect to it.
9. In the game, just host a new lobby via the Multiplayer section. Setting it to public visibility is recommended.
10. If the lobby is Public, they can join directly in the browser or you can Invite friends by searching them by name and sending an invite as needed. If the game allows, you can share the link to join the lobby automatically (only works if already in-game).

Help

Look for the [Troubleshooting](https://github.com/luskaner/ageLANServe...