Short : HD Installer for Crystal Kingdom Dizzy
Author: DJ Mike/Action! (djmike@crystalmike.com)
Version: 2.0a
Type: game/patch
Requires: WHDLoad 18, RawDIC 5.0, 512k chip mem

This patch applies to "Crystal Kingdom Dizzy" © 1993 Code Masters.

Two versions are supported, including SPS #109.

REQUIREMENTS

- Original disks or compatible disk images
- Slave requires WHDLoad 18+
- Game requires 512k chip memory
  (+ approx 1MB other memory for preload option)
- If you used v1.0 of this install, you must reinstall for v2.0

FEATURES

- Game loads fully from HD
- System friendly disk imager using RawDIC
- Uses real files (which also reduces install size)
- Rob Northen Copylock protection removed
- Quit game at any time (default key F10), including on 68000 machines
- CD32 joypad also quits game - hold shoulder buttons and pressing yellow
- Files with custom compression are unpacked during install for faster loading
- 6x missing blitter waits fixed
- 2x missing bplcon0 color bit settings fixed
- Illegal adkconr write fixed
- 4x empty DBF loops fixed in music player
- Extra delay added to end of level/game screens - skip with fire button
  OR you can enable BUTTONWAIT to wait indefinitely until button pressed
- 2nd/blue button jump supported (set CUSTOM1=1, or +1 to existing setting)
  (NOTE: 'Up' is still used for climbing ladders, inventory, etc.)
- Opening developer logos skipped by default (re-enable with CUSTOM1=8)
- Game Genie screen also skipped (re-enable with CUSTOM1=16)
- In-game cheat keys (CUSTOM2=1 to enable, or +1 to existing setting):
  - F1 toggles infinite lives
  - F2 toggles fast Dizzy
  - F3 toggles super fast Dizzy
  - F4 toggles infinite time in Ice Palace crystal run
  - F5 toggles invulnerability to knockout damage from animals
  - F6 skips to the next level
- Can also specify trainers on startup:
  - Infinite lives (CUSTOM2=2, or +2 to existing setting)
  - Faster Dizzy movement (CUSTOM2=4, or +4 to existing setting)
  - Super Fast Dizzy (CUSTOM2=8, or +8 to existing setting)
    You can tweak this speed by setting CUSTOM4 - default is 20
    (This overrides Faster Dizzy if both are set)
  - Infinite time in Ice Palace (CUSTOM2=16, or +16 to existing setting)
  - Invulnerability to knockout (CUSTOM2=32, or +32 to existing setting)
- Choose starting level (CUSTOM3=0-3 for levels 1-4 respectively)
- Icons by Mad-Matt and DJ Mike
- Source code included

HISTORY

Version 2.0a (2021-07-26) by DJ Mike/Action!
- Bug with Install script fixed

Version 2.0 (2021-07-25) by DJ Mike/Action!
- Rewritten install from scratch using modern WHDLoad functionality
- Supported second version (SPS #109)
- New disk imager using RawDIC
- Now installs real files, which reduces install size
- Reduced chip memory to 512k
- Quit key now works on 68000 machines
- Sound effects mode fixed (broken due to missing disk 1 load)
- Supported CD32 controller including 2nd button to jump
- Custom compressed files are unpacked during install for faster loading
- Missing blitter waits fixed
- Missing bplcon0 color bit settings fixed
- Illegal adkconr write fixed
- Empty DBF loops fixed
- Trainers added
- Skips opening logos and Game Genie by default as they are slow to load
- Icons by Mad-Matt and DJ Mike added
- Source code now included

Version 1.0 (1999-04-19) by Keith Krellwitz (Abaddon)
- Initial release

THANKS

- Chris Vella for originally supplying one version
- Bert Jahn for WHDLoad
- Asman, Wepl, Girv & JOTD for ReadJoypad.s used in this install
- Codetapper for knowledge share and general banter

WORDS FROM THE AUTHOR

Another Dizzy game whose install was long overdue for an update! The version on
SPS was missing support, and there were some missing nice-to-have features like
2nd button jump and trainers I wanted to add.

Supporting both versions was quite time consuming. They're basically the same,
but one has had some tweaks and optimisations compared to the other. While the
broad layout of the code is the same, there are subtle differences everywhere
that meant I couldn't just use a single offset to port the patch from one to
the other - every routine needed me to re-check its position manually!

I've changed over to using real files for the install, as there's a lot of
wasted space on the disks, and I think it's nicer to be able to get at the
files used by the game more easily (e.g. music). It also means you can pack the
files using RNC or any other method WHDLoad supports if you want.

The game has some incredibly slow loading times! I've been able to pick this
up a bit by skipping unnecessary sequences (developer logos, Game Genie), which
can always be re-enabled if you want. The RawDIC imager also unpacks the
compressed game files (mostly music+sound effects), as the decompression in
game is very slow. An advantage to this is you can load the ProTracker music
now if you want - files data53/54/55/85/86/87 are all the tunes. 

The fast/super fast Dizzy speeds are different values to the same trainer, that
was originally a Game Genie code. "Fast" is the original boost, while super is
a value I felt OK as an even faster mode. If you want to play with the speed
you can set CUSTOM4=x to try other values for "super fast". (Default is 20.)
I felt it was simpler for the trainer to keep to a couple of speeds. :-)

While testing the infinite time trainer for the Ice Palace level, I realised
it was possible to cheat to freeze time anyway - when the timer appears, move
a little to the left and it triggers the 'failure' event that stops time, but
if you haven't moved over enough you can still go right into the maze, and get
the crystal anyway! Developer bug, or intentional cheat? You decide!

I had a lot of fun making this patch, especially finding different trainers
I could add to make the game less frustrating. It's not the best Dizzy (and
quite easy really), but it's a fun diversion for a bit. Enjoy!

--- DJ Mike (25.07.2021)

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

            ________  ________  ________  ____  ________  ________
           _)       \_)       \_)       \_)   \_)       \_)       \
   __ ___ /___/     /   /_____/\  /     /     /   /     /   /     /
  /_//__// \___    /   /     /CT\/     /     /   /     /   /     /
        /___/     /___      /   /     /_____/___      /___/     /___ __
            \____/    \____/    \____/          \____/    \____//__//_/