﻿BuildGDX is a port of Build Engine games based on libGDX framework for Java.

It currently supports the following games:
 Duke Nukem 3D + World Tour Edition + official addons
 Blood + Cryptic Passage
 Shadow Warrior + addons
 Redneck Rampage + Route 66 + Rides Again
 Powerslave / Exhumed
 Witchaven 1 + 2
 TekWar
 Legend of the Seven Paladins
with more games coming in the future releases.


-------------------------------------
Installation:
-------------------------------------

Windows 64-bit:

— BuildGDX comes with its own JRE image meaning you don't have to install JRE/JDK on your system

— Unpack the contents of the archive into a separate folder or a game folder

— Run BuildGDX.exe


Other OSes:

— Make sure you have Java 8 or higher installed 

Download JDK: https://adoptopenjdk.net/

— Unpack the contents of the archive into a separate folder or a game folder

— Run BuildGDX.exe or BuildGDX.jar


-------------------------------------
How to add cutscenes to GOG and Steam versions of Blood:
-------------------------------------

Easy way - download BuildGDX Pack:
https://steamcommunity.com/sharedfiles/filedetails/?id=1602966657

Hard way:
— Download and install IZArc2Go: http://www.izarc.org/downloads
(you can also use your favorite CD images manager like Daemon Tools)

— In the game folder, find game.gog file and rename it to game.bin.

— Open game.bin in IZArc.

— Extract "movie" folder into the game folder.


-------------------------------------
How to add CD music to GOG and Steam versions of Redneck Rampage:
-------------------------------------

Use this fix:
https://steamcommunity.com/sharedfiles/filedetails/?id=1508659746


-------------------------------------
How to play custom maps and mods:
-------------------------------------

Single .map files can be placed in a game folder or any subfolder.

Campaigns should be placed each into a separate folder or packed into a .zip archive.

Open <User Content> in the New Game menu and select .map, .ini, .zip, or .grp file.

Most of the existing custom campaigns should work with BGDX out of the box, but some mods come with their own installers that can't be simply put into mods folder or even installed without DosBox.
For said mods, look for "Rescripted" or "BuildGDX Ready" versions. 

Some mods have optional files which enable certain features. For example, Old Friend for Blood has MUSIC and NOMUS folders, each with the same file set. It's better to remove conflicting files before running the mod.

PowerslaveGDX and Witchaven treat a folder with several maps as a campaign that can be selected in the <User Content> menu.


-------------------------------------
Autoload folder:
-------------------------------------

Autoload folder can be used to load mods at game startup. These can include custom music packs, voxels, maphacks, HRP etc.
***You are not supposed to put custom campaigns into autoload folder***

BGDX will automatically load all zipped files in the autoload folder and execute the following .def files:
	— unpacked .def files
	— .def files inside .zip archives that have the name of the port (dukegdx.def, bloodgdx.def, swgdx.def, rrgdx.def, psgdx.def, twgdx.def, lspgdx.def, or whgdx.def)
	
Visit https://m210.duke4.net/index.php/downloads/category/9-gdxpacks for more mods and music packs.


-------------------------------------
MULTIPLAYER:
-------------------------------------
Multiplayer can be played through both LAN and Internet using UDP port you can choose in the settings.

Player taking the role of the Master must have this port open. It can be done either with UPnP or manually.

Custom maps and campaigns can be played the same way as in single player.
***All players should have the same relative paths to the mod's .ini and other files (e.g. /mods/Death Wish 1.4/dw.ini)***


-------------------------------------
Troubleshooting:
-------------------------------------
On rare occasions a game can crash leaving java process running in the background. In this case, kill javaw.exe process in the task manager.

Check <GameName>GDX.log for errors and if there are any, send the log to m210-2007@mail.ru
If there are none, run the game from the command line using "java -jar buildgdx.jar" then try to recreate a crash and send the contents of the command line to the developer.


-------------------------------------
SPECIAL THANKS:
-------------------------------------
fgsfds
Dzierzan
phredreeke
[TC]Čiαиєz
James Manning
MaxED


For donation, use paypal button on http://m210.duke4.net/

Please send bug reports and feedback to m210-2007@mail.ru, use my guestbook at m210.duke4.net or forum thread https://forums.duke4.net/topic/9351-bugs-problems/