Readme for Duke Nukem 3D for Mac OS X
-------------------------------------

After some weeks of work, i've found and fixed hopefully most of the 
endianess-bugs from the original-port of icculus.org. You can play it, there's
Sound, you can save and load ... :)


Installation:
-------------
	
	- install the game from your cd on a pc
	
	- drag the Duke3D icon somewhere on your harddisk
	
	- copy the CONTENTS of the duke3d-directory (pc installation) into the resources
	  directory of Duke3D (mac icon) as follows:
	  
		1. right-click on the Duke3D icon and choose 'show package contents'
		2. locate the directory 'Resources' where you should find the file 'icon.icns'
		3. copy you duke3d-directory into this resources directory

	- enjoy :) 


Requirements:
-------------

	- Duke Nukem 3D ATOMIC EDITION, older versions won't work!!! Have a
	  look at www.3drealms.com or try your luck at Amazon, or Ebay...

	- Mac OS X

	- SDL (www.libsdl.org)
	
	- SDL_mixer (look for libraries at www.libsdl.org)

Remarks:
--------

The configuration of sound, keys etc. is inside of "duke3d.cfg". To change it,
you have to use a Editor who DON'T changes the MS/DOS-Format of this file!!! 
Theres no midi-playback certainly, so let the MIDI-Device at 13, this means
"no music".
Sound only works in 16bit now, so please don't change. 

Hm, in short: DON'T change anything in the config, except the Screenmode!!!

Tested on:
----------
	- eMac G4 700Mhz

Missing Features:
-----------------

	- no network
	- no midi music
	- you can't exchange saved games with ones from the x86-versions


The Sourcecode:
---------------

	- for building your own executable from the source, you need a fully
	  installed developer package, and the development versions
	  of SDL and SDL_mixer

	- there are 4 makefile. makefile_68kasm uses c + 68k assembler
	  routines, makefile_cross is for making a plain c version on a linux
	  pc (nice for debugging), makefile_plainc makes a plain c version 
	  on the amiga, and makefile_mos is for making the MorphOS version.
	  at least makefile_macosx is for making the Mac OS X version (not as an application bundle).



So, enjoy the coolest ego shooter ever made. Comments and Bugreports please 
send to cybin@neoscientists.org.

	
	Enjoy!
	
	-- original document by
		Daniel Trompetter (aka dante/oxyron)
	-- modified mac version by
		Michael Taubert (aka cybin/tek)