idTech4A++ (Harmattan Edition)

idTech engine games For Android. An idTech games runtime libraries collection on Android

DOOM III/Quake 4/Prey(2006) OpenGLES on Android/Windows/Linux

DOOM 3 BFG/The Dark Mod/Quake 1 2 3/RTCW/GZDOOM/ETW/RealRTCW/FTEQW/STAR WARS™ Jedi Knight/Serious Sam Classic on Android

毁灭战士3/雷神之锤4/掠食(2006) 安卓/Windows/Linux OpenGLES移植版

毁灭战士3 BFG/The Dark Mod/雷神之锤1 2 3/重返德军总部/GZDOOM/深入敌后: 德军总部/真·重返德军总部/FTEQW/星球大战:绝地武士/英雄萨姆 安卓移植版

Original named DIII4A++, based on com.n0n3m4.diii4a's OpenGLES version.

Latest version: 1.1.0harmattan68(luyiping)
Latest update: 2025-08-09
Arch: arm64 armv7-a
Platform: Android 4.4+
License: GPLv3

---

idTech4's feature

• Linux/Windows(MinGW/MSVC(without editor)) build
• multi-threading renderer
• pure soft shadow with shadow-mapping
• soft shadow with stencil-shadow and translucent stencil shadow
• global illumination rendering
• lighting model: Phong/Blinn-phong/PBR/Ambient/No-lighting
• Wide-character language translation and BFG new fonts support
• debug render tools support with programming render pipeline
• OpenGLES2.0/OpenGLES3.0
• png/dds/bimage texture image, jpeg/png/bmp/dds format of screenshot
• obj/dae format static model
• OpenAL(soft) and EFX Reverb
• DOOM3(with full body awareness mod, view body mod, bot mod, view flashlight mod)
• Quake4(with bot mod, full body awareness mod, view body mod) and Raven's idTech4 engine
• Prey(2006)(with full body awareness mod) and HumanHead's idTech4 engine

---

Compare with other OpenGLES rendering version of DOOM3

