Skip to main content

Age of Empires II: Definitive Edition – Update 58259

Come jump into to another fun-filled release with exciting updates, balance changes, and bug fixes for Age of Empires II: Definitive Edition!

We’re excited to introduce new co-op campaigns! Grab your battle buddies and take a quick look at some of the changes coming with today’s update:

  • A new Co-op Event!
  • 2 new co-op campaigns! Alaric & Saladin!
  • Custom Lobby Ranked Death Match!
  • Hindi text shaping fix!

Be sure to dig down into the post below to get all of the juicy details before hopping in-game and checking them out firsthand.

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

Download on the Microsoft Store
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 58259.

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!

Download on Steam
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 58259.

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!

Build Spotlight

While there are plenty of notable fixes and features to which to look forward in today’s build, here’s some of the big highlights coming with this month’s update:

Jolly Co-operation Event

January 31- February 14

Surprise! Age of Empires II: Definitive Edition is celebrating the new year and the release of the first co-op campaigns with an all-new event! We’re excited to bring you the latest in co-op fun with the Jolly Co-operation Event!

We are also bringing you a new set of challenges! So, grab your Age of Empires buddies and dive into the new co-op gameplay mode. Don’t miss your chance to unlock some cool rewards during the event and have some fun battling it out with your friends!

New Rewards!

Starting TODAY through February 14th, complete the in-game tasks within the time limit to unlock exclusive rewards!

Day ~ 🎯 Sign in to Xbox Live.
🏆 Profile Icon: A King and a Queen trying to fit on the same throne.
💾 *Required* to save any rewards unlocked during the event!
Each of the following challenges must be unlocked in order and on separate days:
Day 1 🔒 Play any Co-op mission.
🧱 Unlocks the cheat code “my cpu can handle it”: All players’ population cap increased to 1000.
Day 2 🔒 Construct 3 Markets in any amount of games.
🏆 Unlocks the profile icon with a Queen wearing excessive amounts of golden jewelry.
Day 3 🔒 Win any Co-op mission.
🏆 Unlocks the Town Center decoration: King and Queen posing back to back with their arms folded.
Day 4 🔒 Research Caravan in the Market.
🏆 Unlocks the profile icon with a trade cart transporting an overwhelming amount of coins/valuables.
Day 5 🔒 Defeat 1000 enemy units in Co-op missions.
🧱 Unlocks the cheat code “sharing is caring”: every player’s resource income on a team is distributed to the entire team.

Keep it Forever!

Remember: if you sign in to Xbox Live at any point during the event, you get to keep all the mods and profile icons you unlock! Sign in, earn your rewards, and enjoy!

—The Age of Empires Team

Event F.A.Q.

Q: Do I have to complete the challenges on consecutive days?

While challenges don’t have to be completed on consecutive days, only one challenge can be completed per day.

Only the Xbox Live challenges can be completed *any* day before the end of the event!

This means that you will need to play at least five different days to complete all of the challenges.

Q: When is the last day I can complete the daily challenges?

The Jolly Co-operation Event concludes February 14th.

Q: Do I get to keep all of the event unlocks?

All you need to do is log into your Xbox Live account before the end of the event to keep all of the profile icons and mods you unlock; it’s as easy as that!

Q: What do I do if I accidentally unsubscribe from a special mod?

No problem! All you need to do is click your Profile Icon on the main menu, select Event Mods (under Collection), and then check the unlocked event mod you want to enable!

Q: How do I change my profile icon?

You can update your profile icon in your profile:

  1. On the main menu, click the Profile Icon next to your name.
  2. You should now be in the Profile Icons tab under Collections.
  3. Select your favorite icon, then click the Select Icon button to lock in your choice.
  4. You’re done!

Q: How do I download and enable mods?

For information about how to subscribe to and prioritize your mods, visit this article.


Stability & Performance

  • Fixed a rare crash when selecting the “Quickplay” mode.
  • Fixed various, rare memory corruption crashes.
  • Fixed an issue where the Save Cloud Capacity displays at ‘-1.#Q%’ capacity, which made it unable for players to save any files to the Cloud.
  • Game no longer crashes when player receives attack notification from player with “%n” characters in their name.
  • Simultaneously pressing Esc and Find Match on the Quick Play screen will no longer soft-lock the player on a black screen.
  • Simultaneously pressing Esc while resigning no longer soft-locks the game.
  • Fixed a rare crash when loading DLC campaigns while playing on the Microsoft Store.
  • The game no longer goes out of sync when a player accepts a match invite while in the editor.
  • Fixed a freeze when loading ludicrous-sized maps on various random maps.
  • Fixed a rare crash when preparing to start a lobby game as a client with an invalid scenario file.


  • Fixed a rare issue where Farms could appear with incomplete Farm graphics.


  • Fixed an issue where Chinese VO would not work correctly when playing through the Microsoft Store.
  • The Credits screen now plays its intended dedicated track (also known as “Love and Will” in the official soundtrack).
  • The Mod Manager screen now plays the Credits track.


  • “Go to building” and “Select all buildings” hotkeys now work for the respective buildings while navigating the tech tree.
  • Fixed an issue where resign and defeat notifications did not appear in spectator mode when the player who is being watched resigns or gets defeated.
  • During Treaty, an enemy player’s diplomacy label is now “Enemy (Treaty)” instead of “Ally” to avoid confusion with actual allies.
  • Fixed an issue where recorded games could sometimes show wrong player names.
  • Map selection: “Custom map” checkboxes selection now selects all maps when checking all the boxes.
  • A warning message will now be shown when trying to open a recorded game file made with a different build than the one currently used.


  • Market hotkeys now correctly buy/sell resources in increments of 100 instead of 500.
  • Hotkeys can now be correctly reset to “Definitive Hotkeys” (grid layout) again.
  • Default hotkeys for Select and Center groups #10-20 now function correctly.
  • Xolotl Warrior hotkey can now be customized.
  • Villagers no longer go idle after going back to work if two Town Centers are selected.



  • Handicap mode now makes resources last longer, to balance out faster gathering rates.


  • Shift queue attack behavior improved for group of units.
  • Victory is now declared if all enemy players have resigned/been defeated while treaty is still going.
  • Players with allied vision can no longer see unstarted foundations of enemy players in fog of war and unexplored area while Treaty is active.
  • Friend & Foe colors now work correctly while Treaty is active.
  • Recorded games featuring Treaty mode can now be replayed correctly.



  • Post-game statistics screen now has a “Continue” button to immediately play the next campaign mission.


  • Co-op campaigns have left Beta mode! Featuring 6 full campaigns and 5 historical battles!
  • NEW! Alaric & Saladin co-op campaigns!
    • Alaric:
      • The Battle of Frigidus
      • Razing Hellas
      • The Belly of the Beast
      • The Giant Falls
      • A Kingdom of Our Own
    • Saladin:
      • An Arabian Knight
      • Lord of Arabia
      • The Horns of Hattin
      • The Siege of Jerusalem
      • Jihad!
      • The Lion and the Demon
  • Fixed a rare issue where Treaty mode could be triggered inside co-op campaigns.

Random Maps

Map Balance

  • General:
    • Terrain restrictions of various buildings when starting in the dark age with Empire Wars enabled has been restored on several maps, no longer allowing players to place buildings on any terrain type.
    • Folwarks no longer spawn on top of berry bushes in Empire Wars.
  • Amazon Tunnel:
    • The center of the map is now accessible on all settings (more than 2 teams, free-for-all etc).
    • The starting forest clumps are evenly distributed, larger, and slightly closer to the players.
  • Arabia:
    • Increased the chance of generating a map with lower elevation.
    • Herdables now spawn between 18 to 24 tiles away from the players’ town centers (from 20 to 24 tiles).
    • Added multiple visual themes for the map.
  • Oasis:
    • Generation of the main forest and lake has been updated to avoid any unfair situations (missing forests, unequal distances etc..).
  • Runestones:
    • Forests now generate closer to the player’s town centers again.
    • Forests surrounding the players are now larger (from 45 trees to 65 trees per forest).
    • All elevation immediately around the players’ town centers has been removed.
    • Herdables now spawn between 16 to 20 tiles away from the player’s town centers (from 20 to 24 tiles).
    • Boars now generate closer to the player’s town centers (from 16 to 14 tiles).
    • Slight variation has been added to the player’s starting location, so they no longer generate in a perfect circle.

