
Welcome to a new update for Age of Empires II: Definitive Edition! With today’s Update we’re delivering a rather massive list of bug fixes, changes, and new features to help keep your experience vibrant! This patch delivers a set of stability improvements and bug fixes, addressing crashes, performance issues, and inconsistencies across both PC and consoles.
Gameplay has been refined with fixes to unit behavior, technologies, and civilization bonuses to ensure mechanics work as intended. Pathfinding and economic interactions, such as Mule Cart positioning, have also been improved for smoother play.
Bugfixing pass for UI, audio, and multiplayer systems, chat, lobbies, civilization selection, and Bluetooth audio quality. Smaller AI behavior changes for campaigns and co-op missions have also been implemented for better reliability.
Additional balance changes adjust unit costs, training times, and civilization bonuses to support a more consistent gameplay experience.
Be sure to dig down into the post below to get all of the smaller details before hopping in-game and checking them out firsthand. Enjoy the update!
Developer Note: We did want to follow up on information we shared in previous patch notes, however, and talk a bit more about Console bugs and the problems some of you have been having with your experience.
We’ve seen that you’ve been scanning PUP information and looking for specifics around some of the problems you’ve been reporting to us, such as crashes, invisible units, and general instability of various kinds as you get further into Console matches. There aren’t bullets highlighting those specific issues because their shared root cause has been less of a bug fix and more of a significant engineering refactor of a few things under the hood, but we’re happy to say that today’s Update should resolve many of these problems for you!
We’ll be monitoring your feedback and looking for anything we need to continue to work on as it comes up. This particular set of problems has been a tricky one for us, as there hasn’t been any kind of quick fix we could make happen, but much heavier low-level engineering work that wound up being needed to address some of the problems you’ve been reporting. This has taken us some time and we know that’s been frustrating for many, and we appreciate both your patience as well as your continued support! As we mentioned in our previous patch notes, we’ve got an increased focus on Console going into the next year and more work we intend to do to further uplift your experience, so this really just kicks off that focus and we’ll be back with an increased set of Console-specific bug fixes and attention in future Updates.
Thanks again to our amazing community members, all of whom have helped to make Age of Empires what it is today!
—The Age of Empires Team
Remember that you’ll need to update your game in the Microsoft Store:
- Open the Microsoft Store.
- Click the [∙ ∙ ∙ ] symbol next to your profile picture.
- Select Downloads and updates.
- Press the Get updates button to automatically detect, download, and install the latest changes to your game!
- Open the game. The title screen should show you on Build 177723.
If you are unable to launch the game after downloading the update, make sure you add (or re-add) the Age of Empires II: Definitive Edition client or folder as an exception to your firewall and antivirus program.
That’s it; you’re ready to play!
Remember that you’ll need to update your game in Steam:
- Open Steam.
- Click on Library to see your games list.
- Click Downloads at the bottom of the Library window.
- [If the new build does not download automatically,] click the Download Now button to manually download the new update.
- Open the game. The title screen should show you on Build 177723.
That’s it; you’re ready to play!
Remember that you’ll need to update your game in the Xbox App for Windows.
- Open the Xbox app.
- Games that are installed show up on the left side of the app.
- Hover over the game or click it, and then select Update.
- [If the new build does not download automatically,] hover over the game, select More Options (…), choose Manage. Under the Files tab, choose the option to Check for Updates.
- Open the game. The title screen should show you on Build 177723.
That’s it; you’re ready to play!
- Under the games tab from the PlayStation Home Screen Locate the game and hover over it. Make sure not to select it!
- While hovering over the game press the Pause button (☰) on your controller.
- In the new pop up menu select the Check for Update option.
- If there is a new update available, this will automatically start the download. If your game is on the most recent version, selecting this option will confirm that information for you.
That’s it; you’re ready to play!
Please note that custom mods may not be compatible with the latest game update. If you are experiencing issues launching or playing the game after downloading the new build, try disabling your installed mods before trying again.
Still having trouble? Visit our support site!
Game

Stability & Performance
- Fixed a crash while viewing a Player Profile if the game was force stopped using the Steam client.
- Fixed a crash happening on 4v4 skirmish games with 8 AI players.
- Fixed a crash on consoles that would occur when pressing Left Bumper on the gamepad while in the Villager radial Build Menu.
- Fixed a crash related to Lou Chuans attacking after the Thunderclap Bombs Unique Technology was researched.
- Fixed a rare crash that would occur when canceling the creation of a Villager at the Town Center.
- Fixed a rare crash where siege units in groups could affect movement speed.
- Fixed a rare crash that could appear if a player tries to click the “Block Player” button while also leaving the post-game statistics screen.
- Fixed performance degradation spikes that occurred whenever a terrain tile was modified.
- Improved game performance when the Building and Aura Range indicator appears for many units and buildings.
- Improved the stability of File Transfers in Custom Games lobbies and prevented players from being kicked upon transfer failures.
- Fixed a crash that reduced the memory usage during map generation.
Achievements
- Fixed the “Can I be Frank with you?” achievement being granted regardless if the “Tours (732)” Co-op Historical Battle has been completed or not.
Graphics
- Fixed Hulk Ships for Byzantines, Italians, Spanish, Portuguese, Armenians, and Georgian civilizations appearing with African ship sails while attacking.
- Reduced the size of some graphics assets (saving ~2GB with EGP installed).
Audio
- Fixed low-quality audio when using Bluetooth devices.
UI
- A new ‘More Content’ section can be accessed from the Main Menu, listing all available owned and not owned content DLCs. DLC that is not owned will also be displayed on the Main Menu screen.
- Fixed an issue where changing lobbies between the Base Game and Return of Rome variant would cause a Civilization to become automatically selected when entering the lobby.
- Fixed an issue where using Mouse and Keyboard on consoles would cause the Search Bar on the Civilization Select screen to be unresponsive.
- Fixed an issue that locked “Women’s History Month Icons” for players that had them unlocked.
- Fixed Civilization Emblem background images found in the Civilization Selection menu appearing blurry and low resolution.
- Fixed Civilization Shield icon not appearing in Ranked and Quickplay lobbies when Civilization is set to Random.
- Fixed Match Settings not appearing on the loading screen for games that used the Time Limit Victory Condition.
- Fixed typo in lobby chat notification after being locked from sending messages. Fixed text: “You cannot send any more chat messages at the moment. Please wait a few seconds and try again.”
- In the Tech Tree menu, Trade Cart icons now appear with regional Civilization icons.
Hotkeys
- Fixed an issue that, when the game is set to Windowed, using an ALT + hotkey combination would produce a Windows beep sound.
- “Select all Town Centers” hotkey now correctly includes Town Centers’ foundations.
PC
- Improved memory usage on PCs.
Xbox
- Improved memory usage on Xbox One and Xbox Series consoles.
- Fixed an issue on Xbox consoles that would allow profiles that do not own the game to launch the title and enter a game match, which would result in a crash.
- Fixed an issue showing player slots as “Ready” (green text) when players set themselves as Ready and then left the lobby.
- Fixed the Map Pool Menu to display the map list on parity with all the other platforms.
- Fixed a crash that would occur after multiple games were played in succession on Xbox One and Xbox Series consoles.
PlayStation
- Fixed an issue showing player slots as “Ready” (green text) when players set themselves as Ready and then left the lobby.
Gameplay

Fixes
- Fixed an issue that allowed dying Monks with Relics to drop the Relic over corners of walls.
- Fixed an issue where Dark Age and Feudal Age Houses would take increased damage from Knights.
- Fixed a rare issue that made Villagers attack their own farms/pastures instead of gathering from them.
- Fixed ‘Going Above and Beyond’ cheat code not applying for Archer upgrades.
- Fixed Jurchens Civilization bonus ‘Siege and fortification technologies cost -75% wood and are researched 100% faster’ not applying to Murder Holes.
- Fixed Oystering Fishing Ships that were garrisoned inside a Dock not firing arrows at enemy ships.
- Fixed projectiles destroying resources such as Gold and Stone Mines when the projectile owner is killed while the projectile is still mid-air.
Campaign

Art of War
- Art of War: ‘Early Economy’: Fixed an issue where the Stockpile 500 Food objective will be marked incomplete if the player spends Food resources after completing.
Campaign Missions
- Arariboia 2: ‘Seeds of Vengeance’: Fixed some units showing as belonging to a wrong civ.
- Liu Bei 1: ‘The Oath of the Peach Garden,’ Legendary: Fixed Yellow Turbans player’s Light Cavalry units not receiving +3 attack bonus before the player completes the ‘X/3 Animals Captured’ objective and still get -3 attack removed when the objective is completed.
Co-op Campaign Missions
- Fixed an issue when loading into a co-op campaign level, the loading screen map preview appeared as Coastal.
Balance Changes

