Trolls WHDLoad Pack

README
Short : HD Installer for Trolls
Author: Dark Angel, DJ Mike (djmike@crystalmike.com)
Version: 2.1
Type: game/patch
Requires: WHDLoad 19, RawDIC 5, memory varies per version

This patch applies to "Trolls" © 1993 Flair Software.

Six versions are supported:
- 3x ECS (A500) disk releases
- 2x AGA (A1200) disk releases (SPS #155 and SPS #996)
- CD32 release

REQUIREMENTS

- Original disk or compatible disk image
  (Cracks have not been tested and are not supported)
- Slave requires WHDLoad 19+
- ECS version requires 512k chip memory, 512k any memory
  (+ approx 1.75MB other memory for preload option)
- AGA version requires 2MB chip memory, 4k any memory
  (+ approx 1.75MB other memory for preload option)
- CD32 version requires 1,184k chip memory, 264k any memory
  (+ approx 3.62MB other memory for preload option)

FEATURES

- Game loads fully from HD
- Uses real files, extracted with system friendly RawDIC imager
- Quit game at any time (default key F10), including on 68000 machines
- [AGA/ECS] Manual protection fully removed
- [ECS] Long track protection check on one version removed
- [AGA/ECS] "Pack-Ice" files can be unpacked to speed up loading
- [CD32] OS calls removed (no Kickstart ROM required)
- Glitching audio fixed - due to CPU-dependent (empty DBF) loops
- Self modifying code in intro removed
- Access faults/disappearing graphics when at the top of any level fixed
- [CD32] Crash on Sodapop levels fixed
- Stack and decruncher moved to fast memory if available
- [AGA/CD32] Game code relocated to fast memory if available
- [AGA/CD32] Title screen fade in/out sped up
- Missing color bit settings in bplcon0 fixed
- Massive set of trainers - see section below for details
- 2nd/blue button jump support added (set CUSTOM2=1)
- Completely skip intro on start (set CUSTOM3=1)
- Intro can be skipped by pressing fire on all versions
- Ending screen can be exited from by pressing fire
- Data files can be (re)compressed with Propack/CrunchMania/FImp/XPK
- Color/New/Rom Icons included by Pascal and DJ Mike
- Manual included
- Source code included

TRAINERS

A large variety of trainers are available in all versions of the game.

Add any of the following to CUSTOM1 (or use the splash screen) to enable:
  + 1 for infinite lives
  + 2 for infinite energy
  + 4 for infintie credits
  + 8 for infinite oxygen
  + 16 for infinite time
  + 32 for invulnerability
  + 64 for one hit kills
  + 128 for faster turns (no skidding if character running full speed)
  + 256 to enable in-game cheat keys

The in-game cheat keys, when enabled, are as follows:

            W - Wings               F1 - toggle infinite lives
            D - Drunken             F2 - toggle infinite energy
            S - Springs (jumps)	    F3 - toggle infinite credits
            H - Heavy               F4 - toggle infinite oxygen
            A - Armour              F5 - toggle infinite time
            B - Speed-up            F6 - toggle invulnerability
            T - Add troll baby      F7 - toggle one hit kills
            F - Freeze monsters     F8 - toggle faster turns
            E - Refill energy       F9 - trigger ending sequence
            O - Refill oxygen
            Y - Yo-yo
            N - BONUS letters
            G - BOGUS letters

HISTORY

Version 2.1 (2024-10-08) by DJ Mike
- Another ECS version supported, with long track protection removed
- Bug when setting certain trainers on startup fixed (Mantis issue #6601)
- Manual included

Version 2.0 (2024-10-07) by DJ Mike
- Patch rewritten, updated to use modern WHDLoad features
- All versions of the game now share all features
- Uses RawDIC imager for disk versions to extract real files
- Self modifying code removed that garbled introduction
- Manual protection fully removed on AGA/ECS
- Pack-Ice files can now be unpacked for faster loading
- Slave now works on 68000 machines (Mantis issue #4608)
- Quit key supported for 68000
- Another ECS version supported (Mantis issue #2167)
- Glitching sounds/beeping noises fixed (Mantis issue #4580)
- [AGA/ECS] Access faults/disappearing levels fixed (Mantis issue #513)
- [CD32] Crash on Sodapop levels fixed (Mantis issue #1585)
- [CD32] Removed OSEmu, small number of OS calls patched out instead
- Fast memory used where possible
- Missing color bit settings in bplcon0 fixed
- 2nd button jump support added
- Skip intro option added
- Speed up character switching directions option added
- More trainers added
- Fire to skip intro on all versions
- New icons made by Pascal and myself
- Source code now included

Version 1.0-1.3 (1999-11-15) by Dark Angel & Dr. Zarkov
- Original releases

WORDS FROM THE AUTHOR

Just shy of 25 years since this patch was last updated, I have given it an
overhaul to address some of the issues that have been reported in that time.
I've also aligned all the versions of the game so they now share the same
fixes and enhancements. The CD32 release was completely lacking in features
before, which was a shame as it is the best version!

There was sneaky self-modifying code in the intro that caused the graphics
to corrupt, that particularly seemed to affect 68030 machines. Sound effects
were also glitching due to CPU-dependent delays in the audio routines.

The most astonishing bug - on the disk versions - caused the entire level
to completely disappear when you got to the top, or an access fault if you
had an MMU active. The cause was an unsigned multiplication of a negative
number, resulting in a very big - and invalid - memory address. Given how
obvious this bug is, it's incredible that the game shipped like this!

I have retained Dark Angel's previous set of trainers (and supported them in
the CD32 release, naturally). As if those weren't enough I've added even
more, and a bunch of in-game toggles. This includes a feature to make your
character change direction quickly no matter what speed you are running, as
the sloooooow skidding to stop really annoyed me!

This patch was a slog to update because every version of this game uses
different offsets - meaning for every feature I had to carefully go through
the same code multiple times, which often had slight variations due to
address widths and compiler optimisations. 

But hopefully it was worth it for somebody out there. :-)

Greetings and a big thanks to Irek and Pascal for testing, and also to the
EAB forums and the WHDLoad team.

--- DJ Mike (7th October 2024)

         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.