Heretic2R

Heretic2R is Heretic II (1998, Raven Software) reverse-engineered source port.

Features

• Widescreen support (with automatic HUD scaling).
• Rendering framerate decoupled from network packets sending rate (with theoretical maximum of 1000 FPS).
• OGG music playback.
• Most of special effects are updated at rendering framerate (instead of 20 FPS).
• Improved map loading times.
• Lots of cosmetic improvements (so the game plays as you remember it, not as it actually played).
• Many bugfixes.

Installation

Game data:
Heretic2R requires Heretic II game data in order to run. You can either:
– Overwrite Heretic II binaries with the Heretic2R ones.
or
– Copy "Heretic II\base" folder (excluding all .dll files) to Heretic2R folder.

---

NOTICE: make sure your copy of Heretic II is updated to v1.06, otherwise Heretic2R will not work correctly because of missing models/textures/sounds.

• If you are not sure, the presence of "base\models\items\Defense\tornado\tris.fm" and "base\models\items\Defense\tornado!skin.pcx.m8" files is a good indication that your copy is already updated to v1.06.
• If said files are missing, you can either install Heretic II v1.06 official patch (also known as Heretic II Enhancement Pack), or extract Heretic_II_Patch_106_for_H2R.zip archive into Heretic II folder.

---

Music:
To enable OGG music playback, rip Heretic II CD tracks as track02.ogg - track14.ogg and place them in "base\music" folder.

Technical notes

• H2R savegames/configs/screenshots/logs are stored in "%USERPROFILE%\Saved Games\Heretic2R".
• Singleplayer works, and is relatively well tested. The game is completable without major issues.
• Coop/multiplayer works, but is practically untested.
• By default, H2R uses network protocol 55 (H2 protocol 51 is also supported, but not recommended). Can be changed using "protocol" cvar.
• H2R savegames are NOT compatible with H2 savegames.
• H2R is NOT compatible with H2 renderers (because of API changes).
• H2R is NOT compatible with H2 sound backends (because of API changes).
• H2R is NOT compatible with H2 gamex86/Player/Client Effects libraries (because of API changes).
• GameSpy online multiplayer logic is not implemented.
• Gamepad support is currently not implemented.
• HiDPI support is currently not implemented.
• Framerates above 60 FPS are not tested.
• Screen resolutions above FullHD are not tested.

Planned features

• OpenGL 3 renderer.
• OpenAL sound backend.
• Gamepad support.

Used libraries

• glad
• libsmacker
• SDL3
• stb (specifically, stb_image_write and stb_vorbis)

SAST Tools

PVS-Studio - static analyzer for C, C++, C#, and Java code.