quick/Quake-III-Arena-VS
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
The cradle of Quake III Arena
233 Commits 1 Branch 0 Tags 10 MiB
C 80%
C++ 18.9%
Python 0.4%
Lua 0.3%
Assembly 0.2%
Other 0.1%
Go to file
Artem Kharytoniuk 1fff81b94b Minor update.
2017-06-08 23:51:08 +03:00
src Removed extern declarations from vk.h that are used only by vk.cpp. 2017-06-07 11:13:09 +03:00
tools Specify shaders directly as arrays of bytes in source code. 2017-04-05 14:26:15 +03:00
visual-studio Added quake3.vcxproj.user.example file with example command arguments to run game from visual studio. 2017-05-29 15:57:24 +03:00
.gitignore Added vulkan validation layers config. 2017-05-28 13:18:54 +03:00
appveyor.yml Minor update. 2017-06-08 23:51:08 +03:00
changelog.md Update changelog.md 2017-05-30 09:43:24 +03:00
COPYING.txt The Quake III Arena sources as originally released under the GPL license on August 20, 2005. 2012-01-31 13:41:34 -06:00
README.md Update README.md 2017-06-08 23:38:35 +03:00
README.txt The Quake III Arena sources as originally released under the GPL license on August 20, 2005. 2012-01-31 13:41:34 -06:00
Screenshot.jpg Added README.md 2014-05-09 23:51:29 +03:00

README.md

Welcome to the Quake 3 source code!

Project Badge

This repository contains updated version of the original Q3 codebase with reorganized code structure, compatibility fixes, build setup for the latest Visual Studio and modifications that update the core tech but preserve original gameplay, look and feel.

The general direction is to simplify the things. The codebase should be easy to build, executable does not require additional shared libraries to work and we do not talk about OOP here. Only Windows platform is supported.

Usage

  • Build visual-studio/quake3.sln solution.
  • Copy quake3-ke.exe to your local Quake-III-Arena installation folder.

Vulkan support

Vulkan backend provides the same graphics features as original OpenGL-based one including customization via r_xxx cvars and debug visualization.

Make sure that the latest AMD/NVIDIA drivers are installed. Vulkan backend was tested on AMD and NVIDIA hardware. Unfortunately no guarantees for Intel GPUs - there is no vulkan support for my 4790K Haswell processor.

New cvars:

  • r_renderAPI - 3D API to use: 0 - OpenGL, 1 - Vulkan. Requires vid_restart.

  • r_twinMode - Debug feature to compare rendering output between OpenGL and Vulkan APIs. If enabled, renderer uses both APIs and renders current frame to two side-by-side windows. Requires vid_restart.

Additional information:

  • Q: How to start game with vulkan support? A: quake3-ke.exe +set r_renderAPI 1.
  • Q: How to enable vulkan support from Q3 console? A: \r_renderAPI 1 then \vid_restart.
  • Q: How to enable twin mode from Q3 console? A: \r_twinMode 1 then \vid_restart.
  • Q: How to check that Vulkan backend is really active? A: gfxinfo console command reports information about active rendering backend.

Visual Studio

The project files are provides for Visual Studio 2017. Free community version is available online.

visual-studio/quake3.vcxproj.user.example file is provided with example configuration options to start game from visual studio and to enable vulkan validation layers.

Screenshot
P.S. The screenshot above is a historical artifact that was created somewhere in 2005 and has no direct relation to the codebase itself.