Guide for using the DUSK SDK Workshop Uploader and Mod Tools
Finding the Uploader
You can find the file structure for the game + all loose assets in \Dusk\SDK\mnt\local\dusk (DUSK levels to be provided at a later date, however BSPs can still be uploaded) These files can be edited and used however you’d like in the creation of mods for DUSK.
Example Mod
For this example we will upload a simple arena made in trenchbroom, textured with Quake assets. To start we need a folder for our mod, we’ll create one named TestMap. Inside the TestMap folder we need to mimic the game’s file structure so that it can read our map.
Create a folder named maps and place your BSP inside (TestMap/maps/epicarena.bsp)
Go back to TestMap and create a description.xml and include a 1MB or smaller preview image of your map.
Your descripton.xml should have the following
<descriptor> <title>Test Map</title> // The name of your map <author>Test</author> // Author’s name <content>Levels</content> // Content Tag <summary>Required content for TestMap.</summary> // Content Descriptor <preview>preview.png</preview> // Preview Image </descriptor>
If your map requires a palette you can place it in the root of your mod folder alongside description.xml and the preview image. For this example we’re using the Quake 1 palette.
https://quakewiki.org/wiki/File:quake_palette.zip
Next we’ll upload the mod.
Uploading a Mod
Mod Directory:
Include the full path to the folder you wish to upload to the Workshop. Eg: C:\TestMap
Preview Image Filename:
Should be the filename for your mod’s preview image. The image must be located inside your mod folder, and has a size limit of 1MB.
Title:
The name of your mod on the Steam Workshop.
Description:
A written description of what your mod is/contains.
Tags:
Workshop tags for what your mod contains. Must select at least one.
Visibility:
Sets the visibility level of your Workshop mod. (Public, Friends Only, Private)
Once ready, press the upload button and your mod will appear on the workshop shortly.
Testing/Playing a Workshop Mod
Press the subscribe button, wait for Steam to download the mod, and launch DUSK – Moddable from your library
Once in-game go to Modding and observe the mod order list. You should see your example mod near the top. Tick the checkbox to enable the mod and press apply.
With your mod enabled return to the main menu, go to campaign, custom level, and select your map from the list. And like that you should now be in your map, in DUSK!