Feature	idTech4A++	Other
Multi-threading	Support (but can't switch in gaming)	d3es-multithread support (and support switch in gaming)
New stage shader (heatHaze, heatHazeWithMask, heatHazeWithMaskAndVertex, colorProcess, enviroSuit(D3XP))	Yes	-
Shadow mapping for pure soft shadow	Yes	-
Soft/Translucent stencil shadow	Yes (Soft stencil shadow only support on OpenGLES3.1+)	-
No lighting	Yes (And support switch in gaming by set harm_r_lightingModel to 0)	Yes
PBR lighting model	Yes (using idtech4_pbr. But specular textures are not RMAO format in idTech4 game data)	-
Wide-character language and DOOM3-BFG new font	Yes	-
DOOM3-BFG occlusion culling	Yes	-
Global illumination rendering	Yes	-
TexGen	Yes	-
OpenGL ES version	2.0 and 3.0+ (point light shadow mapping shader use cubemap on OpenGLES2.0, use texture array on OpenGLES3.0+)	2.0(3.0+ compat)
Debug render tools	Yes (need to set harm_r_renderToolsMultithread to 1 if with multi-threading)	-

---

Support games

Game	Engine	Version	OpenGL ES/Vulkan version	Mods
DOOM III	n0n3m4's dante	-	2.0/3.0	Resurrection of Evil The Lost Mission Classic DOOM3 Rivensin HardCorps Overthinked Doom^3 Sabot(a7x) HeXen:Edge of Chaos Fragging Free LibreCoop LibreCoop D3XP Perfected Doom 3 Perfected Doom 3:RoE Doom 3: Phobos(Dhewm3 compatibility patch)
Quake IV	n0n3m4's dante	-	2.0/3.0	Hardqore
Prey(2006)	n0n3m4's dante	-	2.0/3.0
DOOM 3 BFG(Classic DOOM 1&2)	RBDOOM-3-BFG	1.4.0 (The last OpenGL renderer version)	3.0/Vulkan1.1
The Dark Mod	Dark Mod	2.12/2.13	3.2 (require geometry shader support)
Return to Castle Wolfenstein	iortcw	-	1.1
Quake III Arena	ioquake3	-	1.1	Quake III Team Arena
Quake II	Yamagi Quake II	-	1.1/3.2/Vulkan	ctf rogue xatrix zaero
Quake I	Darkplaces	-	2.0
GZDOOM	GZDOOM 64bits	4.14.1	2.0/3.2/Vulkan
Wolfenstein: Enemy Territory	ET: Legacy Omni-Bot support	2.83.2	1.1
RealRTCW	RealRTCW	5.2/5.1	1.1
FTEQW	FTEQW		3.2/Vulkan
STAR WARS™ Jedi Knight - Jedi Academy™	OpenJK		1.1
STAR WARS™ Jedi Knight II - Jedi Outcast™	OpenJK		1.1
Serious Sam Classic : The First Encounter	SamTFE		1.1
Serious Sam Classic : The Second Encounter	SamTSE		1.1

---

on F-Droid

Or download the latest APK from the Releases Section. Tag with -free only for F-Droid update.

Feature	Github	F-Droid
Android min version(because ffmpeg)	4.4	7.0
Ouya TV	Yes	No
Khronos Vulkan validation layer	Yes	No

---

Build DOOM3/Quake4/Prey(2006) mod for Android idTech4A++

• DOOM 3 & RoE SDK
• Quake 4 SDK
• Prey(2006) SDK

---

Testing version(Non-release. Automatic CI building By Github actions when pushing commits)

• idTech4A++ for Android: Android testing.
• DOOM 3/Quake 4/Prey(2006) for Windows x64: Windows x64 testing.

---

Update

1.1.0harmattan68 (2025-08-09)

• Update Wolfenstein: Enemy Territory(ET: Legacy) version to 2.83.2, fix Omni-bot initialization.
• Fix game controller, and add game controller configure on launcher CONTROLS tab.
• Add more alphabet on-screen buttons, and add cs16-client and source-engine on-screen button theme.
• Add load external game library support on Xash3D.
• Add built-in soft keyboard support.
• Update RealRTCW version to 5.2, version 5.1 will be removed on next release.

---

Standalone game directory

Because more support games, it cause all game mods data directory put on a shared folder, them maybe have same name, and diffcult to view/manage. So application default enable Standalone game directory since version 1.1.0harmattan57, and you can also disable it on launcher settings.

If enable Standalone game directory, game data directory should put on Standalone game directory itself(e.g.).

Games of Standalone game directory and folder name:

• DOOM III: doom3/
• Quake 4: quake4/
• Prey(2006): prey/
• Quake I: quake1/
• Quake II: quake2/
• Quake III: quake3/
• Return to Castle Wolfenstein: rtcw/
• DOOM 3 BFG: doom3bfg/
• Wolfenstein - Enemy Territory: etw/
• RealRTCW: realrtcw/
• STAR WARS™ Jedi Knight - Jedi Academy™: openja/
• STAR WARS™ Jedi Knight II - Jedi Outcast™: openjo/

Games of always force Standalone game directory:

• The Dark Mod: darkmod/
• GZDOOM: gzdoom/
• FTEQW: fteqw/
• Serious Sam Classic - The First Encounter: serioussamtfe/
• Serious Sam Classic - The Second Encounter: serioussamtse/
• Xash3D: xash3d/

---

idTech4's new Cvar

Flag

• ARCHIVE = save to/load from config file
• FIXED = can't change in game
• READONLY = readonly, always can't change
• INIT = only setup on boot command
• ISSUE = maybe has bugs
• DEBUG = only for developer debug and test
• DISABLE = only for disable something and keep original source code

CVar	Type	Default	Description	Flag	Range	Scope	Remark	Platform
harm_r_openglVersion	String	GLES3.0	OpenGL version	INIT	GLES2, GLES3.0, OpenGL_core, OpenGL_compatibility	Engine/Renderer	OpenGL_core, OpenGL_compatibility will use OpenGL desktop version, setup with launcher on Android	Windows, Linux
r_multithread	Bool	1	Multithread backend	INIT		Engine/Renderer	setup with launcher on Android	Windows, Linux
harm_r_clearVertexBuffer	Integer	2	Clear vertex buffer on every frame	ARCHIVE, FIXED	0, 1, 2	Engine/Renderer	0 = not clear(original); 1 = only free VBO memory; 2 = free VBO memory and delete VBO handle(only without multi-threading, else same as 1)	All
harm_r_maxAllocStackMemory	Integer	262144	Control allocate temporary memory when load model data	ARCHIVE		Engine/Renderer	For load large model, because stack memory is limited on OS. 0 = Always heap; Negative = Always stack; Positive = Max stack memory limit(If less than this byte value, call alloca in stack memory, else call malloc/calloc in heap memory)	All
harm_r_shadowCarmackInverse	Bool	0	Stencil shadow using Carmack-Inverse	ARCHIVE		Engine/Renderer		All
harm_r_globalIllumination	Bool	0	Render global illumination before draw interactions	ARCHIVE		Engine/Renderer		All
harm_r_globalIlluminationBrightness	Float	0.3	Global illumination brightness	ARCHIVE		Engine/Renderer		All
harm_r_lightingModel	Integer	1	Lighting model when draw interactions	ARCHIVE	0, 1, 2, 3	Engine/Renderer	1 = Phong(default); 2 = Blinn-Phong; 3 = PBR; 0 = Ambient(no lighting)	All
harm_r_specularExponent	Float	3.0	Specular exponent in Phong interaction lighting model	ARCHIVE	>= 0.0	Engine/Renderer		All
harm_r_specularExponentBlinnPhong	Float	12.0	Specular exponent in Blinn-Phong interaction lighting model	ARCHIVE	>= 0.0	Engine/Renderer		All
harm_r_specularExponentPBR	Float	5.0	Specular exponent in PBR interaction lighting model	ARCHIVE	>= 0.0	Engine/Renderer		All
harm_r_normalCorrectionPBR	Float	1.0	Vertex normal correction in PBR interaction lighting model	ARCHIVE	[0.0 - 1.0]	Engine/Renderer	1 = pure using bump texture; 0 = pure using vertex normal; 0.0 - 1.0 = bump texture * harm_r_normalCorrectionPBR + vertex normal * (1 - harm_r_normalCorrectionPBR)	All
r_maxFps	Integer	0	Limit maximum FPS.	ARCHIVE	>= 0	Engine/Renderer	0 = unlimited	All
r_screenshotFormat	Integer	0	Screenshot format	ARCHIVE	0, 1, 2, 3, 4	Engine/Renderer	0 = TGA (default), 1 = BMP, 2 = PNG, 3 = JPG, 4 = DDS	All
r_screenshotJpgQuality	Integer	75	Screenshot quality for JPG images	ARCHIVE	[0 - 100]	Engine/Renderer		All
r_screenshotPngCompression	Integer	3	Compression level when using PNG screenshots	ARCHIVE	[0 - 9]	Engine/Renderer		All
r_useShadowMapping	Bool	0	use shadow mapping instead of stencil shadows	ARCHIVE	All	Engine/Renderer		All
harm_r_shadowMapAlpha	Float	1.0	shadow's alpha in shadow mapping	ARCHIVE	[0.0 - 1.0]	Engine/Renderer		All
harm_r_shadowMapJitterScale	Float	2.5	scale factor for jitter offset	ARCHIVE		Engine/Renderer		All
r_forceShadowMapsOnAlphaTestedSurfaces	Bool	DOOM3 is 1, Quake4/Prey is 0	render performed material shadow in shadow mapping	ARCHIVE, ISSUE		Engine/Renderer	0 = same shadowing as with stencil shadows, 1 = ignore noshadows for alpha tested materials	All
harm_r_shadowMapCombine	Bool	1	combine local and global shadow mapping	ARCHIVE		Engine/Renderer		All
harm_r_shadowMapLightType	Integer	0	debug light type mask in shadow mapping	DEBUG	0, 1, 2, 3, 4, 5, 6, 7	Engine/Renderer	1 = parallel; 2 = point; 4 = spot	All
harm_r_shadowMapDepthBuffer	Integer	0	render depth to color or depth texture in OpenGLES2.0	INIT, DEBUG	0, 1, 2, 3, 4	Engine/Renderer	0 = Auto; 1 = depth texture; 2 = color texture's red; 3 = color texture's rgba	All
harm_r_shadowMapNonParallelLightUltra	Bool	0	non parallel light allow ultra quality shadow map texture			Engine/Renderer	max texture size is 2048x2048	All
harm_r_shadowMapLod	Integer	-1	force using shadow map LOD		-1, 0, 1, 2, 3, 4	Engine/Renderer	-1 = auto	All
r_shadowMapFrustumFOV	Float	90	oversize FOV for point light side matching			Engine/Renderer		All
harm_r_stencilShadowTranslucent	Bool	0	enable translucent shadow in stencil shadow	ARCHIVE		Engine/Renderer		All
harm_r_stencilShadowAlpha	Float	1.0	translucent shadow's alpha in stencil shadow	ARCHIVE	[0.0 - 1.0]	Engine/Renderer		All
harm_r_stencilShadowCombine	Bool	0	combine local and global stencil shadow	ARCHIVE, ISSUE		Engine/Renderer		All
harm_r_stencilShadowSoft	Bool	0	enable soft stencil shadow	ARCHIVE	only OpenGLES3.1+	Engine/Renderer		All
harm_r_stencilShadowSoftBias	Float	-1	soft stencil shadow sampler BIAS	ARCHIVE		Engine/Renderer	-1 to automatic; 0 = disable; positive = value	All
harm_r_stencilShadowSoftCopyStencilBuffer	Bool	0	copy stencil buffer directly for soft stencil shadow	ARCHIVE	0 = copy depth buffer and bind and renderer stencil buffer to texture directly 1 = copy stencil buffer to texture directly	Engine/Renderer		All
r_renderMode	Integer	0	retro postprocess render	ARCHIVE	0 = Doom 1 = CGA 2 = CGA Highres 3 = Commodore 64 4 = Commodore 64 Highres 5 = Amstrad CPC 6128 6 = Amstrad CPC 6128 Highres 7 = Sega Genesis 8 = Sega Genesis Highres 9 = Sony PSX	Engine/Renderer		All
harm_r_autoAspectRatio	Integer	1	automatic setup aspect ratio of view	ARCHIVE	0, 1, 2	Engine/Renderer	0 = manual 1 = force setup r_aspectRatio to -1 2 = automatic setup r_aspectRatio to 0,1,2 by screen size	Android
harm_r_renderToolsMultithread	Bool	0	Enable render tools debug with GLES in multi-threading	ARCHIVE		Engine/Renderer		All
r_useETC1	Bool	0	use ETC1 compression	INIT		Engine/Renderer		All
r_useETC1cache	Bool	0	use ETC1 compression	INIT		Engine/Renderer		All
r_useDXT	Bool	0	use DXT compression if possible	INIT		Engine/Renderer		All
r_useETC2	Bool	0	use ETC2 compression instead of RGBA4444	INIT		Engine/Renderer	Only for OpenGLES3.0+	All
r_noLight	Bool	0	lighting disable hack	INIT		Engine/Renderer	1 = disable lighting(not allow switch, must setup on command line)	All
harm_r_useHighPrecision	Integer	Android = 0; Other = 1	Use high precision float on GLSL shade	INIT	0, 1, 2	Engine/Renderer	0 = use default precision(interaction/depth shaders use high precision, otherwise use medium precision) 1 = all shaders use high precision as default precision exclude special variables 2 = all shaders use high precision as default precision and special variables also use high precision	All
harm_r_occlusionCulling	Bool	0	enable DOOM3-BFG occlusion culling	ARCHIVE		Engine/Renderer		All
harm_fs_gameLibPath	String		Setup game dynamic library	ARCHIVE		Engine/Framework		Android
harm_fs_gameLibDir	String		Setup game dynamic library directory path	ARCHIVE		Engine/Framework		Android
harm_com_consoleHistory	Integer	2	Save/load console history	ARCHIVE	0, 1, 2	Engine/Framework	0 = disable; 1 = loading in engine initialization, and saving in engine shutdown; 2 = loading in engine initialization, and saving in every executing	All
com_disableAutoSaves	Bool	0	Don't create Autosaves when entering a new map	ARCHIVE		Engine/Framework		All
r_scaleMenusTo43	Integer	0	Scale menus, fullscreen videos and PDA to 4:3 aspect ratio	ARCHIVE	0, 1, -1	Engine/GUI	0 = disable; 1 = only scale menu type GUI as 4:3 aspect ratio; -1 = scale all GUI as 4:3 aspect ratio	All
harm_r_shaderProgramDir	String		Setup external OpenGLES2 GLSL shader program directory path	ARCHIVE		Engine/Renderer	empty is glslprogs(default)	All
harm_r_shaderProgramES3Dir	String		Setup external OpenGLES3 GLSL shader program directory path	ARCHIVE		Engine/Renderer	empty is glsl3progs(default)	All
harm_r_debugOpenGL	Bool	0	debug OpenGL	ARCHIVE	only OpenGLES3.1+	Engine/Renderer		All
harm_gui_wideCharLang	Bool	0	enable wide character language support	ARCHIVE		Engine/GUI		All
harm_gui_useD3BFGFont	String	0	use DOOM3-BFG fonts instead of old fonts	INIT	0, "", 1, <DOOM3-BFG font name>	Engine/GUI	0 or "" = disable; 1 = make DOOM3 old fonts mapping to DOOM3-BFG new fonts automatic. e.g. - In DOOM 3: * 'fonts/fontImage_xx.dat' -> 'newfonts/Chainlink_Semi_Bold/48.dat' * 'fonts/an/fontImage_xx.dat' -> 'newfonts/Arial_Narrow/48.dat' * 'fonts/arial/fontImage_xx.dat' -> 'newfonts/Arial_Narrow/48.dat' * 'fonts/bank/fontImage_xx.dat' -> 'newfonts/BankGothic_Md_BT/48.dat' * 'fonts/micro/fontImage_xx.dat' -> 'newfonts/microgrammadbolext/48.dat' - In Quake 4(r_strogg and strogg fonts always disable): * 'fonts/chain_xx.dat' -> 'newfonts/Chainlink_Semi_Bold/48.dat' * 'fonts/lowpixel_xx.dat' -> 'newfonts/microgrammadbolext/48.dat' * 'fonts/marine_xx.dat' -> 'newfonts/Arial_Narrow/48.dat' * 'fonts/profont_xx.dat' -> 'newfonts/BankGothic_Md_BT/48.dat' - In Prey(alien font always disable): * 'fonts/fontImage_xx.dat' -> 'newfonts/Chainlink_Semi_Bold/48.dat' * 'fonts/menu/fontImage_xx.dat' -> 'newfonts/Arial_Narrow/48.dat' <DOOM3-BFG font name> = use a DOOM3-BFG new font by name override all DOOM 3/Quake 4/Prey old fonts. e.g. * Chainlink_Semi_Bold * Arial_Narrow * BankGothic_Md_BT * microgrammadbolext * DFPHeiseiGothicW7 * Sarasori_Rg	All
s_driver	String	AudioTrack	sound driver	ARCHIVE	AudioTrack, OpenSLES	Engine/Sound	sound if without OpenAL on Android	Android
harm_s_OpenSLESBufferCount	Integer	3	Audio buffer count for OpenSLES	ARCHIVE	>= 3	Engine/Sound	min is 3, only for if without OpenAL and use OpenSLES on Android	Android
harm_s_useAmplitudeDataOpenAL	Bool	0	Use amplitude data on OpenAL	DISABLE, ISSUE		Engine/Sound	It cause large shake	All
harm_in_smoothJoystick	Bool	0	Enable smooth joystick			Engine/Input	Automatic setup initial value by Android layer	Android
harm_pm_fullBodyAwareness	Bool	0	Enables full-body awareness	ARCHIVE		Game/DOOM3		All
harm_pm_fullBodyAwarenessOffset	Vector3 String	0 0 0	Full-body awareness offset, format is "<forward-offset> <side-offset> <up-offset>"	ARCHIVE		Game/DOOM3		All
harm_pm_fullBodyAwarenessHeadJoint	String	Head	Set head joint when without head model in full-body awareness	ARCHIVE		Game/DOOM3		All
harm_pm_fullBodyAwarenessFixed	Bool	0	Do not attach view position to head in full-body awareness	ARCHIVE		Game/DOOM3		All
harm_pm_fullBodyAwarenessHeadVisible	Bool	0	Do not suppress head in full-body awareness	ARCHIVE		Game/DOOM3		All
harm_ui_showViewBody	Bool	0	Show view body	ARCHIVE		Game/DOOM3		All
harm_ui_showViewLight	Bool	0	show player view flashlight	ARCHIVE		Game/DOOM3		All
harm_ui_viewLightShader	String	lights/flashlight5	player view flashlight material texture/entityDef name	ARCHIVE		Game/DOOM3		All
harm_ui_viewLightRadius	Vector3 String	1280 640 640	player view flashlight radius, format is "<light_target> <light_right> <light_up>"	ARCHIVE		Game/DOOM3		All
harm_ui_viewLightOffset	Vector3 String	0 0 0	player view flashlight origin offset, format is "<forward-offset> <side-offset> <up-offset>"	ARCHIVE		Game/DOOM3		All
harm_ui_viewLightType	Integer	0	player view flashlight type	ARCHIVE	0=spot light; 1=point light	Game/DOOM3		All
harm_ui_viewLightOnWeapon	Bool	0	player view flashlight follow weapon position	ARCHIVE		Game/DOOM3		All
harm_g_autoGenAASFileInMPGame	Bool	1	For bot in Multiplayer-Game, if AAS file load fail and not exists, server can generate AAS file for Multiplayer-Game map automatic	ARCHIVE		Game/DOOM3		All
harm_si_autoFillBots	Bool	0	Automatic fill bots after map loaded in multiplayer game	ARCHIVE	>=0	Game/DOOM3	0 = disable; other number = bot num	All
harm_si_botLevel	Integer	0	Bot level	ARCHIVE	[0 - 8]	Game/DOOM3	0 = auto; 1 - 8 = difficult level	All
harm_si_botWeapons	String	0	Bot initial weapons when spawn, separate by comma(,)	ARCHIVE	1=pistol; 2=shotgun; 3=machinegun; 4=chaingun; 5=handgrenade; 6=plasmagun; 7=rocketlauncher; 8=BFG; 10=chainsaw; 0=none; *=all	Game/DOOM3	Allow weapon index(e.g. 2,3), weapon short name(e.g. shotgun,machinegun), weapon full name(e.g. weapon_shotgun,weapon_machinegun), and allow mix(e.g. shotgun,3,weapon_rocketlauncher)	All
harm_si_botAmmo	Integer	0	Bot weapons initial ammo clip when spawn, depend on harm_si_botWeapons	ARCHIVE		Game/DOOM3	-1=max ammo, 0=none, >0=ammo clip	All
harm_g_botEnableBuiltinAssets	Bool	0	Enable built-in bot assets if external assets missing	INIT		Game/DOOM3		All
harm_si_useCombatBboxInMPGame	Bool	0	Players force use combat bbox in multiplayer game	ARCHIVE		Game/DOOM3		All
harm_pm_doubleJump	Bool	0	Enable double-jump	ARCHIVE		Game/DOOM3/Rivensin		All
harm_pm_autoForceThirdPerson	Bool	1	Force set third person view after game level load end	ARCHIVE		Game/DOOM3/Rivensin		All
harm_pm_preferCrouchViewHeight	Float	32	Set prefer crouch view height in Third-Person	ARCHIVE	>= 0	Game/DOOM3/Rivensin	suggest 32 - 39, less or equals 0 to disable	All
harm_pm_fullBodyAwareness	Bool	0	Enables full-body awareness	ARCHIVE		Game/Quake4		All
harm_pm_fullBodyAwarenessOffset	Vector3 String	0 0 0	Full-body awareness offset, format is "<forward-offset> <side-offset> <up-offset>"	ARCHIVE		Game/Quake4		All
harm_pm_fullBodyAwarenessHeadJoint	String	head_channel	Set head joint when without head model in full-body awareness	ARCHIVE		Game/Quake4		All
harm_pm_fullBodyAwarenessFixed	Bool	0	Do not attach view position to head in full-body awareness	ARCHIVE		Game/Quake4		All
harm_pm_fullBodyAwarenessHeadVisible	Bool	0	Do not suppress head in full-body awareness	ARCHIVE		Game/Quake4		All
harm_gui_defaultFont	String	chain	Default font name	ARCHIVE	chain, lowpixel, marine, profont, r_strogg, strogg	Engine/Quake4/GUI	It will be available in next running	All
harm_ui_showViewBody	Bool	0	Show view body	ARCHIVE		Game/Quake4		All
harm_g_autoGenAASFileInMPGame	Bool	1	For bot in Multiplayer-Game, if AAS file load fail and not exists, server can generate AAS file for Multiplayer-Game map automatic	ARCHIVE		Game/Quake4		All
harm_si_autoFillBots	Bool	0	Automatic fill bots after map loaded in multiplayer game	ARCHIVE	>=0	Game/Quake4	0 = disable; other number = bot num	All
harm_si_botLevel	Integer	0	Bot level	ARCHIVE	[0 - 8]	Game/Quake4	0 = auto; 1 - 8 = difficult level	All
harm_si_botWeapons	String	0	Bot initial weapons when spawn, separate by comma(,)	ARCHIVE	1=machinegun; 2=shotgun; 3=hyperblaster; 4=grenadelauncher; 5=nailgun; 6=rocketlauncher; 7=railgun; 8=lightninggun; 9=dmg; 10=napalmgun; 0=none; *=all	Game/Quake4	Allow weapon index(e.g. 2,3), weapon short name(e.g. shotgun,machinegun), weapon full name(e.g. weapon_machinegun,weapon_shotgun), and allow mix(e.g. machinegun,3,weapon_rocketlauncher)	All
harm_si_botAmmo	Integer	0	Bot weapons initial ammo clip when spawn, depend on harm_si_botWeapons	ARCHIVE		Game/Quake4	-1=max ammo, 0=none, >0=ammo clip	All
harm_g_botEnableBuiltinAssets	Bool	0	Enable built-in bot assets if external assets missing	INIT		Game/Quake4		All
harm_g_mutePlayerFootStep	Bool	0	mute player's footstep sound	ARCHIVE		Game/Quake4		All
harm_g_allowFireWhenFocusNPC	Bool	0	allow fire when focus NPC	ARCHIVE		Game/Quake4		All
harm_pm_fullBodyAwareness	Bool	0	Enables full-body awareness	ARCHIVE		Game/Prey		All
harm_pm_fullBodyAwarenessOffset	Vector3 String	0 0 0	Full-body awareness offset, format is "<forward-offset> <side-offset> <up-offset>"	ARCHIVE		Game/Prey		All
harm_pm_fullBodyAwarenessHeadJoint	String	neck	Set head joint when without head model in full-body awareness	ARCHIVE		Game/Prey		All
harm_pm_fullBodyAwarenessFixed	Bool	0	Do not attach view position to head in full-body awareness	ARCHIVE		Game/Prey		All
harm_pm_fullBodyAwarenessHeadVisible	Bool	0	Do not suppress head in full-body awareness	ARCHIVE		Game/Prey		All
harm_ui_translateAlienFont	String	fonts	Setup font name for automatic translate alien font text of GUI	ARCHIVE	fonts, fonts/menu, ""	Engine/Prey/GUI	empty to disable	All
harm_ui_translateAlienFontDistance	Float	200	Setup max distance of GUI to view origin for enable translate alien font text	ARCHIVE		Engine/Prey/GUI	0 = disable; -1 = always; positive: distance value	All
harm_ui_subtitlesTextScale	Float	0.32	Subtitles's text scale	ARCHIVE		Engine/Prey/GUI	<= 0 to unset	All
harm_r_skipHHBeam	Bool	0	Skip beam model render	DEBUG		Engine/Prey/Renderer		All

---

idTech4's new command

Command	Description	Usage	Scope	Remark	Platform
exportGLSLShaderSource	export GLSL shader source to filesystem		Engine/Renderer	Only export shaders of using OpenGLES2.0 or OpenGLES3.0	All
printGLSLShaderSource	print internal GLSL shader source		Engine/Renderer	Only print shaders of using OpenGLES2.0 or OpenGLES3.0	All
exportDevShaderSource	export internal original C-String GLSL shader source for developer		Engine/Renderer	Export all shaders of OpenGLES2.0 and OpenGLES3.0	All
convertARB	convert ARB shader to GLSL shader		Engine/Renderer	It has many errors, only port some ARB shader to GLSL shader	All
reloadGLSLprograms	reloads GLSL programs		Engine/Renderer		All
convertImage	convert image format		Engine/Renderer		All
glConfig	print OpenGL config		Engine/Renderer	print glConfig variable	All
exportFont	Convert ttf/ttc font file to DOOM3 wide character font file		Engine/Renderer	require freetype2	All
extractBimage	extract DOOM3-BFG's bimage image		Engine/Renderer	extract to TGA RGBA image files	All
botRunAAS	compiles an AAS file for a map for DOOM 3 multiplayer-game		Game/DOOM3	Only for generate bot aas file if map has not aas file	All
addBot	adds a new bot		Game/DOOM3	need SABotA7 files	All
removeBot	removes bot specified by id (0,15)		Game/DOOM3	need SABotA7 files	All
addbots	adds multiplayer bots batch		Game/DOOM3	need SABotA7 files	All
fillbots	fill bots to maximum of server		Game/DOOM3	need SABotA7 files	All
removeBots	disconnect multi bots by client ID		Game/DOOM3	need SABotA7 files	All
appendBots	append more bots(over maximum of server)		Game/DOOM3	need SABotA7 files	All
cleanBots	disconnect all bots		Game/DOOM3	need SABotA7 files	All
truncBots	disconnect last bots		Game/DOOM3	need SABotA7 files	All
botLevel	setup all bot level		Game/DOOM3	need SABotA7 files	All
botWeapons	setup all bot initial weapons		Game/DOOM3	need SABotA7 files	All
botAmmo	setup all bot initial weapons ammo clip		Game/DOOM3	need SABotA7 files	All
botRunAAS	compiles an AAS file for a map for Quake 4 multiplayer-game		Game/Quake4	Only for generate bot aas file if map has not aas file	All
addBot	adds a new bot		Game/Quake4	need SABotA9 files	All
removeBot	removes bot specified by id (0,15)		Game/Quake4	need SABotA9 files	All
addbots	adds multiplayer bots batch		Game/Quake4	need SABotA9 files	All
fillbots	fill bots to maximum of server		Game/Quake4	need SABotA9 files	All
removeBots	disconnect multi bots by client ID		Game/Quake4	need SABotA9 files	All
appendBots	append more bots(over maximum of server)		Game/Quake4	need SABotA9 files	All
cleanBots	disconnect all bots		Game/Quake4	need SABotA9 files	All
truncBots	disconnect last bots		Game/Quake4	need SABotA9 files	All
botLevel	setup all bot level		Game/Quake4	need SABotA9 files	All
botWeapons	setup all bot initial weapons		Game/Quake4	need SABotA9 files	All
botAmmo	setup all bot initial weapons ammo clip		Game/Quake4	need SABotA9 files	All

---

About DOOM 3

Switch current weapon and last weapon

bind "Your key" "_impulse51"

---

About Quake IV

For playing Quake 4(jmarshall 's Quake4Doom). Now can play all levels, but some levels has bugs.

1. Putting PC Quake 4 game data file to q4base folder and START directly.
2. Particle system: Now is not work(Quake4 using new advanced BSE particle system, it not open-source, jmarshall has realized and added by decompiling ETQW's BSE binary file, also see jmarshall23/Quake4BSE), but it not work yet. Now implementing a OpenBSE with DOOM3 original FX/Particle system, some effects can played, but has incorrect render.

---

About Prey(2006)

For playing Prey(2006)(jmarshall 's PreyDoom). Now can play all levels, but some levels has bugs.

1. Putting PC Prey game data file to base(preybase on Android) folder and START directly.
2. Some problems solution: e.g. using cvar harm_ui_translateAlienFont to translate Alien text on GUI.
3. Exists bugs: e.g. some incorrect collision(using noclip), some GUIs not work(Music CD in RoadHouse).
4. If settings UI is not work, can edit preyconfig.cfg for binding extras key.

bind "Your key of spirit walk" "_impulse54"
bind "Your key of second mode attack of weapons" "_attackAlt"
bind "Your key of toggle lighter" "_impulse16"
bind "Your key of drop" "_impulse25"

---

Screenshot

Game

Mod

Other

---

Changes:

Change logs

---

Build:

• idTech4A++ using std libc's malloc/free in Mem_Alloc/Mem_Free in idlib/Heap.cpp
• idTech4A++ force using generic SIMD, not compile all SIMD of processor in all platform(TODO: enable them on windows/Linux)

Engine macros

1. _MULTITHREAD: Add multithread support for rendering.
2. _USING_STB: Using stb jpeg instead of libjpeg for jpeg image file.
3. _K_CLANG: If compiling by clang not GCC.
4. _MODEL_OBJ: Add obj static model support.
5. _MODEL_DAE: Add dae static model support.
6. _SHADOW_MAPPING: Add Shadow mapping support.
7. _OPENGLES3: Add OpenGLES3.0 support.
8. _OPENAL _OPENAL_EFX _OPENAL_SOFT: Add OpenAL(soft) and EFX Reverb support.
9. _NO_LIGHT: Add no lighting support.
10. _STENCIL_SHADOW_IMPROVE: Add stencil shadow improve support(translucent shadow, force combine global shadow and self local shadow).
11. _SOFT_STENCIL_SHADOW: soft shadow(OpenGLES3.1+), must defined _STENCIL_SHADOW_IMPROVE first.
12. _MINIZ: Using miniz instead of zlib, using minizip instead of DOOM3's UnZip.
13. _USING_STB_OGG: Using stb_vorbis instead of libogg and libvorbis.
14. _D3BFG_CULLING: Add DOOM3-BFG occlusion culling support.
15. _WCHAR_LANG _NEW_FONT_TOOLS: Add wide-character language font support.
16. _D3BFG_FONT: Add DOOM3-BFG new font support.
17. _GLOBAL_ILLUMINATION: Add global illumination support.
18. _POSTPROCESS: Add retro postprocess rendering support.
19. _GLSL_PROGRAM: Add GLSL program on new material stage support.
20. _IMGUI: Add imGUI support.

* DOOM 3

About BOT mod

Define macro MOD_BOTS will compile SABot a7(from DOOM3) mod source code for bot support in multiplayer-game.

About Full body awareness mod

Define macro _MOD_FULL_BODY_AWARENESS will compile Full-body-awareness support. Define macro _MOD_VIEW_BODY will compile view-body support.

About View flashlight mod

Define macro _MOD_VIEW_LIGHT will compile flashlight on player view support.

If want to port Quake4 or Prey(2006) to PC or other platform of based on DOOM3 engine open-source version, because DIII4A based on Android platform and OpenGLES, so has some differences with original version. But I mark some macros in source as patches at all changes, although must find these macros in source code and manual use these patches.

And for keeping original DOOM3 source file structures, for all new source files, I put them on a new folder, and in these folder has same directory structure with DOOM3(e.g. framework, renderer, idlib...).

* Quake 4

_RAVEN, _QUAKE4 is patches macros, find them in DIII4A source code.

All new sources files put on raven folder.

1. _RAVEN: for compile core engine (DOOM3 source code) and idlib (DOOM3 source code).
2. _QUAKE4: for compile game (Q4SDK source code) library.
3. Build core engine: define macro _RAVEN, _RAVEN_FX(OpenBSE if need, unnecessary)
4. Build game library: define macro _RAVEN, _QUAKE4

About BSE

Because BSE not open-source, so I default supply a NULL implement and a uncompleted but working implement with DOOM3 Particle/Fx system(using macros _RAVEN_FX marked).

About BOT mod

Define macro MOD_BOTS will compile SABot a7(from DOOM3) mod source code for bot support in multiplayer-game.

About Full body awareness mod

Define macro _MOD_FULL_BODY_AWARENESS will compile Full-body-awareness support. Define macro _MOD_VIEW_BODY will compile view-body support.

* Prey(2006)

_HUMANHEAD, _PREY is patches macros, find them in DIII4A source code.

All new sources files put on humanhead folder.

1. _HUMANHEAD: for compile core engine (DOOM3 source code) and idlib (DOOM3 source code).
2. _PREY: for compile game (PreySDK source code) library.
3. Build core engine: define macro _HUMANHEAD
4. Build game library: define macro _HUMANHEAD, _PREY, and original SDK macros HUMANHEAD

About Full body awareness mod

Define macro _MOD_FULL_BODY_AWARENESS will compile Full-body-awareness support.

Android

1. Define macro __ANDROID__.
2. _OPENSLES: Add OpenSLES support for sound.

Linux

1. REQUIRE ALSA, zlib, X11, EGL, SDL2
2. ./cmake_linux_build_doom3_quak4_prey.sh

Windows(MSVC)

1. REQUIRE SDL2, cURL, zlib: vcpkg install SDL2 curl
2. Setup your vcpkg.cmake path
3. cmake_msvc_build_doom3_quak4_prey.bat
4. Copy OpenAL32.dll from vcpkg package path to binary path: vcpkg install OpenAL-Soft

---

Run idTech4A++ on other Android application with Android intent

1. Setup game type with game key: also see Q3E/com.n0n3m4.q3e.Q3EGameConstants.java GAME_XXX constants. Valid value: doom3 quake4 prey2006 quake2 quake3 rtcw tdm quake1 doom3bfg gzdoom etw realrtcw fteqw openja openjo samtfe samtse xash3d
2. Setup game command arguments with command key. Starts with game.arm

e.g. Run CS1.6 with Xash3D engine

startActivity(new Intent().setComponent(new ComponentName("com.karin.idTech4Amm", "com.n0n3m4.q3e.Q3EMain"))
		.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TASK)
		// 1. Setup game type
		.putExtra("game", "xash3d")
		// 2. Setup game command
		.putExtra("command", "game.arm -ref gles1 -console -dev 2 -gamedir cstrike -game cstrike -gamelibdir /data/app/~~tBiIEpYUhA3P4wkarcd1AA==/su.xash.cs16client-p0-kOTTN2iU3ZewCcNXsrA==/lib/arm64 -dll /data/app/~~tBiIEpYUhA3P4wkarcd1AA==/su.xash.cs16client-p0-kOTTN2iU3ZewCcNXsrA==/lib/arm64/libserver.so -clientlib /data/app/~~tBiIEpYUhA3P4wkarcd1AA==/su.xash.cs16client-p0-kOTTN2iU3ZewCcNXsrA==/lib/arm64/libclient.so -menulib /data/app/~~tBiIEpYUhA3P4wkarcd1AA==/su.xash.cs16client-p0-kOTTN2iU3ZewCcNXsrA==/lib/arm64/libmenu.so")
		);
finish();

---

Bot support on DOOM3/Quake4

1. Extract doom3/d3_sabot_a7.pk4(DOOM 3) or q4base/q4_sabot_a9.pk4(Quake 4) file in apk to game data folder, it includes some defs, scripts and MP game map AAS file(version < 66).
2. Set cvar harm_g_autoGenAASFileInMPGame to 1 for generating a bad AAS file when loading map in Multiplayer-Game and not valid AAS file in current map, you can also put your MP map's AAS file to maps/mp folder(botaa48 on DOOM 3, botaa32 on Quake 4).
3. Set harm_si_autoFillBots to -1 for automatic fill bots when start MP game.
4. Set harm_g_botEnableBuiltinAssets to 1 for enable built-in bot assets if external assets missing(version >= 66), so only need MP game map aas files.

cvars:

• harm_si_botLevel: Setup bot level.
• harm_si_botWeapons: Setup bot default weapons.
• harm_si_botAmmo: Setup bot weapons ammo clip.

command:

• addBot: adds a new bot
• removeBot: removes bot specified by id (1,31)
• addBots: add multiplayer bots batch
• removeBots: disconnect multi bots by client ID
• fillBots: fill bots to maximum of server
• appendBots: append more bots(over maximum of server)
• cleanBots: disconnect all bots
• truncBots: disconnect last bots
• botLevel: setup all bot level
• botWeapons: setup all bot initial weapons
• botAmmo: setup all bot initial weapons ammo clip

---

Full-body-awareness on DOOM3/Quake4/Prey(2006)

cvars:

• harm_pm_fullBodyAwareness: enables full-body awareness
• harm_pm_fullBodyAwarenessOffset: full-body awareness offset, format is " "
• harm_pm_fullBodyAwarenessHeadJoint: head joint when without head model in full-body awareness
• harm_pm_fullBodyAwarenessFixed: do not attach view position to head in full-body awareness
• harm_pm_fullBodyAwarenessHeadVisible: do not suppress head in full-body awareness

example:

1. Make full-body-awareness mode(view player model like first-person view)

harm_pm_fullBodyAwareness 1
harm_pm_fullBodyAwarenessOffset 5 0 0
harm_pm_fullBodyAwarenessHeadVisible 0
harm_pm_fullBodyAwarenessFixed 0

2. Make third-person mode and use crosshair(different from pm_thirdPerson)

harm_pm_fullBodyAwareness 1
harm_pm_fullBodyAwarenessOffset -55 -15 0
harm_pm_fullBodyAwarenessHeadVisible 1
harm_pm_fullBodyAwarenessFixed 1

---

Player view flashlight on DOOM3

cvars:

• harm_ui_showViewLight: show view flashlight
• harm_ui_viewLightShader: view flashlight material texture/entityDef name
• harm_ui_viewLightRadius: view flashlight radius, format is "<light_target> <light_right> <light_up>"
• harm_ui_viewLightOffset: view flashlight origin offset, format is " "
• harm_ui_viewLightType: view flashlight type. 0=spot light; 1=point light
• harm_ui_viewLightOnWeapon: player view flashlight follow weapon position

bind to key for toggle flashlight

// e.g. binding 'G' key, edit DoomConfig.cfg or autoexec.cfg file, and add this line:
bind "g" "_impulse52"

example:

1. Make spot flashlight(like flashlight weapon)

harm_ui_showViewLight 1
harm_ui_viewLightShader lights/flashlight5
harm_ui_viewLightRadius 1280 640 640
harm_ui_viewLightOffset 0 0 0
harm_ui_viewLightType 0

2. Make point flashlight

harm_ui_showViewLight 1
harm_ui_viewLightShader lights/flashlight5
harm_ui_viewLightRadius 640 640 640
harm_ui_viewLightOffset 0 0 20
harm_ui_viewLightType 1

---

Player body view on DOOM3/Quake4

1. Declaration player_viewbody

entityDef player_viewbody { // default name is player_viewbody, or setup in player entity with property 'player_viewbody'
    "spawnclass"				"idViewBody"
    "body_model"                "player_model_torso_and_lower_body" // body's md5 model: animations's name same as player model: string
    "body_offset"               "-15 0 0" // extras model offset: vector <forward right up>, default = 0 0 0
    "body_allChannel"			"0" // play animation with all channels, else only play with legs channel: bool, default = 1
    "body_usePlayerModel"		"0" // use player model and not use 'body_model': bool, default = 0
    // "anim run_forward" 		"walk_forward" // override model animation name: string, "anim <model animation name>" "<replace animation name>"
	
	// Hide surface only for Quake4
    "body_hidesurfaces" 		"shader_head,shader_toast" // hide surface names, separate by ',': string
    "hidesurface1" 			"shader_arm" // hide surface name by entity property: string, hidesurfaceXXX
    "hidesurface5" 			"shader_neck"
    "hidesurface6" 			"shader_hand"
}

2. Set player player_viewbody spawn argument

// on player.def
entityDef player {
    "player_viewbody"				"player_viewbody" // setup idViewBody's entityDef
}

3. DOOM3's player view body model declaration(animations name same as idPlayer's model)

// DOOM3 view body model example:
model player_model_torso_and_lower_body {
    offset (0 0 0)
    model models/md5/player_model_torso_and_lower_body.md5mesh

// loop anims:
    idle models/md5/player_model_torso_and_lower_body/idle.md5anim
    run_forward models/md5/player_model_torso_and_lower_body/run_forward.md5anim
    run_backwards models/md5/player_model_torso_and_lower_body/run_backwards.md5anim
    run_strafe_left models/md5/player_model_torso_and_lower_body/run_strafe_left.md5anim
    run_strafe_right models/md5/player_model_torso_and_lower_body/run_strafe_right.md5anim
    walk models/md5/player_model_torso_and_lower_body/walk.md5anim
    walk_backwards models/md5/player_model_torso_and_lower_body/walk_backwards.md5anim
    walk_strafe_left models/md5/player_model_torso_and_lower_body/walk_strafe_left.md5anim
    walk_strafe_right models/md5/player_model_torso_and_lower_body/walk_strafe_right.md5anim
    crouch models/md5/player_model_torso_and_lower_body/crouch.md5anim
    crouch_walk models/md5/player_model_torso_and_lower_body/crouch_walk.md5anim
    crouch_walk_backwards models/md5/player_model_torso_and_lower_body/crouch_walk_backwards.md5anim
    fall models/md5/player_model_torso_and_lower_body/fall.md5anim

// single anims:
    crouch_down models/md5/player_model_torso_and_lower_body/crouch_down.md5anim
    crouch_up models/md5/player_model_torso_and_lower_body/crouch_up.md5anim
    run_jump models/md5/player_model_torso_and_lower_body/run_jump.md5anim
    jump models/md5/player_model_torso_and_lower_body/jump.md5anim
    hard_land models/md5/player_model_torso_and_lower_body/hard_land.md5anim
    soft_land models/md5/player_model_torso_and_lower_body/soft_land.md5anim
}

4. Quake4's player view body model declaration(animations name same as idPlayer's model)

// Quake4 view body model example:
model player_model_torso_and_lower_body {
    offset (0 0 0)
    model models/md5/player_model_torso_and_lower_body.md5mesh

// loop anims:
    idle models/md5/player_model_torso_and_lower_body/idle.md5anim
    run_forward models/md5/player_model_torso_and_lower_body/run_forward.md5anim
    run_backwards models/md5/player_model_torso_and_lower_body/run_backwards.md5anim
    run_strafe_left models/md5/player_model_torso_and_lower_body/run_strafe_left.md5anim
    run_strafe_right models/md5/player_model_torso_and_lower_body/run_strafe_right.md5anim
    walk_forward models/md5/player_model_torso_and_lower_body/walk_forward.md5anim
    walk_backwards models/md5/player_model_torso_and_lower_body/walk_backwards.md5anim
    walk_left models/md5/player_model_torso_and_lower_body/walk_left.md5anim
    walk_right models/md5/player_model_torso_and_lower_body/walk_right.md5anim
    crouch models/md5/player_model_torso_and_lower_body/crouch.md5anim
    crouch_walk models/md5/player_model_torso_and_lower_body/crouch_walk.md5anim
    crouch_walk_backward models/md5/player_model_torso_and_lower_body/crouch_walk_backward.md5anim
    fall models/md5/player_model_torso_and_lower_body/fall.md5anim

// single anims:
    crouch_down models/md5/player_model_torso_and_lower_body/crouch_down.md5anim
    crouch_up models/md5/player_model_torso_and_lower_body/crouch_up.md5anim
    run_jump models/md5/player_model_torso_and_lower_body/run_jump.md5anim
    jump models/md5/player_model_torso_and_lower_body/jump.md5anim
    hard_land models/md5/player_model_torso_and_lower_body/hard_land.md5anim
    soft_land models/md5/player_model_torso_and_lower_body/soft_land.md5anim
}

5. enable view body by cvar

harm_ui_showViewBody 1

---

About:

• Source in assets/source folder in APK file.
• Using exportGLSLShaderSource command can export GLSL shaders.

---

Branch:

master:

• /idTech4Amm: frontend source
• /Q3E /Q3E/src/main/jni/doom3: game source
• /CHECK_FOR_UPDATE.json: Check for update config JSON

free:

• For F-Droid pure free version.

package:

• /screenshot: screenshot pictures
• /source: Reference source
• /pak: Game resource

n0n3m4_original_old_version:

• Original old n0n3m4 version source.

---

Extras download:

• Baidu网盘: https://pan.baidu.com/s/1hXvKmrajAACfcCj9_ThZ_w 提取码: pyyj
• Baidu贴吧: BEYONDK2000
• F-Droid(different signature)

---

Open source licence

Game engine

• DOOM 3: GPLv3
• Quake4 SDK
• Prey SDK
• RBDOOM-3-BFG
• TheDarkMod
• ioq3
• iortcw
• yQuake2
• Darkplaces
• GZDOOM
• ETLegacy
• RealRTCW
• FTEQW
• OpenJK
• SeriousSamClassic
• Xash3D

Library(Source)

• cJSON
• curl: The curl license
• etc2comp
• flac: GNU Free Documentation License / GNU GENERAL PUBLIC LICENSE Version 2 / GNU LESSER GENERAL PUBLIC LICENSE Version 2.1 / BSD-3-Clause license
• fluidsynth
• freetype: The FreeType License / The GNU General Public License version 2
• iconv
• irrxml
• libjpeg
• libogg
• libpng
• libsndfile
• libvorbis
• lua
• mbedtls
• miniz
• minizip
• mp3lame
• mpg123
• oboe
• Omni-Bot
• openal-soft
• openssl
• opus
• pugixml
• soil
• sqlite
• stb
• bzip2
• SDL2

Library(Binary)

• ffmpeg-kit

---