Jump to content

  • Jatheish

    ATLAS DevKit Launch!

    UPDATE 2: We've fixed some devkit related crashes, latest binaries can be download here: http://atlasdedicated.com/ATLAS_DevKit_Fixed_Binaries.zip and should be extracted into this location: \Projects\ShooterGame\Binaries\Win64\

    UPDATE: We've fixed the issue with uploading content to the ATLAS Steam Workshop. Just download this file http://atlasdedicated.com/SteamVDF.template and place it here: \ModTools\SteamVDF.template (overwriting the old one). We've also updated the ATLAS_DevKit_v12.0.zip archive with the corrected file as well.

    We’re excited to announce, at long last, the ATLAS Devkit is ready to download!

    The ATLAS Devkit is a highly edited and simplified version of the Unreal Engine 4 Editor specifically compiled to streamline the process of creating mods, maps, and more for ATLAS, and to upload them directly to Steam Workshop for other users to download and play.

    In addition to the Steam Workshop, we have our own section of the forums dedicated to all things modding,. Feel free to use Navigator’s Tools category for general discussion, tutorials, and even showcase your mods!

    The Devkit will be launching with a lot of additional functionality including the ability to host servers without using the seamless grid system, but rather traditional "single server" specifically using Steam Workshop maps. Here are some more details:

    Downloading the ATLAS Dev Kit 

    So if you want to make Mods & Maps for ATLAS, get the ATLAS Dev Kit here (sorry for the huge download, soon we’ll be using the Epic Launcher which is much more efficient but it will take some days to get it up there):


    Extract it to some location where you have 180 GB of free space (SSD recommended), and then run it with \ATLASDevKit.bat

    Running ATLAS Steam Workshop Content (Mods, Map Extensions, and Maps) in ATLAS 

    If you’re hosting a seamless grid, all Mod Steam Workshop ID’s that you wish to use (also including any new persistent level Map Mod ID’s, and any Island Extension Mod ID’s) ought to to be specified here in the Grid json or via the World Grid editor (in Mod stacking order):


    Which is equivalent to adding ID’s directly into the ServerGrid.json here:


    However if you’re running a Non-seamless-grid Mod map, then you need to specify all the Mod ID’s (including the Mod Map’s ID) that you wish to use via commandline like so:

    ShooterGameServer.exe OceanTestLevelMod?SessionName=WhateverSessionName?AltSaveDirectoryName=WhateverSaveDirectory?ServerAdminPassword=whateverserverpassword?MaxPlayers=70?QueryPort=57557?Port=5757?GameModIds=1627890405,1625331561,1627715666?MapPlayerLocation=true -log -server -culture=en -NoCrashDialog -NoBattleye -NoSeamlessServer

    You can also add more mods in the Game.ini with this section:


    Upon being launched, the server will then automatically download and install the Mods upon being launched, as well as update them each time the server is run. If you wish to disable the autodownload/update functionality, you can run the server with -manualmanagedmods

    Creating Mods 

    To make a Mod using the ATLAS Dev Kit, as you may remember from ARK, simply create a child of “Blueprint'/Game/PrimalEarth/CoreBlueprints/PrimalGameData_BP.PrimalGameData_BP'” into your “Mods\YourModName” folder. We recommend following the naming scheme of “PrimaGameDataBP_YourModName.uasset”. Then change whatever values you in that new GameData asset to alter the game functionality (note there are various new fields for ATLAS, including “AdditionalInventoryComponentAppends” to add new craftable item types to existing inventories). Then click the “Steam Upload” button in the toolbar, select the folder of your Mod in the Steam Upload dialog, and click “Cook Game Mode”. After the Cook process is done (if you get a crash dialog at the end of the Cook process, just close the crash dialog as it’s harmless), browse for a small preview PNG (256x256 or so), add a Title, Description, Visibility Setting, and Upload to Steam (input your Steam Username and Password when prompted).


    Creating Map (Island) Extensions 

    One of the most exciting new concepts for Workshop Content in ATLAS is the idea of “Map Extensions”, which allows you to add new sets of Islands and landmasses that server hosts can place upon their seamless grid layouts. To create a “Map Extension” for use in seamless grid layouts, simply open “SeamlessTest\Ocean.umap” in the Editor, and add a set of new uniquely named worldcomposition sublevels to the “SeamlessTest\” folder (yes, put them there, not in your Mod folder). These should all be centered on the ORIGIN 0,0,0 (where they’ll be placed in the actual seamless grid layout is up to the server host). Then, set the WorldComposition layer for each those Sublevels to “Farthest”, “Far” or “Near” depending on whether they’re long-distance or short-distance visible levels. Finally, create an empty “Mods\YourExtensionName” folder, and then select it in the Steam Upload dialog. Then input the names of each of your new sublevels into the Maps field like so, and click “Cook Map Extension”:


    After the Cook process, you should create a new Island Template for your landmass within the Server Grid Editor, like so, filling in the size and preview image (take a topdown screenshot in the editor) as appropriate to your Island’s appearance:


    Be sure to add a uniquely named “Extension” for your Island Template, because this will create a unique directory here:


    We recommend that you copy that unique extension directory into “\ModTools\Output\YourMapExtensionName\IslandExtensions” after you have cooked, like so:


    And then instruct server hosts, after subscribing to your Map Extension on their Steam clients, to copy the “IslandExtensions” folder you’ve included with your files, into their local ServerGridEditor application’s directory so that they can place your new Island Templates within their own server layout (as many times as they wish).

    So after a host downloads your content on their Steam client, the hosts should copy this folder:


    Over onto this in their ServerGridEditor application directory:


    hey’ll then see your custom Island Template appear in the list of available Island Templates when they reload the Server Grid Editor.

    Note that server hosts should remember to add your Map Extension’s ID to their Grid’s Mod ID’s list in the Server Grid settings!  And yes it’s entirely possible for a single Map Extension package to include multiple new Island Templates and landmasses for server hosts to use, you don’t have to limit to just a single new Island Template! (Note: if you set the sublevels to UNCATEGORIZED layer, they will be always-loaded, once, on every grid server -- that may be useful if you want, say, a persistent weather system addition to be present in every grid region.)

    Creating Maps 

    Making a new “base” Map is similar to cooking a Mod, with the uniquely-named map file .umap needing to be placed in your Mods\YourMapName\ folder. Then click “Cook Map” in the Steam Uploads dialog. Typically, new custom Maps will ARK-style (and not seamless grid persistent levels), so you’ll want to run those with the following server commandline:

    ShooterGameServer.exe OceanTestLevelMod?SessionName=WhateverSessionName?AltSaveDirectoryName=WhateverSaveDirectory?ServerAdminPassword=whateverserverpassword?MaxPlayers=70?QueryPort=57557?Port=5757?GameModIds=1627890405?MapPlayerLocation=true -log -server -culture=en -NoCrashDialog -NoBattleye -NoSeamlessServer

    However, you can certainly make new “seamless grid persistent levels” too, such as this SkyWorldLevel which removes the Ocean (and of course it could new things too, such as a different DayCycleManager for new weather systems!). To make new “seamless grid persistent levels”, we suggest resaving SeamlessTest\Ocean.umap into your Mods\WhateverCustomMapName directory, and then modifying it as you see fit. We think it’d be very cool to make some Avatar-esque floating islands Map Extensions to go along with that...

    New “seamless grid persistent levels” are cooked the same way, but then simply run with the grid commandline like so (presuming that the Map Steam Workshop ID for the level content is specified within the ServerGrid’s json, or via the [ServerSettings] ActiveMods section of the Game.ini!):

    ShooterGameServer.exe SkyWorldLevel?ServerX=12?ServerY=8?AltSaveDirectoryName=JerTest?ServerAdminPassword=grapeshot?MaxPlayers=200?ReservedPlayerSlots=50?QueryPort=57557?Port=5757?SeamlessIP= -log -server -culture=en -NoCrashDialog -NoBattleye -automanagedmods

    Steam Workshop ID 1626926342 for ‘SkyWorldLevel’ 

    Note: ATLAS currently only supports client-and-dedicated server mode. Running in single-player or as a listen-server will have issues.

    To experiment with Seamless Grid levels (as a client) in the Editor, you can run Play-In-Editor on “SeamlessTest\Ocean.umap” with these Server Game Options in the Advanced Settings dialog:


    You can substitute whatever ServerX ServerY coordinates you want to play on different grid regions (the game uses whatever ServerGrid.json is located in the ShooterGame folder). Alternatively if you just wish to try your new Islands, or a specific combination of sublevels, without setting them up on the json grid layout, you can run Ocean.umap PIE without any ServerX/ServerY commands and it’ll Play-In-Editor without being on any specific region. If you have any sublevels VISIBLE in the Editor Viewport before you do this, they’ll remain loaded in Play-In-Editor, presumably at the origin where you constructed your Islands. In this way, you can test and iterate on the gameplay of your new islands without having to set them up on the servergrid (of course, this method is only practical for testing out one new island set of sublevels at a time).

    You can also run the Seamless Grid outside the Editor (useful for testing transition testing), with the following batch files:

    • DedicatedServerAllFourAndClient_CLEAN.bat
    • And alternatively ClientSub2.bat if you wish to connect a second client.

    You can also run a single non-SeamlessGrid server (such as TestMapArea or OceanTest) outside the Editor with the following batch files:

    • GameDedicatedServer.bat
    • GameClient.bat
    • And alternatively GameClient2.bat if you wish to connect a second client

    Here are some example simple Mods/Maps we’ve provided, the sources for these are included in the DevKit ShooterGame\Content\Mods folder to help you get started:

    ATLAS OceanTest Level


    This is a non-seamlessgrid level, a traditional ARK-style single-server level that has an ocean and some basic box floors for testing, as an example. Servers can host with this:

    ShooterGameServer.exe OceanTestLevelMod?SessionName=WhateverSessionName?AltSaveDirectoryName=WhateverSaveDirectory?ServerAdminPassword=whateverserverpassword?MaxPlayers=70?QueryPort=57557?Port=5757?GameModIds=1627890405?MapPlayerLocation=true -log -server -culture=en -NoCrashDialog -NoBattleye -NoSeamlessServer

    ATLAS Sky World


    This is a resave of OceanTest.umap, but with the Ocean water removed. It’s used as an example of how to have an alternate seamlessgrid persistent level. You can host it by adding this to your ServerGrid.json:


    Or by setting that value here in the Server Grid Editor:


    Or in the Game.ini:


    And then run the servers with:

    ShooterGameServer.exe SkyWorldLevel?ServerX=12?ServerY=8?AltSaveDirectoryName=JerTest?ServerAdminPassword=grapeshot?MaxPlayers=200?ReservedPlayerSlots=50?QueryPort=57557?Port=5757?SeamlessIP=[THEIP]?MapPlayerLocation=true -log -server -culture=en -NoCrashDialog -NoBattleye

    Extended Vehicles Mod (Stackable)


    As an example, this stackable Mod appends craftable items (via the PrimalGameData) to the Smithy inventory for players to build the Airplane, Tank, and Steampunk Airship vehicles. Modders can duplicate “Blueprint'/Game/Mods/ExtendedVehiclesMod/PrimalItem_VehicleGeneric.PrimalItem_VehicleGeneric'” into your own Mods, and inherit from it per-Vehicle, as a foundation for craftable vehicle spawning.



    A very simple box-island-with-trees “Map Extension” for seamless grids, placeable as an island on your servergrid layouts using the included Island Template files. To use this in a server layout, in addition to adding the ID to the Mod Ids for the grid, subscribe to the files on a client and then copy this folder:


    Over this folder onto hosts’ Server Grid Editor application directory:


    Then relaunch the Server Grid Editor and you’ll see the new “BoxIsland” Template available for use in your layout wherever you want:



    A very simple “Base” or non-stackable Mod that just adds a few different Default Feats, used in testing that a base non-stackable Mod works.

    Stacking MOD Test


    This is a stackable Mod that adds an additional unlocked Feat (testing stacking functionality).

    Hopefully that covers a lot of information in order for you guys to get started!

    Something you’ll notice is that we didn't strip the majority of ARK content from the kit, and that’s because it can be used as a basis for building new content in ATLAS, especially for those of you familiar with the ARK DevKit, and some of you may find it helpful when trying to port over your existing ARK Mods.

    As for the question regarding can ARK content be used in ATLAS and vice versa? The overall answer is that we’re fine with it, however, the only thing that would not be allowed and will cause your mod to be removed from the Steam Workshop is using any Wildcard specific maps. This means that you are not allowed to port over The Island, Scorched Earth, Aberration, Extinction, or Ragnarok.

    We’ll be working on some additional documentation that will help guide users through some of the new systems in the DevKit, so be on the lookout for that. Good luck, we can't wait to see all the epic content you guys create!

    Happy Sailing,

    Grapeshot Games

    🏴☠️For the latest dispatch on #playATLAS keep yer one good eye trained on this here information🏴☠️

    Natter n' chatter on Discord: https://discord.gg/playatlas
    Navigate ye olde Subreddit: https://www.reddit.com/r/playatlas
    Hear ye, hear ye on Twitter: https://twitter.com/sailtheatlas
    Watch us scallywags on Twitch: http://twitch.tv/sailtheatlas
    Plus ye can band with us Pirates on Facebook: https://www.facebook.com/playatlasgame


    Edited by Jatheish

    • Like 3
    • Thanks 2

    User Feedback

    Recommended Comments

    Question? What am I missing? I have tried to download this 2 times and each time its stopped going after 92% and 96% I have it downloading to a 1.8TB hard drive.  Am I supposed to do something or just leave it be? its stuck on 92% for past 3hours with suppose to be 1hour 30mins left.  This is so frustrating! any help is appreciated please message me.   

    Share this comment

    Link to comment
    Share on other sites
    2 hours ago, [OCG]Stuccy said:

    Question? What am I missing? I have tried to download this 2 times and each time its stopped going after 92% and 96% I have it downloading to a 1.8TB hard drive.  Am I supposed to do something or just leave it be? its stuck on 92% for past 3hours with suppose to be 1hour 30mins left.  This is so frustrating! any help is appreciated please message me.   


    Clear Download Cache

    Clearing the Steam download cache will cause the Steam client to flush locally cached configuration data and acquire it from the Steam servers again.

    Navigate to your Steam -> Settings -> Downloads -> Clear Download Cache


    Change Download Region

    The Steam content system is divided into geographical regions. The Steam client automatically detects its current region and uses content servers located in that region for best performance. Sometimes, servers in a specific region may be slow, overloaded or have a hardware failure causing download issues. It is advisable to temporarily switch to a different download region to use another set of content servers.

    Steam -> Settings -> Downloads -> Download Region. You may need to test several regions other than your own.

    Share this comment

    Link to comment
    Share on other sites

    Did they add LAN server support to easily test mods? Or do you still need NAT loopback to get a server to work, which isn't possible on my mobile isp.

    • Like 1

    Share this comment

    Link to comment
    Share on other sites

    Create an account or sign in to comment

    You need to be a member in order to leave a comment

    Create an account

    Sign up for a new account in our community. It's easy!

    Register a new account

    Sign in

    Already have an account? Sign in here.

    Sign In Now

  • #1
    • Slick Daddy Club
    • Trojan Trolls
    • .G.H.D.G.
    • Ares Warrior's
    • undezputed
    • Whiskey Co.
    • The Ancient Mariner
    • The Last Pagans
    • Jing Jing
    • Seven Nation Army

    Click the Server Name to see The LIVE World Map!