Manix WHDLoad Pack

README
Short:    HD-Installer for Manix
Author:   Bored Seal, DJ Mike (djmike@crystalmike.com)
Version:  2.0
Type:     game/patch
Requires: WHDLoad 18, 512k chip mem

This patch applies to "Manix" © 1990 Millennium
You will require the original disk, or an image. Supports two versions:
- SPS 2530
- SPS 2533

If you previously installed the game with v1.0-1.1, you will need to reinstall.

REQUIREMENTS:
- Install requires WHDLoad 18, RawDIC 5.0
- Game requires 512k chip mem
  (+additional memory for preload option)

FEATURES:
- Loads entirely from HD using real files (extracted with RawDIC imager)
- Rob Northen Copylock protection fully removed
- Quit to Workbench at any time, including 68k machines
- Set CUSTOM1=1 for infinite money
- Loads and saves highscores (except if you cheat)
- Fully supports custom level saves via in-game editor
- Use CUSTOM2=0-9 to set save 'slot' if you want more custom level sets
- "Init Disk" in editor disabled as not needed (was bugged in the real game!)
- Trainers added - use CUSTOM1 to set:
  + 1 to enable in-game cheat keys
  + 2 for infinite lives
  + 4 for infinite time
  + 8 for infinite weapons
- In-game cheat keys if enabled:
  * L - toggle infinite lives
  * T - toggle infinite time
  * K - toggle infinite weapons
  * HELP - skip level
- Settings can be configured from splash screen
- Keyboard routine replaced for better reliability
- Decompression relocated to fast memory if available
- 6x Atari ST address accesses fixed
- Byte write to audio register fixed
- 16x blitter waits added
- 2x CPU-dependent loops in audio player fixed
- RomIcon/NewIcon/ColIcon included
- Manual included
- Source code included

HISTORY
Version 2.0 (2023-01-29) by DJ Mike
- Bug with copylock removal fixed (issue #6004)
- Reworked slave for WHDLoad 18 (splash screen config)
- Quit key now works on 68000 machines
- Now installs as real files using RawDIC (takes less than half the space!)
- Game's own highscore loading/saving now works
- Custom level settings editing/saving supported
- Trainers and in-game cheat keys added
- Keyboard routine replaced for better reliability
- NewIcon updated and ColIcon added
- Manual added
- Source code included

Version 1.1 (2003-09-10) by Bored Seal
- slave optimised, blitter waits + snoop mode bug fixed

Version 1.0 (1998-12-29) by Bored Seal
- Initial release

Thanks to Lempkee for the disk image.

WORDS FROM THE AUTHOR

This was an interesting game to take a look at. There was a bug with the removal
of the copylock where an address in memory had been nop'd ($4e71) instead of
being set to $0. The game does a sneaky check at level 8 to see if the value
is correct, and crashes if not. Delving into the copylock revealed that it
takes an address in a0, and does an eor of the key to that address, so if the
key is right the address gets "cleared". In other words, if you look at that
address in the code you can see the copylock key hiding in plain sight...
... so not very hidden at all. :-)

Further investigation revealed that the game uses a file table stored on the
disk, which meant installing as real files was straightforward, and speeds
things up a bit as the game was previously loading the filetable every time it
needed to load anything from the disk!

The game also has built in support for saving highscores as well as custom
level settings editing, which I've now fixed to work. If you save custom levels
they will be saved in additional files ending ".save0" (or 1-9 if you change
the slot with CUSTOM2), so that the original install data isn't corrupted.
Interestingly, the original game has a bug if you try to use the editor's
"Init Disk" function: failing to eject the game disk before selecting it
results in the game hanging. The cause is the game trying to read a single byte
of a file to test for it, only the load routine doesn't support it. I've just
disabled that option altogether, as you don't need to be formatting disks now.

Finally there are some trainers added, including a level skip.

Enjoy!

Greetings to Codetapper, Wepl and all the WHDLoad team!

-- DJ Mike (29th January 2023)

         Bug report form, full WHDLoad package and other installs:
                          http://www.whdload.de/

THIS PACKAGE COMES WITH ABSOLUTELY NO WARRANTY OF ANY KIND, EITHER EXPRESS OR
IMPLIED, STATUTORY OR OTHERWISE. THE ENTIRE RISK AS TO USE, RESULTS AND
PERFORMANCE OF THE PACKAGE IS ASSUMED BY YOU AND IF THE PACKAGE SHOULD PROVE
TO BE DEFECTIVE, YOU ASSUME THE ENTIRE COST OF ALL NECESSARY SERVICING,
REPAIR OR OTHER REMEDIATION.
UNDER NO CIRCUMSTANCES, CAN THE AUTHOR BE HELD RESPONSIBLE FOR ANY DAMAGE
CAUSED IN ANY USUAL, SPECIAL, OR ACCIDENTAL WAY, ALSO IF THE OWNER OR A THIRD
PARTY HAS BEEN POINTED AT SUCH POSSIBILITIES OF DAMAGE.