General
- Slinger
- Cost adjusted from 70 food 10 wood → 50 food 25 wood.
- Conversion resistance increased from 0 → 2.
- Champi Warrior-line
- Champi Warrior-line train time reduced from 45/40/26/21 → 42/34/26/21 seconds.
- Champi Runner upgrade cost reduced from 120 food 60 gold → 90 food 60 gold.
- Champi Runner upgrade research time reduced from 50 → 40 seconds.
- Champi Warrior upgrade cost reduced from 200 food 175 gold → 150 food 175 gold.
- Xolotl Warrior
- Now affected by the following technologies: Garland Wars, Holcans, Fabric Shields, Herbalism, Caciques, Butalmapu.
Naval
- Dock maximum number of arrows changed from 5 → 0/3/4/5 in Dark/Feudal/Castle/Imperial Age.
- Dock bonus vs. ships changed from +3 → +0/2/3/4 in Dark/Feudal/Castle/Imperial Age.
- Watch Tower-line bonus vs. ships reduced
- Watch Tower from +6 → +5.
- Guard Tower from +8 → +7.
- Keep from +9 → +8.
- Sea Tower bonus vs. ships reduced from +8 → +5.
Armenians
- Elite Composite Bowman HP increased from 45 → 50.
- Gain access to Siege Ram.
Burgundians
- Economic technology food cost discount civilization bonus increased from 33% → 40%.
- Relics generating food in addition to gold team bonus reduced from 30 food/minute → 20 food/minute.
Inca
- Food discount on military units civilization bonus increased from 5/10/15/20% → 15/20/25/30% in Dark/Feudal/Castle/Imperial Age.
- (Elite) Kamayuk food cost adjusted to be unchanged.
Mapuche
- Foragers drop off more food civilization bonus increased from 20% → 25%.
Muisca
- Settlement discount civilization bonus increased from 25% → 33%.
- (Elite)Temple Guard cost reduced from 80 food 45 gold → 70 food 45 gold.
- (Elite)Temple Guard attack bonus vs. cavalry increased from +3 → +5, Elite from +6 → +8.
- (Elite) Guecha Warrior HP increased from 50 → 55, Elite from 50 → 60.
- Huaracas effect of faster Slinger train time increased from 25% → 50%.
Tupi
- Blackwood Archer train time increased from 14 → 18 seconds (Elite unchanged).
Wei
- (Elite) Tiger Cavalry HP reduced from 115 → 110, Elite from 130 → 125.
- (Elite) Tiger Cavalry train time increased from 15 → 18 seconds.
Lobbies and Matchmaking

General
- Fixed an issue on consoles where empty slots would remain colored Green if a player readies up and the leaves the lobby.
- Fixed Party members having a visible, but non-functioning “Remove” button that appeared next to other player names in Ranked lobbies.
- Fixed “Failed to download match content” message appearing when spectating a custom map.
- Fixed an XS error happening in custom lobbies upon transferring Random Maps or Custom Scenarios including XS files.
- Fixed file transfers for XS scripts failing on restored lobbies.
AI

General
- AI Engine: Fixed AI exploration commands (up-send-scout) sometimes being unintentionally sent to units nearby, rather than the Scout itself.
- AI Engine: Fixed the AI falsely reporting sighted Enemy Gates as archers. (While using players-unit-type-count.)
- AI Engine: Fixed the AI incorrectly reporting Town Centers as Coustilliers if a Treaty is set and it expires.
- AI Engine: Fixed fe-exclude-from-attack-group lists from resetting upon saving and reloading the game.
- AI Engine: Fixed Object-data-next-attack from being falsely 0, preventing the AI from looping Ranged Unit animations and failing to fire when performing hit and run attacks.
- AI Engine: Fixed the AI from attempting to convert Town Centers.
- Fixed an issue making Extreme AI try to set Building Foundations on invalid terrain (like woodlines or mines) when game resources were set to Ultra High.
Pathfinding
- Fixed an issue preventing Villagers from moving towards a SHIFT-queued resource after the initial resource they were gathering depleted.
- Improved consistency on Trebuchets SHIFT-queued movement+attack behavior.
- Improved control groups that consist of single Units following SHIFT-queued commands.
- Improved Lumberjacks pathfinding and prevented them from autonomously picking a different woodline when in large groups.
- Improved Units SHIFT-queued responsiveness when belonging to groups of Units far away from each other.
- Improved Villagers pathfinding upon being tasked to go out of Gates with buildings close to them.
- Increased stopping range for Mule Carts near resources to allow more space for Villagers to path.
Modding

