v2.0.0-beta.2

[luskaner]

What's Changed

Note: Beta 1 released was removed due to serious bugs.

Since last stable version

🎮 General

• 🚧 Update: Renamed project to Age Server. This change was made in order to clarify the server works outside LAN too.
• 🚧 Update: Lifted TOS restriction to use the game only in a LAN environment.
• 🚧 Update: Removed unimplemented features section in main README.md as now everything in the API is in scope.
• 🐛 Fix: Properly handle environment variable keys with mixed case (e.g. Ports.Bs is preserved instead of lowercased).
• 🐛 Fix: Handle unhandled errors and resource leaks across cmdlog, config service, announce and match content download.

🖥️ Server

Warning

Don't port over the user data, let the server create it from scratch.

• [EXPERIMENTAL]🔝 Enhancement: Embedded Battle Server reimplementation with auto-start. Have a look at the project in here. Configurable via the config in [Games.<game>.EmbeddedBattleServer]. The server can now start a Battle Server inside its own process when no external one is configured or discovered. This means for the 'Online-like' variant:
  • Simplicity: Battle Server Manager or manually running Battle Server is no longer needed.
  • Native (More compatibility and performance):
    • Non-Windows OSes no longer need a Windows compatibility layer (like Wine) to run a Battle Server.
    • Non-x86_64 CPU archs no longer need to emulate the CPU instructions (for example, using Prism on Windows, FEX on Linux or Rosetta 2 on Mac) of x86_64.
  • Up-to-date: not relying on game-provided battle servers that are outdated with missing features.
  • Open-source: can improve our battle server reimplementation as needed.
  • Reliability: not relying on game-provided battle servers that are, sometimes, buggy.
• [EXPERIMENTAL]🔝 Enhancement: Signing the catalogues is now a config option (Sign.Enabled), off by default. When on, the server re-signs catalogues it serves; users in Sign.PlatformUserIdExceptions get the opposite behavior. Signing allows for the catalogues to be dynamic. GenCert now generated the signing public and private keys. **In order for the client to accept the new signature you must use AgeFakeSignature.dll of https://github.com/luskaner/ageServerLauncherCompanion.
• [EXPERIMENTAL]🔝 Enhancement: Optional replay recording for matches handled by the embedded Battle Server. Configurable in BattleServerReplays key.
• [EXPERIMENTAL]🔝 Enhancement: Implemented AoE 2: DE 1v1 matchmaking with persistence, leaderboard completeness and protocol fixes. If using GeneratePlatformUserId as true it may show a user with multiple entries. Thanks to @Chichimokers.
• [EXPERIMENTAL]🔝 Enhancement: Implemented config GUI. Thanks to @AlvaroGReg.
• 🔝 Enhancement: Improved support for Age of Empires 4: Raiders of the North DLC including the new Crucible COOP mode and civs.
• 🔝 Enhancement: Added configuration option Internet.IP (auto by default) to set a static WAN IP instead of relying of apify service. Only relevant if the server is accessed from the WAN side. Thanks to @bgstack15.
• 🔝 Enhancement: Added configuration option (and flag) Internet.Enabled (enabled by default) to disable the use of features that always require internet. Thanks to @bgstack15.
• 🔝 Enhancement: New icons available for all compatible games. Thanks to anonymous person.
• 🔝 Enhancement: Implemented getNews endpoint so the server can serve news to clients.
• 🔝 Enhancement: Serve multiplayer savegames and replays via /api/MatchContent/ (upload and download endpoints). Configurable in CustomFiles section. Matches can now be restored to be played. Thanks to @DrA1ex
• 🔝Enhancement: AoE 4 now allows to change and save profile. Thanks to anonymous person.
• Enhancement: Migrated to more performance Websocket library.
• 🐛 Fix: AoE 4 no longer crashes when customizing the profile. Thanks to anonymous person.
• 🐛 Fix: multiple websocket fixes.
• 🐛 Fix: Item metadata persistence now keeps source and mtype and never persists the transient is_new flag. Thanks to anonymous person.
• 🐛 Fix: Challenge progress routes covered for AoE 4. Thanks to anonymous person.
• 🐛 Fix: gen-cert self-signed certificates now assign correct KeyUsage and ExtKeyUsage; generated private keys are owner-only (0600).

🎮 Launcher

• 🔝 Enhancement: Added option (and flag) CanUseInternet (default true) to disable the use of features that always require internet.
• 🔝 Enhancement: Moved the text to different sections like Init (implied), Configuration,
  Initial teardown, Execution and final teardown to make operations more understandable.
• 🔝 Enhancement: Make use of modern terminal features like emojis and format with fallback for legacy terminals.
• 🔝 Enhancement: Use a GUI dialog to select server or start one. Can be disabled by setting CanUseDialogs to false.
• 🔝 Enhancement: agent now makes use of the system tray with Exit action and activity status.
• 🔝 Enhancement: agent now shows a notification to indicate the status when exiting.
• 🐛 Fix: A run no longer inherits anything from the previous run and reverts when it should.
• 🐛 Fix: Stop leaking an elevated config-admin-agent after the game exits.
• 🐛 Fix: Session state globals are now protected against data races from signal goroutines.
• 🐛 Fix: response body leak when reading certificate from server.
• 🐛 Fix: UDP server discovery race on shared sockets.
• 🐛 Fix: launcher logger (prefix contamination, swallowed errors, case-sensitive DNS matching, nondeterministic order).
• 🐛 Fix: infinite loop on stdin EOF during server selection.
• 🐛 Fix: Kill fallback no longer pretends to be a second attempt on slow machines.
• 🐛 Fix: postAgentStart polling is bounded and reports failure instead of hanging forever.
• 🪟🐛 Fix: ShellExecuteExW no longer writes into a stack-allocated struct and releases the process handle.

🖥️ Battle Server Manager

• Enhancement: Deterministic non-loopback IP selection for broadcast.
• Enhancement: Port generation and allocation reworked to be more robust and testable.
• 🐛 Fix: Null-safety in broadcast IP calculation and ValidData length checks.
• 🐛 Fix: battle-server-manager bugs covered by a new unit test suite.

Developer changes

• 🔝 Enhancement: Docker compose server and battle-server-manager now use restart: unless-stopped; the Docker entrypoint validates and quotes GAME_ID.
• 🐛 Fix: .gitignore now separates go.work.sum and adds coverage and userData/ patterns.
• 🚧 Update: Go from 1.26.9 to 1.27.3.
• 🚧 Update: Renamed task build to task build-all.
• 🔝Enhancement: task build now builds only the host platform with --single-target.
• 🚧 Update: Removed the standalone battle-server mock (functionality absorbed by the embedded Battle Server). Thanks to @Chichimokers.
• 🔝Enhancement: Dependency injection pattern applied to admin client, revert/executor, config-helper and runRoot, with comprehensive test suites.
• 🔝Enhancement: Exhaustive httptest coverage added for all server routes, models, playfab, textmoderation and WSS.
• Enhancement: Battle server PID check is now optional (ignorePid) to support Docker-like containers in host-like network mode.

See Github differences in v1.15.6...v2.0.0

Help

Create an issue or look for other related issues.

---

This discussion was created from the release v2.0.0-beta.2.