Skip to content
Die4Ever edited this page Nov 27, 2023 · 16 revisions

How to use?

Download build-engine-randomizer.exe from the Assets section on the Releases page. Run it, point it to the game's GRP/RFF/DAT file, choose your settings, and click Randomize! Make sure you have a backup of your game files first just in case. Put eduke32.exe/nblood.exe/etc into the game's folder. On Windows the Randomizer will generate a bat file for you to play, and then you can just play the game as normal, choose which episode and which difficulty, and it will automatically use the new map files. You do NOT select "USER MAP" in the game menus.

If you don't get a bat file or if you want to run manually:

This will depend on the game, the Output Method you select in the Randomizer, and what source port you're using.

GRP File Output This creates a GRP file dependent on the original, with a grpinfo file. eDuke32 (and variants) will detect this if you put the eduke32.exe file in the same folder and then it will show up in the launcher list of games.

image

Randomizer Folder Output This creates a "Randomizer" folder in the game with all the randomized files in it. For eDuke32 (and variants) you choose this in the "Custom game content directory"

image

Simple Output This will just put the randomized files straight into the game directory. This is not recommended, but it should work with most source ports and it might also work with the original DOS versions.
Full GRP File This creates a GRP file with everything in it so it doesn't have a dependency on the original file. This is generally not needed, but it might work with the DOS versions.

image

Where can I get the games needed for the Randomizer?

Duke Nukem 3D

I recommend getting the Atomic Edition from Zoom

You can also get World Tour from Steam, Humble Bundle, or check IsThereAnyDeal.

You can also get the free Duke Nukem 3D demo here.

For Duke Nukem 3D, I suggest using EDuke32 to run it. EDuke32 has an option for "Custom game content directory", in this dropdown select "Randomizer".

Ion Fury

You can buy Ion Fury from Steam, GOG, Humble Bundle, or check IsThereAnyDeal.

For Ion Fury you can also use EDuke32, which allows you to enable the "Use Randomizer Folder" option inside the Randomizer window, and then in EDuke32 set "Custom game content directory" to "Randomizer".

Shadow Warrior

You can get Shadow Warrior for free on Steam or GOG. You can also get the Redux edition from Steam, GOG, or check IsThereAnyDeal. (I don't know any advantage to buying this instead of using the free version along with voidsw).

For Shadow Warrior, use voidsw.exe from that same download as EDuke32 (it's in the zip file).

Blood

You can buy Blood from Steam, GOG, Humble Bundle, or check IsThereAnyDeal.

For Blood, I suggest using NBlood to run it. NBlood has an option for "Custom game content directory", in this dropdown select "Randomizer".

PowerSlave / Exhumed

For PowerSlave, you need the old Build Engine version of the game, not the newer rerelease. You can buy it from Steam or GOG. You can also get the shareware demo here.

For PowerSlave (aka Exhumed) I suggest PCExhumed to run it. PCExhumed has an option for "Custom game content directory", in this dropdown select "Randomizer". This will not work with the Night Dive Studios 2022 release titled "PowerSlave Exhumed", as that is not based on the Build Engine.

A.W.O.L.

A.W.O.L. is free on Steam! However the Randomizer only has very basic support for it so it's not really playable right now. If you want to help make this Randomization playable you can help out by filling in sprite ID numbers and CON file info here, you can use Duke 3D as an example.

How can I contribute?

The best way to help out would be to improve the game definitions, or even add more games. Check out the BuildGames folder for examples.

Where can I chat about this project?

Join our Discord! https://discord.gg/QwjnYWhKsY