Random Map Scripting

  • Added ignore_terrain_restrictions parameter for object generation which skips terrain restriction check for building placement.
  • Added make_indestructible parameter for object generation. Buildings spawned with this parameter cannot be attacked and destroyed.

Lobbies and Matchmaking


  • NEW! Ranked Deathmatch is now available in Custom Lobbies!
  • NEW! “Balance Teams” button to help you balance your teams in Custom Death Match Lobbies!
  • Players are now able to accept invites to a lobby when in Ranked Matchmaking.
  • Messages that start with the “@” sign now appear in lobby chat or in-game chat.
  • Fixed an issue where players could not remove AIs and add human players in Custom lobbies.
  • Fixed various issues in co-op lobbies.
  • Fixed an issue where players were unable to click anything on the ranked screen if a match is found in match making while the civ screen is opened.
  • Players now display as muted when joining a third-party lobby after the client that lobby-banned them.
  • Changing Civs or checking the Tech Tree during the Quickplay Match Found flow will no longer unmute all previously muted players.
  • Custom maps now download correctly when picked by clicking the randomize button.
  • Improved the “Server” filter from the Lobby Browser to return better results.
  • Removed the “Preferred Region” filter from the Lobby Browser.
  • Fixed a rare issue where restored lobbies could sometimes not have the right amount of player slots.
  • Players can now invite other players to a restored lobby.



  • Fixed an issue where AI player Villagers sometimes don’t garrison into nearby Town Centers when being attacked.
  • Players in Treaty are no longer considered allies by the AI, leading to inappropriate AI behavior.
  • Fixed an issue where the hard AI would resign too early when playing Treaty mode.
  • AI now builds a dock and trains fishing ships in lakes on the Kawasan random map.


  • Fixed an issue where Villagers could sometimes not walk through buildings which are collapsing.
  • NEW! Ctrl+right click can be used to attack a target, ignoring any retargeting command. A unit will only retarget if:
    • They cannot path to the target object.
    • The target has been killed.
    • The target has moved out of range.
  • When sending a Villager back to work within a Town Center which has a gather point, the Villager will ungarrison from the closest point to the gather point instead of the closest point to go back to work.


  • up-log-data now correctly produces an AI log file as intended.
  • Action-pack now works as intended and no longer throws an incorrect obstruction error.
  • Range of shared-goals is now set as a 32-bit signed integer (instead of a 16-bit signed integer).
  • Added sn-allow-capturing-gaia-units to allow AI players to convert units owned by Gaia. (Set to >0 to enable)



  • Fixed various display issues with Hindi characters.
  • Fixed various translation issues reported by the community across the game.



  • Fixed a rare issue where mod upload and downloads could incorrectly time out.
  • UI files civTechTrees.json and futuravailableunits.json can now be included in mods.
  • In-game mod browser is now more responsive when enabling/disabling each or several mods.
  • Improved the in-game search field to show more accurate results.
  • Mods uploaded in-game now receive the correct tags.
  • The “credits” music tracks can now be modded.
  • Added a “NOMODS” launch parameter for debugging purposes which disables the mods system.

Scenario Editor

  • Fixed a legacy issue where gate hitpoints could change in custom scenarios when units pass through them.
  • Fixed a legacy issue where Elevation would continue to be painted on newly pointed tiles without moving the mouse.
  • Deleted Town Centers no longer leave remnants, which are visible through the fog of war.
  • Triggers: Object icons in Display Instructions trigger effect now correctly use the desired player color even if there is no in-game player with said color.
  • Triggers: “Object Has Action” now has object level and object group check
  • Triggers: Modify attribute trigger effect now includes a text box that can be filled to change unit name before such a unit is created.
  • Triggers: The values in change object trigger effects is no longer corrupted after selecting change object attack/armor effect.
  • Triggers: “Change object armor / attack” trigger now takes the type field into account
  • Triggers: Technology State trigger condition no longer resets when used with Disabled state.
  • Triggers: Difficulty Level trigger condition no longer resets when used with Extreme option.
  • Triggers: Fixed an issue where cancelled techs changed by the “Change Tech Cost” trigger effect would not return their correct cost.
  • Triggers: Teleport Object trigger effect now teleports objects to the center of the tile.
  • Corpses of units affected by the “change player color effect”, will no longer appear in the original player color.
  • Changing architecture set of civilization in editor now also changes a unit’s task graphics.

