Download mods from ageofempires.com

readme.md

AoE2 DE Mod downloader bookmarklet

TL;DR:

1. Make a new bookmark
   • Copy the contents of the snippet below into location field for a new bookmark.
   • Call bookmark whatever you want, I went with AoE2 DE Mod DL.
2. Make sure you are signed into the website (https://ageofempires.com/mods), if you aren't, the API will just reject your request.
   • It's completely free and doesn't care if you own the game on that account.
3. Navigate to mod of your choice and click the bookmark.
4. Wait for a bit, the API tends to be slow...
5. You should get a download popup for mod's archive.
6. Extract archive into something like C:\Users\YOUR USERNAME\Games\Age of Empires 2 DE\SOME NUMBERS\mods\local
   • For example I want x256 techs mod (mod id: 832), I would extract contents of the newly downloaded aoe_832.zip into folder C:\Users\alyti\Games\Age of Empires 2 DE\1212112121212121212\mods\local\aoe_832.

bookmarklet

javascript:(function() {
let id = parseInt(location.pathname.match("([0-9]{1,5})")[0], 10); if (id === NaN) {return};
fetch("https://api.ageofempires.com/api/v1/mods/Download", {"credentials": "include", "headers": { "Content-Type": "application/json" }, "body": JSON.stringify({id, boolValue: true}), "method": "POST", "mode": "cors"}).then(r => r.json()).then(r => {location.href = r.value.downloadUrl}).catch(e => console.log(e));
})()

Hi there, I'll attach a functioning code to download mods using console as I was also having issues with the one Alex shared. Please find it below.

However, could anyone PLEASE explain how to make it work for AOE4? I tried everything but the mods won't be detected unless I use the ingame mod manager which is a nogo for me. I want to be able to activate mods MANUALLY. What to do please? I put the downloaded .sga file in extension/local folder.

As for the code, here it is:

const fn = (id) => { fetch(" https://api.ageofempires.com/api/v1/mods/Download ", { "credentials": "include", "headers": { "Content-Type": "application/json" }, "body": JSON.stringify({ id: id, boolValue: true }), "method": "POST", "mode": "cors" }) .then(r => r.json()) .then(r => { location.href = r.value.downloadUrl; }) .catch(e => console.log(e)); };

// Call the function with the desired id fn(!!!Put ID here!!!);

thanks