Official Guide to Hosting a Server with User Made Maps.

This guide covers how to configure a server to use maps from the Steam Workshop.
* UPDATED* 6-5-2022

Overview

This guide covers the basics of how to configure a server to run UMMs. It will be updated to reflect any changes to the process in the future.

Initial Setup

The process for adding a UMM to the server has been streamlined.

Get the Map's ID

First, you'll need the map's Steam Workshop "Item ID". The easiest way to get this is to find the map in the workshop. The ID is in the URL.


The ID for 2Forts is 572120225

Add the ID to the Server

Now that we've acquired the ID, we can tell the server to use the map.

Under AAPG\AAGame\Config\ there is now an AASteamUGCManager.ini file.

(*)If you're running a server on your own machine using the "Host a Server" tool, copy the ini file from one of the AAHostAServerConfig subdirectories into the parent Config directory. If you're running a server on your own machine from the command line, "AA" ini files will be located under Documents\My Games\America's Army Proving Grounds\AAGame\Config.

(If the file doesn't exist, run the game once to generate it.)



Open it and in the [SteamUGCManager.SteamUGCManager] section, add this line for each UMM you want the server to use:

ServerSubscribedItems=(IdString=<MapID>)

Like this:



Gameserver Version:

Transfer Workshop Map to Server

Copy the .umap file and place it in the folder shown below



If you are using Gameservers as your server provider, you will need to run the Steam Fix Mod each time you add a map to your server.

Adding Maps to the Rotation/Vote Lists

Once the map is on the server, you may optionally add it to the Map Rotation and Map Vote lists.

In AAPG\AAGame\Config\AAGame.ini, find the section where the MapRotationList and MapVoteList are defined, and add new entries to either list. Be sure to use the full filename of the maps you're adding.

Conclusion

That's it! You no longer need to worry about uploading files or opening extra ports.

When clients attempt to join your server, they'll get a popup asking them to subscribe to any UMMs on the server that they haven't downloaded. Once their download finishes, they'll join your server!

[Smithers]

IS this still the process to add UMM to a rented server? I am using Citadel Servers and am having troubles getting the UMM's to load. They show up in the admin section to choose, but when I do the map that loads up is my start up map which is a stock map. Can anybody help a brother out?

[johank20 /DK\]

it has been changed and the maps can be added in the AASteamUGCManager.ini with
ServerSubscribedItems=(IdString=<ID>)

Make sure in the AAGame.ini to set
ServerNeedsUGCMapsUpdateDelay=10
bServerSteamUGCAutoUpdate=true

the server should download the maps from the steam workshop to find the name of the map goto
\\<server dir>\aapg\Binaries\win32\steamapps\workshop\<ID>\*.umap

##
if maps dont load or install delete the file libaryfolders.vdf

[=U^S=_Mason]

Very odd, I took those screenshots while connected to a Gameservers aapg server via ftp.

[-=[M]=-Ro-Longo]

I use Filezilla and I also run the "Steam Fix"

[=U^S=_Mason]

It is in the "MODS" tab "Steam Fix"

[=U^S=_Mason]

@Ro-Longo. I use a separate ftp program to log onto the Gameservers ftp, I believe it was "Filezilla"
https://filezilla-project.org/download.php

With regards to the message you keep getting. Make sure you run the Steam Mod fix each time you add maps to the server.

[-=[M]=-Ro-Longo]

The directory aapg/AAGame/CookedPC/UserMadeMaps is not on my gameserver ftp site. Creating a folder and putting maps in there results in maps not being found. What is the correct directory to upload the UMM's to? Also is there a fix for the "Server is downloading maps (x of x)"?

[biale.konie]

Any updates?

[Pew-Pew-]

How i geth this map working i try it and wont go need some help please

[-[U|S|A]-DannyBoy]

I am not 100% sure MasterSeal, I think you do need to do it this new way now, the old way does not seem to DL the maps anymore