Skip to content
Inkub0Public

About

Quake 4 game library (q4base) for the DUDE engine - built from the Quake 4 SDK, non-commercial (SDK licence)

Resources

Stars

3 stars

Watchers

0 watching

Forks

Latest commit

 

History

46 Commits

Folders and files

Repository files navigation

dude-q4

The Quake 4 game library (q4base.so / q4base.dll) for DUDE, built from Raven Software's Quake 4 SDK 1.4.2 game code.

Licence

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.

Layout

  • 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.

Building

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.

Releases

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).

Versions

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.

Provenance

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.

About

Quake 4 game library (q4base) for the DUDE engine - built from the Quake 4 SDK, non-commercial (SDK licence)

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages