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):
http://atlasdedicated.com/ATLAS_DevKit_v12.0.zip
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:
[ServerSettings] ActiveMods=12334593945,875445124
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:
\ServerGridEditor\IslandExtensions\[EXTENSION_NAME]
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:
\SteamLibrary\steamapps\workshop\content\834910\[YOUR_WORKSHOP_CONTENT_ID]\IslandExtensions\
Over onto this in their ServerGridEditor application directory:
\ServerGridEditor\IslandExtensions\
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=37.10.127.116?MapPlayerLocation=true -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
https://steamcommunity.com/sharedfiles/filedetails/?id=1627890405
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
https://steamcommunity.com/sharedfiles/filedetails/?id=1626926342
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:
[ServerSettings]
ActiveMods=1626926342
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)
https://steamcommunity.com/sharedfiles/filedetails/?id=1627715666
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.
BoxIslandMapExtension
https://steamcommunity.com/sharedfiles/filedetails/?id=1626922438
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:
SteamLibrary\steamapps\workshop\content\834910\1626922438\IslandExtensions
Over this folder onto hostsā Server Grid Editor application directory:
\ServerGridEditor\IslandExtensions\
Then relaunch the Server Grid Editor and youāll see the new āBoxIslandā Template available for use in your layout wherever you want:
MyAtlasTestMod
https://steamcommunity.com/sharedfiles/filedetails/?id=1625331561
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
https://steamcommunity.com/sharedfiles/filedetails/?id=1626876784
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
Ā
Recommended Comments
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 accountSign in
Already have an account? Sign in here.
Sign In Now