Age of Empires II: HD Edition
Advance to the Steam Age
Explore new maps, multiplayer scenarios, and user created campaigns. Or reinvent your game experience with new sounds, visuals, AI, units, and more! Ready to share your creations with the world? Upload right from the map editor, or collaborate with friends to create a masterpiece collection.
Zetnus Sep 24, 2013 @ 12:52am
List of Workshop Bugs/Issues [with fixes where available]
It is actually rather nice to have Workshop support for Age of Empires II HD, but a couple of bugs and issues have been getting on my nerves. It was not major stuff at first so I just lived with it ... until I realized that my submissions were not being updated despite getting "upload successful”. There I was applying hotfixes and improvements to my maps - but everyone was still receiving the original!

So I decided it was about time to compile a list of all the things that are not working correctly in and around the workshop. Fixes and workarounds are included where available. A lot of the fixes and workarounds are not ideal and may not always work!


- "Publish error 16", when trying to upload larger files, for example soundtracks or textures.
[fix - error 16 is a connection timeout, try again until it is successful – it might be a good idea to try during times when Steam is being less used. Another thing to try is to open the uploader from inside the scenario editor instead of from the main screen. A non-ideal solution is to reduce the file size - for example if you are uploading soundtracks. You can also split the mod into multiple Workshop items to reduce the overal filesize without a loss of quality.]

- Certain file types, for example .rms, are not visible in the uploader
[fix - type the filename of the item you wish to upload and then select it from the dropdown list.]


- The name of the modfile associated with the Workshop item does not change name when you rename the Workshop item. Result: "publish error 9" when trying to update the file.
[fix - rename the Workshop item so that they have exactly the same name, then update. (NOTE - even though the update may appear to be successful - often the original file is still the one in the Workshop instead of the new version - see next point!) If the modfile is missing from the mods folder, subscribe and start a game to get it.]

- Despite an update appearing to have been completed successfully, in most cases the original file is still included instead of the updated version
[fix – unknown, unless you want to make a new Workshop submission with the updated version. Occasionally updates are completely sucessfull, but so far I have not been able to work out why or how.]


- In some cases, verifying the integrity of the game cache after unsubscribing may not restore all of the original textures/graphics.
[fix - manually delete the files or the folder (usually the slp folder) containing them and verify again. To find out which files are affected, open the modfile of the associated mod - it is just an archive without an extension so extraction programs should open it. Renaming it to a .zip and then opening it also works.]

- In some cases mods may not load/extract fully.
[fix - do not cancel the introduction video and start the game multiple times if necessary (does not always work)]

- If you are subscribed to more than 30 items, new subscriptions will not be downloaded.
[fix - unsubscribe from scenarios and maps - these will remain in their respective folders even if you verify the game cache after unsubscribing - just back them up if you attempt a full reinstall]

- If you are experiencing subscription errors, it may help to clean out your mods folder, because the files stay in there even after you unsubscribe. It's ok to delete them all, because the ones you are subscribed to will redownloaded next time you start the game.

- If you are subscribed to a mod that changes, rather than ads to, existing files (for example, any terrain mod), verifying the game cache will restore the original game files, despite the fact that you are subscribed. An easy way to restore what you are subscribed to is to remove the associated file from the mods folder - the mod will then be reapplied next time you start the game.

