yquake2remaster/README.md

# Yamagi Quake II Remaster

This is an experimental fork of Yamagi Quake II with ongoing work to add
support for Quake II Enhanced aka Q2 Remaster(ed). This enhanced version
has a lot non trivial changes, adding support isn't easy and takes time.
Feel free to try this code but you mileage may vary.

Have a look at the yquake2 repository for the "normal" Yamagi Quake II:
https://github.com/yquake2/yquake2

State:
 * GL1:
   * base1: correct wall light, broken model light
   * base2: correct wall light, broken model light, broken lift
   * q64/outpost: no known issies
   * mguhub: loaded, transparent walls and broken logic for surface fall in next maps
 * GL3/GLES3:
   * base1: broken wall light, broken model light
   * base2: broken wall light, broken model light, broken lift
   * q64/outpost: no known issies
   * mguhub: loaded, transparent walls and broken logic for surface fall in next maps
 * SOFT:
   * base1: broken wall light, broken model light
   * base2: broken wall light, broken model light, broken lift
   * q64/outpost: no known issies
   * mguhub: loaded, transparent walls and sky and broken logic for surface fall in next maps
 * VK:
   * base1: correct wall light, broken model light
   * base2: correct wall light, broken model light, broken lift
   * q64/outpost: no known issies
   * mguhub: loaded, transparent walls and broken logic for surface fall in next maps

Monsters:
  * incorrect weapon effect for Shambler
  * incorrect dead animation for Arachnoid
  * broken fire effect for Guardian

Goals (none of it finished):
  * Single player support,
  * BSPX DECOUPLEDLM light map support (base1),
  * QBSP map format support (mguhub),
  * MD5 model support,
  * modified ReRelease game code support with removed KEX only related code,
  * RoQ and Theora cinematic videos support.

Bonus goals:
  * MDL/Quake1 model format support,
  * FM/Heretic 2 model format support,
  * Daikatana model/wal/map format support,
  * Cinematic videos support in smk, mpeg format,
  * Use ffmpeg for load any video,
  * Load colormap as 24bit color,
  * Use shared model chache in client code insted reimplemnet in each render,
  * Add debug progress loading code.

Not a goal:
  * multiplayer protocol support with KEX engine,
  * support KEX engine features (inventary, compass and so on),
  * [KEX game library support](https://github.com/id-Software/quake2-rerelease-dll).

Code tested with such [maps](doc/100_tested_maps.md).

# Yamagi Quake II


Yamagi Quake II is an enhanced client for id Software's Quake
II with focus on offline and coop gameplay. Both the gameplay and the graphics
are unchanged, but many bugs in the last official release were fixed and some
nice to have features like widescreen support and a modern OpenGL 3.2 renderer
were added. Unlike most other Quake II source ports Yamagi Quake II is fully 64-bit
clean. It works perfectly on modern processors and operating systems. Yamagi
Quake II runs on nearly all common platforms; including FreeBSD, Linux, NetBSD,
OpenBSD, Windows and macOS (experimental).

This code is built upon Icculus Quake II, which itself is based on Quake II
3.21. Yamagi Quake II is released under the terms of the GPL version 2. See the
LICENSE file for further information.

## Documentation

Before asking any question, read through the documentation! The current
version can be found here: [doc/010_index.md](doc/010_index.md)

## Releases

The official releases (including Windows binaries) can be found at our
homepage: https://www.yamagi.org/quake2
**Unsupported** preview builds for Windows can be found at
https://deponie.yamagi.org/quake2/misc/