Help file for Acorn DeHackEd Port - Version 0.14 Beta
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

What is it?
~~~~~~~~~~~

This is an early port of DeHackEd, the Doom engine 
editor.  It allows the easy (?) editing of loads of 
constants in the Doom Engine.  This allows you to modify 
Doom so that the baddies behave differently, look different
etc.

The original DeHackEd was designed, conceived, and written
by Greg Lewis, and most of the credit should go to him.

More info avaliable in the Docs directory inside DeHackEd


What's it support?
~~~~~~~~~~~~~~~~~~

Versions 1.00 and 1.01 of Doom8, Doom8HR, Doom24, Doom24HR
are supported by this release.

DeHackEd will attempt to autodetect the engine version.
If it is able to ascertain the version it will update the
'Version' field in the setup window.

ONLY the R-Comp Interactive / Eddie Edwards Doom engine is 
supported. The reason for this is that RCI spent time and 
money to develop the Acorn games market and deserve your
support - if you want to edit Doom then BUY IT FIRST.


What's it do?
~~~~~~~~~~~~~

Currently there is full support for editing things, frames,
weapon tables and sounds. 
There is partial support for editing sprites.
You can load text style DeHackEd patches and the relevent
data will be read in.
You can patch all of the RCI engines currently released.


What needs adding?
~~~~~~~~~~~~~~~~~~

Editing of misc data (init health, armour etc)
Editing of Text (Gulp!)
Viewing of Graphics
Copying of data from one object to another
Nicer UI
Proper error checking
Proper manual (try the original ones in the DOCS dir)

Future version will be posted to the RCI Doom download site
and my webpages (URL below).

Setting it up
~~~~~~~~~~~~~

First make a BACKUP copy of !Doom - I usually place it in
a directory called Hack to remind me what it is.

Copy DeHackEd to a convenient place and then run it. It will
complain that 'Initialisation was not able to successfully
complete.." etc. 

Click OK and then click the middle button
over the DeHackEd icon on the iconbar and select Setup...

Drag the !Doom application that you wish to edit (backed up
of course!) to the white arrow in the '!Doom application
location:' section. Then select the appropriate Doom engine
from the radio icons to the right.

Now drag your 'Ultimate' WAD to the white arrow next to
Doom I, and your Doom2 WAD to the white arrow next to
Doom II. The WADS will not be changed but are needed for 2
reasons. The first is a legal requirement of id that users
must have a full commercial WAD. The second reason is that
they will be used when playing soundfx.

Finally click on the 'Save' button.  There will be some disc
activity, and a message box stating that 'Engine is crunched
- uncrunching...', followed by 'Done.' The message box will
the disappear  - you are now ready to start editing Doom!

If you look in the setup window again you will hopefully see
that the 'Version:' field has been filled in automagically.

The last thing you may wish to change is the command that is
used to run Doom, when you choose 'Run Patched' from the
menu.  This line can be changed from the file 'Choices'
inside DeHackEd.

Simply load the choices file and scroll down until you find
a line starting 'Run String=' you can then change this to
the appropriate string.

The default value is <doom$dir>.^.doom2
DeHackEd will automatically run the Doom engine you are
currently editing, and will add this string to the command
it passes.

The <doom$dir>.^.doom2 specifies that the doom engine should
use the doom2 WAD in the same directory as the currently
booted !Doom application.

You may also wish to add parameters for the HR version ie.
<doom$dir>.^.doom2 -x 640 -y 480


Boring Legal bit
~~~~~~~~~~~~~~~~

DeHackEd is fully supported by RCI who have been most
helpful. Patching the Doom Engine in the comfort of your
own home is legal.

Patching 'free-doom' engines that are not part of the RCI
release is /expressly/ forbidden. The program won't work,
and will in fact try to stop you. Anyone doing so IS going
to go to Hell...

All code in DeHackED is FREEWARE. You may freely copy it,
but may not alter or make profit from it. Original version
copyright Greg Lewis, sources avaliable if you ask him 
nicely...

You may NOT distribute patched versions of the Doom Engine.
Instead you may distribute Patch files as saved by DeHackEd.

Future projects
~~~~~~~~~~~~~~~

Currently my main project is a really nice virus killer,
with more features and faster than Killer. It's getting near
to releasable and is currently being BETA'd.
I hope to get AliensTC working on the Acorn
Possible port of DEUSF / DEUTEX (NOT DEU)


Contacting me
~~~~~~~~~~~~~

If you have any comments, suggestions, bug-reports etc then
please contact me via e-mail at;

lgraham@argonet.co.uk


Cheers,
Luke Graham
Kiwi Software
http://www.argonet.co.uk/users/lgraham

____________________________________________________________

Credits must go to:

id Software, for bringing Doom to the world
R-Comp Interactive and Eddie Edwards for bringing Doom to
  the Acorn.
Greg Lewis for writing the original DeHackEd, and allowing
  me to port it.
Rob Kendrick for testing and critiscm

All trademarks acknowledged.