- Similarly to the previous point: If a patch or dlc is installed, it may alter files from mods you are subscribed to (not maps and scenarios, but any mods that replace rather than add files are at risk).
[fix - delete the associated archive in the "mods" folder and load up the game, letting the intro video run. If this does not work, unsubscribe from the mod (and delete the archive file to be sure it's reloaded), and verify your game cache. After a new subscription the mod 'will be back again'.]


- The Workshop occasionally "resets" itself to an earlier state, with the result that recent mods no longer appear on any of the lists (most popular, most recent etc.) nor in search results, despite still being set to "public".
[fix - if you notice that this has happened to your item, change the visibility to private and then back to public. Also try clicking on a direct link to the workshop item to restore visibility.]

- During such Workshop "resets" a number of ratings and subscribers may sometimes be lost.

- The search filter "A.i" does not correspond with the tag "Ai" given by the in-game uploader. As a result, custom AIs are hard to find.
[fix - once you manage to find an AI script, click on the tag Ai to display the others. Also, take a look at the collection "All mods with the tag: "Ai""]

If you notice any other Workshop-related issues please share them and I will update the list.
Last edited by Zetnus; Mar 9 @ 3:43am
Showing 1-15 of 37 comments
< >
Ozhara Sep 24, 2013 @ 3:35am 
Really a great idea!

Most errors and fixes I know of are already in the list, here some additions:

As error numbers are sometimes hard to find themselve, you should add error 16 is a connection timeout, so beside trying it again it is also a good thing to try at times steam is used less, I experienced much better uploading connections then. :)

If you rename your publishing name to the one you used for your initial upload, you will still get no update, as it will be published as a new mod, for it checks the steam title first and in a second step the file name on the steam server.
And renaming a file in your modfolder will change nothing - so you should rename the steam title while updating in any case.

The deleting - the verification just checks/deletes the original game files. So EVERY additional file a mod provides - even ones using AoEs mod integration, like additional slps for graphics - won't be deleted. So in case of graphic mods it's the best to just delete the slp folder if you aren't sure.
To check what files you have to delete you can also open the modfile, that is just a zip-archive without an extension.

If a mod doesn't work after a subscription, delete all mod files you unsubscribed. For they are additional files, they will never be deleted automatically, and sometimes steam gets confused for which ones to use. So keeping this folder clean manually will help you getting less subscription errors.

If your mod vanishes from the workshop, it also helps to open it by clicking on a link to it.
Ozhara Sep 24, 2013 @ 3:40am 
Oh, and I experienced you sometimes get less error 16s while uploading, if you don't use the dialog in the AoE main menu, but create/edit a scenario, opening the dialog from ingame.

And for updating, it seems the version in your mod folder before trying an update has to be the actual one, so it can be necessary to subscribe to your own mod. When I experienced the not working updates, I tried it several times in a row, getting an error number I don't remember, that vanished each time after a new round of unsub/verification/resub the mod.
Zetnus Sep 24, 2013 @ 4:38am 
thanks for your additions, I will update the post!

Originally posted by Ozhara:

If you rename your publishing name to the one you used for your initial upload, you will still get no update, as it will be published as a new mod, for it checks the steam title first and in a second step the file name on the steam server.
And renaming a file in your modfolder will change nothing - so you should rename the steam title while updating in any case.

This updating mess is still confusing me , but here is what I have observed:

1. If you don't give the mod you are updating the exactly same title as it already has in the workshop, you will get a new submission instead of updating the current one.
2. If you do give it the same title as it has in the workshop, but that title is not the same as the file in your mods folder, you will get publish error 9.
3A. If you then rename the file in the mods folder to match the title in the workshop, you will not get publish error 9, and it will seem to be sucessful, however the original file will still be in the workshop.
3B. If you rename the workshop title to fit the modifile you will not get publish error 9, and it will seem to be sucessful, however the original file will still be in the workshop.
4. The above seems to happen regardless of whether or not you are subscribed to the item at the time.

If someone can find a working method for updating submissions more than once, please post it!
Zetnus Oct 11, 2013 @ 8:40am 
If a moderator wants to make this post sticky so that it's at the top of the Workshop discussions, that might be be very usefull for Workshop users.
Bassefrom Oct 24, 2013 @ 8:03am 
It doesn't need to be stickied, it has to be fixed.
Zetnus Oct 25, 2013 @ 8:35am 
Originally posted by Bassefrom:
It doesn't need to be stickied, it has to be fixed.

I agree - but I can't fix it myself so all I can do is raise awareness and hope that it is moved up the priority list for stuff to fix.
Zetnus Dec 24, 2013 @ 3:39pm 
I've never really had many problems with publish error 16 until now, because most of my items weren't huge. But now I've been trying to upload a set of soundtracks which total almost 100 mb, so I just wanted to ask if you know what the limit is (I think it was either 100 or 120 mb). In any case I have tried the uploader in the main menu and in the scenario editor multiple times each without sucess. I try will see if splitting the tracks into 2 sets helps. Also, is there a max file size for individual files?
Ozhara Dec 24, 2013 @ 6:24pm 
The whole mods max size is 100mb, a single file has a max of 2mb.

I experienced exactly the same, the larger a mod the more error 16 I get. And it's not my connection, in case I forgot some file at one try, it worked like a charm.

Some of my soundtracks needed retrying to publish them for more than an hour/20+ tries.
Sometimes it helped to reset my internet connection as for some reason the first try works much better most of the time.
Almost none of my soundtracks worked with less than 5-8 tries...

And it's similar to this when using soundtracks. May it be due to their size or whatever. No other type of mod seems to be that buggy.

Most common errors are not to wait for them to copmpletelly download or to cancel the intro too early so their extraction cancels (for their size, here this really matters).

But I even read in the LoTR soundtrack that some people have to start a rms match and close the game before the soundtrack is kind of 'activated' after the next game start.

By now I mostly recommend to extract soundtrack mods manually in case the archive file was downloaded correctly. That way you can pass most installation bugs and it works pretty well.
Zetnus Dec 26, 2013 @ 2:59am 
Thanks for the info. Max 2mb per file? That would explain why I am having trouble.

... On the other hand, I just browsed throught your GoT tracks and quite a few of them are more than 2mb, so how did you get those uploaded if there is a 2mb limit per individual file?
Ozhara Dec 26, 2013 @ 4:06am 
Oh, sorry. Seems I was a bit confused... As you surely know the preview image has a max size of 2mb. An I think I had a problem with files larger in size than 2mb with some early graphic/terrain mods... but not completely sure about that. For soundtracks there seems to be no limit.

But I experienced the uploading problems to start from around 25mb onwards. The more problems the large the complete mod. (The size of the preview image counts to the complete mods size when uploading it...)

So there seems to be no solution for now beside to try it over and over again /like I do - sometimes for real hours... :( - or to split it down massively. But for the 30 mods cap AoE has at the moment this isn't very userfriendly...
Zetnus Jan 5 @ 1:21pm 
Well I managed to get it uploaded by reducing the quality so that the files are only half as large (50mb). It took a long time to upload but it worked in the end.

But ... now I've run into the visibility issue issue again (where stuff doesn't turn up in the lists or searches). -_- .....
Ozhara Jan 5 @ 1:25pm 
For me too, but just today.

And it seems the lists are all totally 'dead'. The daily list looks exactly like the most rated one for me, so there are no entries from today at all. The screenshots didn't change since yesterday...
So this is different from the other issue, as mods are affected that didn't loose their visibility.

I tried the old trick with the visibility, but my new collection doesn't show up.
cjbeards Feb 26 @ 4:10pm 
Good job putting this out there. The updating has been a real problem for me.
Zetnus Mar 2 @ 4:04pm 
Originally posted by ♥♥♥eards:
Good job putting this out there. The updating has been a real problem for me.

Yeah. I have been putting off adding AoF support to my maps, because it would mean having to make a bunch of new Workshop items, since I can't reliably update the current ones.
Filthydelphia Mar 5 @ 5:58pm 
Is the files not updating thing ever going to be fixed?
Showing 1-15 of 37 comments
< >
Per page: 15 30 50