DUSK Modding FAQ

DUSK SDK Getting Started Guide - Basic information on how to configure Trenchbroom and the SDK, as well as load Quake and Half-Life BSP

Posted by on


General


How do I get the SDK?

Currently the SDK is in alpha on both GOG and Steam, those platforms are required to use the SDK.

For Steam:

Right click on the game in your Steam library and select "properties," then navigate to the "BETAS" tab. You should see a public SDK branch.

Note that the SDK version is currently a separate program from the main game. To run it, start DUSK from your Steam library (using the green play button). A launcher should appear with "Launch DUSK SDK" as an option. Choosing "Play DUSK (singleplayer)" instead, or launching Dusk from a desktop shortcut, WILL NOT LAUNCH THE SDK. If there isn't a "modding" button on the main menu, you've launched the wrong version.

For GOG Galaxy:

Navigate to your GOG library and "manage installation" for DUSK. There you should find the option to enable beta channels. Enter the following password to access the DUSK SDK

oohagiantbarn

After that you should have the SDK channel available, upon joining it the SDK will download automatically. To access the SDK you can right-click the game in library and select SDK. Those on Galaxy 2.0 will have to navigate to DUSK\SDK and launch via the respective batch files. dusk_win for Windows, dusk_tux for Linux

What can I do with the SDK?

Currently the Dusk SDK can be used to create and load custom levels and replace most sounds and textures. Replacing models, music, all sounds/textures, scripting etc are all planned at a future time.

Where do I find mods?

Dusk mods can be found on duskmods.com and the DUSK ModDB page. For more information join the New Blood Discord You can also check out the Dusk subreddit

Creating Mods


How do I make maps?
Any map editor capable of exporting Quake-Half-life .bsps should be compatible with Dusk. TrenchBroom is the officially suggested mapping software.

Video Tutorial:

How do I assemble my mod?

  1. Create a folder in SDK/mnt/local/ and name it whatever you want your mod to show up as in the in-game menu.
  2. Inside that folder, textures/sounds/maps should be placed in corresponding folders named textures sounds and maps.
  3. If you want sounds or textures to replace the default ones, name them the same thing as the corresponding sound/texture found in SDK/mnt/local/sounds/ or SDK/mnt/local/textures/ (the file extension needs to be the same as well).
  4. Make sure to activate the mod in the modding menu.
  5. See "Running Mods" for information on how to load mods/maps.


Running Mods


How do I run Quake maps?

Quake maps can be found inside [Quake install location]/id1/PAK0.PAK and [Quake install location]/id1/PAK1.PAK. To extract them, you will need a program such as Pak Explorer or Slade3.


  1. Create a folder in [DUSK install location]/mnt/local/ named "quake maps" (although this can be named whatever you want).
  2. Place Quake's palette.lmp file here, and create a new folder named "maps" (this CANNOT be named whatever you want).
  3. Place your Quake maps inside that folder.
  4. Run the Dusk SDK (for more information see "How do I get the SDK?" above).
  5. On the main menu click "modding" and ensure "quake maps" (or whatever you've named it) is enabled.
  6. Back out of the "modding" menu and click "campaign" then "custom level."
  7. Select the map you wish to play from the list, choose your difficulty, and have fun!


Note that some entities and functionality from Quake are yet to be implemented, or still require improvement.

How do I run Half-life maps?

Half-life maps can be found in the [Half-life install location]/valve/maps/ folder and do not need a special program to be extracted. Anything with a ".bsp" extension is a map.


  1. Create a folder in [DUSK install location]/mnt/local/ named "half-life maps" (although this can be named whatever you want).
  2. Create a new folder inside this named "maps" (this CANNOT be named whatever you want).
  3. Place your Half-life maps inside that folder.
  4. Run the Dusk SDK (for more information see "How do I get the SDK?" above).
  5. On the main menu click "modding" and ensure "half-life maps" (or whatever you've named it) is enabled.
  6. Back out of the "modding" menu and click "campaign" then "custom level."
  7. Select the map you wish to play from the list, choose your difficulty, and have fun!


Many Half-life maps also require accompanying wad files for textures. These can be found in the [Half-life install location]/valve/ folder. Copy everything with a ".wad" extension and paste them into your "half-life maps" folder (or whatever you've named it). Note that these should be in the same folder as "maps," NOT in the "maps" folder itself.

Note that many entities and most functionality from Half-life are yet to be implemented or are only partially implemented. Also note that Dusk does not currently support Half-life style level transitions, so entering any level transition trigger will cause the end level screen to be displayed and the next level to be loaded anew.

Can I run user maps made for Quake/Half-life?

In most cases, yes. Dusk should be able to load user maps for Quake/Half-life using the respective methods outlined above. However this is highly dependent on the map in question, and we can't guarantee compatibility. Also note that larger Quake maps such as those in Arcane Dimensions and Wrath can technically be loaded but currently experience significant issues.

Comments

Join the community or sign in with your gaming account to join the conversation: