Menu

Tree [0b1149] master hheretic-0.2.4 /
 History

HTTPS access


File Date Author Commit
 autotools 2023-01-21 Ozkan Sezer Ozkan Sezer [2f76b1] updated config.guess and config.sub
 base 2024-11-11 Ozkan Sezer Ozkan Sezer [e41d85] mus.c, mus.h: use h2stdinc.h
 dos 2021-01-07 Ozkan Sezer Ozkan Sezer [b6b469] removed svn:keywords properties.
 include 2024-11-11 Ozkan Sezer Ozkan Sezer [164b54] greatly clean-up audio_plugin.h, i_soundpi.c an...
 m4 2022-10-01 Ozkan Sezer Ozkan Sezer [9b127f] minor autotools update.
 opengl 2024-11-10 Ozkan Sezer Ozkan Sezer [100688] opengl: fix broken sky after previous segfault ...
 sdl 2024-11-11 Ozkan Sezer Ozkan Sezer [b48c6f] minor clean-ups in unix & sdl sources
 svgalib 2021-01-07 Ozkan Sezer Ozkan Sezer [b6b469] removed svn:keywords properties.
 unix 2024-11-11 Ozkan Sezer Ozkan Sezer [b48c6f] minor clean-ups in unix & sdl sources
 .gitignore 2024-10-24 Miro Kropacek Miro Kropacek [32e6fc] .gitignore config.h
 AUTHORS 2009-06-02 Ozkan Sezer Ozkan Sezer [e3d193] Updated the README file for v0.2.0. Added AUTHO...
 ChangeLog 2024-11-10 Ozkan Sezer Ozkan Sezer [d6458e] OpenGL: avoid buffer overrun in DrawRealPatch()...
 LICENSE 2009-05-18 Ozkan Sezer Ozkan Sezer [5e490b] Heretic and Hexen Sources Re-released Under the...
 Makefile.in 2024-11-11 Ozkan Sezer Ozkan Sezer [7c8f05] unix: added simple ALSA outut code based on xmp...
 README 2021-01-07 Ozkan Sezer Ozkan Sezer [41b552] minor README updates
 SAVEGAME 2010-01-29 Ozkan Sezer Ozkan Sezer [2eb438] minor editing.
 TODO 2009-06-04 Ozkan Sezer Ozkan Sezer [aa2ac7] updated the TODO list.
 autogen.sh 2009-05-18 Ozkan Sezer Ozkan Sezer [a4de3e] initial update to autotools support.
 config.h.in 2024-11-11 Ozkan Sezer Ozkan Sezer [7c8f05] unix: added simple ALSA outut code based on xmp...
 configure.ac 2024-12-04 Ozkan Sezer Ozkan Sezer [0b1149] configure.ac: fix/update audio backend selectio...

Read Me

				HHeretic v0.2.4

--------------------------------------------------------------------------------

				    About

This is a new release of Dan Olson's excellent Hacked Heretic by the authors
of Hammer of Thyrion (Hexen II).  We're applying fixes, adding a few features,
and ensuring it runs on most *nix operating systems.

--------------------------------------------------------------------------------

				   Prereqs

You need a Heretic wad file. Both the retail and the shareware version work
just fine.  It is recommended, but not required, that you patch your wad file
to the latest version, 1.2 for the shareware, 1.2 or 1.3 for the retail.  See,
at the end, for the md5sums and file sizes of different heretic wad files.

--------------------------------------------------------------------------------

				  Compiling

You'll need SDL and SDL-devel packages installed.

To compile the OpenGL version (hheretic-gl):
	./configure
	make

To compile the software version (hheretic-sdl):
	./configure --disable-gl
	make

The configure script accepts a new --with-audio=<driver> option.  Valid
values are oss, sdl, and sdlmixer.  sdl is the default option.  sdlmixer
adds the ability of midi music playback, therefore, to compile with midi
playback:

	./configure --with-audio=sdlmixer
	make

To compile the software version (hheretic-svga, for the old-fashioned :))
	./configure --enable-svga
	make

It's essential that you run make clean between different types of builds
or different types of targets.

--------------------------------------------------------------------------------

				Playing the Game

Put the file heretic.wad (registered) or heretic1.wad (shareware) in the same
directory where the hheretic binary is and simply run the binary, for example:

	./hheretic-gl

With the -h or --help option, you can see the basic command line switches.