XS Scripting

  • The XS scripting system has been updated with the ability to store and load persistent data. For more information please check the XS documentation.

Ongoing Investigation

Queue Dodging & Cooldowns

We continue to monitor feedback related to this system as we consider what changes may be necessary. We don’t have a specific update at this time, except to encourage continued feedback as we’re definitely listening.


We’re actively working on solutions to this problem and expect to deliver some changes in a future update that will help resolve these issues. As we indicated previously, we’ll have more to say about this as we get closer to delivering those changes.

Problems with MP Services

  • We’re constantly monitoring and ready to troubleshoot issues you may have connecting to Multiplayer services, or finding, joining, and/or hosting matches. When these kind of problems occur, the most useful information for us is network logging provided by you. If you experience these issues at any point, please follow the steps below to notify our Support Team and provide this information:
  • You can find these Logs by looking in this folder: C:\Users\ [[YOUR WINDOWS USERNAME]] \Games\Age of Empires 2 DE\logs
  • Network Logs look like this, and contain the date and time of the session you most recently started (example): 2021.08.20-12.03.37.txt
  • Our Support Team may ask you to try again using our Enhanced Logging build, which provides additional logging information
  • NOTE: The Enhanced Logging build generates very large log files – once you’ve submitted a relevant Support Request, you’ll want to switch back to the regular build, and once you’ve sent any relevant log files you can delete them to save HDD space

To use the Enhanced Logging build:

  1. In some circumstances, we need additional logging information to better understand your problem, and that’s when we ask that you use the Enhanced Logging build
  2. To do that, locate Age of Empires II: Definitive Edition in your Steam Games Library
  3. Right-click the game title and select Properties at the bottom of the menu
  4. In the window that appears, select the BETAS tab on the left
  5. In the available field, enter this beta access code: 4YH2SkfG7CK5yanvrXE9qj8b
  6. You’ll then see that you’ve been given access to enhanced_logging and a button will appear asking you if you’d like to opt in
  7. Opt in or select the enhanced_logging beta, and Steam will automatically update your build 

Crashes and Freezes

As a reminder, player-reported issues (when they’re informational only) can be difficult for us to diagnose, and log files alongside a little bit of back and forth with our Support Team remain incredibly helpful. This shift toward working directly with our players to dig into the issues you’re reporting has allowed us to improve stability more quickly, and we’re anxious to keep this up. Here’s information that will help you work with our Teams when filing Support Requests –

  1. If your game is crashing, there’s a specific log file that’ll help us understand why and it looks like this (example): AoE2DESteam-46906-2021.04.06-15.46.57.mdmp.
  2. The file can be found in this directory: C:\Users\[YOUR WINDOWS USERNAME]\Games\Age of Empires 2 DE\logs.
  3. The log file name specifies the game, platform you’re playing on, build version, and the date/time of the crash, and is specific to every instance – so if your game crashed earlier in the day and you’ve been playing since, you can still go back and find this file by matching it to when your issue occurred.
  4. Please attach this file in any Support Requests you submit regarding a crash, and if necessary we’ll reach back out for more information.
  5. You can reach out to our reach out to our Support Team, and if you’re a Steam user, you may be directed to PUP to help us confirm if we’ve been able to resolve your issue.


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.

What's on the Horizon

Coming Up...

2022 Will Be Busy!
At the close of last year we mentioned that there’s plenty on the horizon for Age II:DE, with our plans to continue updating and supporting the game for a long, long time. It’s the New Year and as we deliver the January Update, we’re working through a ton of planning in parallel and thinking about how we can best share our aspirations with you (and trust us, there’s some really cool stuff in the works!) We know you’re interested in this info, so we’ll be sure to follow up once we’re ready to reveal just a few of the things coming to Age II:DE in 2022!


Today’s build contains a fix that addresses a performance issue reported in Team Games. We’re continuing to monitor TG performance and investigating additional changes that may help – if you’re still experiencing this issue following today’s patch, please provide feedback – we’re definitely listening!

Become an Age Insider!

Insiders unlock access to exclusive news, updates, and opportunities to provide feedback about future releases. Here are some of the perks:

  • Access to private forums where you can interact with Age developers
  • The chance to join exclusive beta opportunities through Steam and the Windows Store
  • Channels to provide feedback and inspire quality changes in your favorite Age titles