The Quake 4 game library (q4base.so / q4base.dll) for DUDE,
built from Raven Software's Quake 4 SDK 1.4.2 game code.
Everything in this repository derives from the Quake 4 SDK and is under its licence,
EULA.Development Kit.rtf (the "QUAKE 4 SOFTWARE DEVELOPMENT KIT LIMITED USE LICENSE
AGREEMENT"): non-commercial use only; copies may be passed on only free of charge and with
that agreement attached. It is not GPL, which is why this code lives apart from DUDE
(GPLv3) and talks to it only across the game-library boundary (GetGameAPI). DUDE's own code is
never copied in here, and nothing from here goes into DUDE. You need your own copy of Quake 4 to
play; no game data is included.
Non-commercial means this project takes no money: no donations, sponsorships or paid builds are tied to it, and nobody may sell it or bundle it with anything sold.
Quake and Quake 4 are trademarks of their owners (id Software / ZeniMax Media). This is an independent, non-commercial project, not affiliated with, endorsed or sponsored by id Software, ZeniMax Media, Microsoft, Raven Software or Activision.
source/- the SDK source as Raven shipped it (first commit, unmodified):game/(the single-player game),mpgame/(multiplayer, not built yet),idlib/(Raven's idlib) and the engine interface headers (framework/,renderer/,sound/,cm/,aas/,bse/,ui/,sys/), which describe the closed Quake 4 engine and are read for reference only.- Later commits adapt the game code to build against DUDE: one change per commit, each saying what it changes and why.
Built by DUDE's tools/quake4/build-q4game.sh, against the DUDE checkout's headers and its
idlib; the result goes next to build/dude, where DUDE looks for it when it runs Quake 4.
Linux:
git clone --branch v0.9.9 https://github.com/Inkub0/dude.git
git clone --branch v0.9.9 https://github.com/Inkub0/dude-q4.git
cd dude
./build.sh --vulkan # DUDE first (dependencies: DUDE's README.md)
Q4GAME_DIR=../dude-q4 tools/quake4/build-q4game.sh # -> build/q4base.so
./run-q4.sh # finds a Steam / GOG install, or Q4DIR=/path/to/Quake\ 4
Windows, cross-compiled from Linux with MinGW like DUDE's dude.exe (the game library and the
engine exchange C++ objects, so they must come from the same compiler):
./build-win.sh # DUDE for Windows first
Q4GAME_DIR=../dude-q4 DUDE_BUILD=build-win tools/quake4/build-q4game.sh # -> build-win/q4base.dll
It runs with the full retail Quake 4 only (Steam, GOG or disc): DUDE refuses the Quake 4 demo, because the SDK licence below lets this code run with the full version of Quake 4 only.
Built libraries are published as their own archives, dude-q4-<version>-<platform>, never
inside DUDE's: q4base.so / q4base.dll, this repository's EULA.Development Kit.rtf
unmodified, a README and BUILDINFO.txt with the exact DUDE and dude-q4 commits the library
was built from (DUDE's tools/quake4/package-q4.sh).
The game library compiles against DUDE's headers, so the two must match: every DUDE release
vX.Y.Z has a tag of the same name here. Build a DUDE tag with the same tag of this repository,
or both master / main for the latest work.
source/ is the SDK 1.4.2 source from the initial import of the full SDK installer in
github.com/FriskTheFallenHuman/quake4sdk (commit 0682c1b8, 2025-01-19). A second, independent
copy, github.com/Reddragoon244/Quake-4-Source-Code (de2da6b, 2015), matches it on all 718 source
files, byte for byte once line endings are normalised.
Ideas may come from other ports of this code (idTech4A++, OpenQ4); where one is used, the commit says so. Some commits apply fixes that dhewm3 made to id's copy of the same code; each says so and names the dhewm3 commit. Code reconstructed by decompiling Quake 4's binaries is never copied.