Scenario Editor
- Renamed the “Enable/Disable Attackable” effect to “Enable/Disable Unit Attackable State”.
- Renamed the “Enable/Disable Unit Targeting” effect to “Enable/Disable Unit Targetable State”.
- The “Display Instructions” effect no longer applies the
<TAG>text color to the icon. The “Source Player” field is now used for this option as originally intended.- A new option called “Use Tag Color For Icon” has been added to the “Display Instructions” effect, which will be on by default for scenarios affected by this bug to preserve old behavior.
- Fixed Composite Bowman not appearing as a unit available in the Editor with Italian language selected.
XS Scripting
- Added new XS functions:
- int xsGetLocale()
- Gets the current locale of this player.
- Note: See the Language Constants section of Constants.xs for all values
- string xsGetString(int stringId, bool localized = false)
- Gets a string from the strings file
- string xsGetPlayerAttributeName(int resourceId, bool localized = false)
- Gets the Editor resource name
- string xsGetObjectAttributeName(int attributeId, bool localized = false)
- Gets the Object Attribute name
- string xsGetDamageClassName(int damageClassId, bool localized = false)
- Gets the UI Damage Class name
- bool xsIsObjectValid(int objectId, int playerId)
- Checks whether an object exists in data
- int xsGetPlayerNumberOfObjects(int playerId)
- Gets the number of data objects of a player
- int xsGetLocalPlayerId()
- The local player number is unique for every player in the game. It signifies their player number in the game. Do not use this function for anything outside of things like display and chat—it will cause desyncs.
- string xsGetPlayerColorTag(int playerId)
- Gets the player color tag like
<RED>for the given player. Works when the color has been changed in a scenario from the Players menu as well. - Note: See the Color Constants section of Constants.xs for all values
- Gets the player color tag like
- int xsGetMapSeed()
- int xsGetTechAttribute(int playerId, int techId, int techAttribute, int indexOrCostType)
- Gets a specific attribute from a tech
- Note: See the Tech Attribute Constants section of Constants.xs for all values
- int xsGetLocale()
- The following functions all work similarly to their trigger effect analogues. Note that passing -1 to the playerId field of any of these functions applies it to all players.
- bool xsPlaySound(string eventOrSoundFileName, int playerId, vector position, float angle, int objectId, bool global = false)
- bool xsDisplayInstructions(string msg, int time, int sourcePlayer, int iconObjectId, int panelPosition, bool useTagColorForIcon, bool playSound, string soundFilename, int playerId = -1)
- Note: the sourcePlayer corresponds with the editor “Source Player” option. The playerId parameter corresponds to which player to show this instruction to.
- bool xsClearInstructions(int panelPosition, int playerId = -1)
- bool xsDisplayTimer(int timerId, string msg, int time, int timeUnit, bool resetTimer, int playerId = -1)
- bool xsClearTimer(int timerId, int playerId = -1)
- float xsGetTimerTimeRemaining(int timerId, int timeUnit, int playerId = -1)
- bool xsSendChat(string msg, int playerId = -1, bool silent = false)
- void xsDeclareVictory(int playerId, bool victory = true)
- Math-related functions:
- float ln(float x)
- float log2(float x)
- float log10(float x)
- float round(float x)
- float radians(float x)
- float degrees(float x)
- float dist(vector v1, vector v2)
- int bitAnd(int v1, int v2)
- int bitOr(int v1, int v2)
- int bitNot(int v1)
- int bitXor(int v1, int v2)
- Fixed the XS main function not being invoked in replays.
Localization

- Fixed Mapuche Civilization description appearing truncated in Portuguese, Spanish, Latin American Spanish, Malay, and Russian languages.
- General improvements to The Last Chieftains localization.
- Lautaro 1: ‘Gods of Death and Terror’: Fixed some side objectives not appearing with the check mark icon for German and Portuguese languages.
- S. America, El Dorado Campaign: Fixed missing localized VO for Chinese.
Ongoing…

Investigation
As always, we are continuing to track issues reported by the community for future updates.
For other known issues, please visit this page to see what’s being tracked!
What’s on the Horizon?
COMING UP…
Hello Community!
Please continue to send us your feedback whenever you have it, because we’re definitely listening and responding and anxious to hear where you’d like our attention at any given time! More to come soon, including some especially exciting things we can only tease by saying stay tuned… more surprises are on the way 😉
DISCLAIMER
Please note that this list is subject to change and should not be considered a comprehensive list of all the known issues we’re tracking. The above is to inform you of the team’s current priorities, which will change as other issues arise or take precedence.
For the latest updates and announcements, please visit our social channels.