The -file option can also be used to play any extra heretic wads that you may
have. The option takes as many wad filename arguments as you give to it, at
least one name, of course. Remember, though, that the -file option makes the
engine to load extra wads: you always need heretic.wad as the base wad.

Currently, varying screen widths/resolutions are only supported in OpenGL
mode. Use, for example,

	./hheretic-gl -width 1024 -height 768

A partial list of supported options is available using the "--help" option.

--------------------------------------------------------------------------------

			     Custom Music playback

Playback of external ogg, mp3 and midi files is available when hheretic is
configured with the "--with-audio=sdlmixer" option. This is done by placing
custom music files in $HOME/.hheretic/music .

A high quality OGG version of the original Heretic soundtrack is available for
download from Sycraft.org :  http://sycraft.org/content/audio/heretic.shtml
To install, download the normal or high quality archive and unzip it.  Create
the music directory:
	mkdir -p $HOME/.hheretic/music		(for most end users)
 or:
	mkdir -p <install_dir>/music		(if you prefer that way..)
 or:
	mkdir -p <shared_datapath>/music	(mostly for packagers)

Place the ogg files in that new "music" directory you just created. Now, when
the game is run, the new sound files should automatically be used.

--------------------------------------------------------------------------------

				     Hints

You can switch between windowed and fullscreen modes by the ALT-Enter key
combination.

Double-clicking with Mouse2 or Mouse3 acts as the 'activate' (or 'use') key.

There is still no way to assign mouse buttons to actions in the control-setup
menu; it needs some work.  Currently, the mouse buttons can only be
assigned to a few actions:

  mouseb_fire    (fire)
  mouseb_strafe  (strafe)
  mouseb_forward (move forward)

which is done by editing $HOME/.hheretic/heretic.cfg and changing these values.
Button values are:

  left   mouse button = 0
  middle mouse button = 1
  right  mouse button = 2
  unused              =-1

So, to make the right button fire, change the mouseb_fire line in heretic.cfg,
like so:

  mouseb_fire 2

--------------------------------------------------------------------------------

				  Known Bugs:

- Clipping issues on some maps with OpenGL. Some tall rooms can be seen through
  skies, ie. skies not clipped properly.

--------------------------------------------------------------------------------

				Notes / Issues:

- Saved game files are not interoperable between 32 and 64 bit and/or big endian
  and little endian machines: saves are byte order and word size dependant.

--------------------------------------------------------------------------------

				WAD file info:

Shareware 1.0:
  023b52175d2f260c3bdc5528df5d0a8c  heretic1.wad (5,120,300 bytes)

Shareware 1.2:
  ae779722390ec32fa37b0d361f7d82f8  heretic1.wad (5,120,920 bytes)

Registered 1.0 (3 episodes):
  3117e399cdb4298eaa3941625f4b2923  heretic.wad (11,096,488 bytes)

Registered 1.2 (3 episodes):
  1e4cb4ef075ad344dd63971637307e04  heretic.wad (11,095,516 bytes)

Retail 1.3 (Shadow of the Serpent Riders, extended, 5 episodes):
  66d686b1ed6d35ff103f15dbd30e0341  heretic.wad (14,189,976 bytes)

--------------------------------------------------------------------------------

				Short Changelog

Major changes in HHeretic-0.2 since Dan Olson's original HHeretic-0.1:

  * Support for 64 bit machines.
  * Support for big endian machines.
  * FreeBSD support.
  * Fixed structure packing enabling support for ARM, etc.
  * Support for newest gcc versions.
  * Updated build system with new configuration options.
  * SDL and SDL_mixer sound drivers in addition to OSS.
  * External ogg/mp3 music playback with the sdlmixer driver.
  * User directories fully implemented ( $HOME/.hheretic )
  * Screenshots, both opengl and software mode. Bound to F12.
  * Transparent automap feature.
  * Key configuration menu.
  * Finale screens of the episodes 2 and 3 implemented in opengl.
  * An additional svgalib video driver option.
  * ANSI endtext working properly on wide consoles.
  * Lots of bug fixes.

--------------------------------------------------------------------------------

				    Contact

https://sourceforge.net/projects/hhexen/
sezero_at_users.sourceforge.net
stevenaaus_at_gmail_com
Want the latest updates on software, tech news, and AI?
Get latest updates about software, tech news, and AI from SourceForge directly in your inbox once a month.