Cody's WHDLoad FAQ

CodyJarrett · 29 June 2002, 15:11

Here's a first draft of a WHDLoad FAQ that I've written for the EAB. Any suggestions or additions?

What is WHDLoad?

WHDLoad is a tool which allows you to run Amiga games from your hard disk.

What is the URL of the WHDLoad homepage?

www.whdload.de

What are the main advantages of WHDLoad?

1. Games load quickly from hard disk.
2. All games have a quit option to return to Workbench.
3. The games are fixed to work on modern machines.
4. No more bothering with ADFs or floppies or disk swapping.
5. You are running the original game, not a pirate version.
6. The games are patched to pass any copy protection.
7. Hiscores or save games can be sent to the hard disk.
8. Bugs or annoying features are fixed.
9. Over 1000 games are currently supported with installs.
10. Game compatibility with emulators is often improved

What are the components of a WHDLoad install?

WHDLoad - the tool itself. This is a command, which usually resides in the C directory.
Slave - compiled 68000 assembler code. This has been written specifically for a certain game and can call functions provided by WHDLoad.
Disk image/files - actual game files. Either one or more disk images (default filenames are disk.1, disk.2 etc.) or game files copied from the disks (in a 'data' dir).
Icon - although not necessary, an icon is an easy way to call WHDLoad with a tooltype which will specify the slave.
Installer - standard Workbench installer. Automates the process of setting the game up on the hard disk, ready to run.
Readme - explains features of the install etc.

What is the difference between disk images and data files?

If the original game is non-DOS, then a complete dump of the disk will be used in the form of a disk image. If the game is DOS, then the files will be placed in a subdirectory, usually called 'data'. However, for some non-DOS disks, the patcher of the game will extract the files to hard disk, knowing that they are stored in a custom format on the original disk.

Who is involved with WHDLoad?

Bert Jahn is the author of WHDLoad itself and also writes some installers. Dedicated patchers such as Bored Seal only write installers.

What is the process of installing and running a game with WHDLoad?

Make sure that the standard 'installer' tool is available - download it at http://www.aminet.net/aminet/dirs/am...aller-43_3.lha

Download the actual WHDLoad archive from the homepage. Extract the LZX/LHA archive and run the installer, which will place all the WHDLoad files in relevant directories.

Download the specific patch for your game from the homepage and extract the LHA archive. Run the patch installer.

Follow the on-screen instructions, specify where the game is to be installed and insert the original disks when prompted.

Navigate to the directory when you installed the game and double-click the icon to run the game.

Why are the game files not available on the WHDLoad website?

Putting copyrighted games on the website would endanger WHDLoad itself. It is primarily designed for use by owners of original games.

Can I use cracked games with WHDLoad?

Many crack images will work, although it is not guaranteed. Patchers like Codetapper design their installs to work with cracks sometimes.

How much is WHDLoad?

As of version 18.2, WHDLoad is now free. A donation may be made to support the project: http://www.whdload.de/reg.html

Previously, there was a one-time payment of 20 Euros, £15 or $20 to register WHDLoad. This went to Bert Jahn to help run the website and continue development of WHDLoad. The patchers write slaves for free (and usually as a hobby or interest).

Why should I pay for WHDLoad? Other emulation projects are free.

WHDLoad is a shareware program, designed to run on real Amigas. It isn't about emulators.

Where can I get game files to use with WHDLoad?

Try Codetapper's Action Web Headquarters ( http://action.reversers.net/ ) or ask at the English Amiga Board ( abime.net ).

Why don't the WHDLoad patchers fix the games which don't work with emulators?

WHDLoad is designed to work on real Amigas and the patchers don't have time to work around emulator bugs, which may be fixed in a future emulator version. Often the compatibility of game with an emulator is improved, due to the fixing of non-standard features of the game or the removal of a badly-coded disk routine.

What is JST?

JST is a similar system to WHDLoad, but has now been discontinued (see the old homepage at http://jffabre.free.fr/amiga/patches.html ). The author, Jean-François Fabre now writes WHDLoad patches.

I got an error 'DOS-Error #205 (object not found) on reading "devs:kickstarts/kick34005.a500"' when running a game under WHDLoad.

The specific game uses KickEmu and requires an A500 kickstart image and an associated .rtb file. The kickstart image must be located in the directory "Devs:Kickstarts" and must be named "kick34005.A500". The image can be extracted from an A500 with tools like "GrabKick" or similar which can be found on Aminet. If the image is the wrong version or altered in any way, WHDLoad will quit with an appropriate error message.

Additionally the file "kick34005.A500.RTB" must be installed in the same directory as the kickstart image. It can be found in the archive "util/boot/skick343.lha" on Aminet.

What is KickEmu?

Some games use a lot of operating system calls to the Amiga ROM, which can't be accessed directly within WHDLoad. A patcher can emulate the calls in the slave, or else use KickEmu and WHDLoad functions which allow access to a ROM image in FAST RAM (and therefore requires 512K more RAM to run the slave).

The game disk images are big. Can they be compressed?

Yes, install the user version of the tool XPK and compress the images (for example, using the MASH compression algorithm).

What is CAPS / SPS?

CAPS is the Classic Amiga Preservation Society - http://www.caps-project.org/ (Now known as SPS - The Software Preservation Society - http://www.softpres.org/) and aims to rescue Amiga games in a different way than WHDLoad. CAPS dumps original disks for preservation as they are, including protection, while WHDLoad removes protection and aims to run the games off a hard disk.

How to make WHDload install with .IPF?

N.B you will need RawDIC 4.0 for this so, first make sure you have the latest version of Whdload installed and then download:

TrackWarp from: http://www.whdload.de/whdload/TrackWarp14.lha
ipflib_amigaos-m68k.lha from: http://www.softpres.org/?id=download

Copy capsimage.device to Devs:

Copy trackwarp.library to Libs:

Proceed as if you were going to install from disk.

When RawDIC appears and asks for disk 1, click the Select file button in the middle.

Select the first .IPF file.

Click Start.

Repeat the above operation if/when asked for the next disk. Done

Paul · 29 June 2002, 15:21

Very good

Only suggestion I can think of is, have a link to installer?

CodyJarrett · 29 June 2002, 15:55

The links to the WHDLoad archive might change, so I'll just leave a link to the webpage.

Paul · 29 June 2002, 16:29

I am on about the latest C:Installer file, which is needed for the install scripts to work found on BTTR and aminet.

CodyJarrett · 29 June 2002, 17:36

Doh! Done!

Konrad · 29 June 2002, 17:44

Very good FAQ for those how don't know how to get WHDLoad to run. Seems to be complete.

Twistin'Ghost · 29 June 2002, 22:44

Quote:

Originally posted by CodyJarrett
Here's a first draft of a WHDLoad FAQ that I've written for the EAB. Any suggestions or additions?

Who is involved with WHDLoad?

Bert Jahn is the author of WHDLoad itself and also writes some installers. Dedicated patchers such as Codetapper only write installers.

Why are the game files not available on the WHDLoad website?

Putting copyrighted games on the website would endanger WHDLoad itself. It is primarily designed for use by owners of original, boxed games.

Two things I'd consider:
1. Maybe the other patchers might feel chuffed if they see Codetapper singled out as an example patcher, so maybe there should be no 'example' patcher, just for balance?

2. I'd probably remove the 'boxed' part of that last paragraph.

Beyond that, an excellent (and much needed) guide that I can see we will be directing people towards quite a lot. Good job, Cody!

Amiga1992 · 30 June 2002, 04:50

Sounds fine. Though I'd add a troubleshooting thingie in there too.

CodyJarrett · 30 June 2002, 09:09

Okay, I've made some more changes. I've changed Codetapper to Bored Seal as an example patcher.

Twistin'Ghost · 30 June 2002, 09:29

What if Codetapper feels chuffed that... [SNIP!] OK, you got him in there with the Action link.

One more thing: link to the CAPS page maybe? I realize it's not really WHD-related, but it's more complete that way.

CodyJarrett · 30 June 2002, 09:51

Don't worry, Codetapper himself suggested the change to Bored Seal!

Link to CAPS done.

7-Zark-7 · 30 June 2002, 14:53

Although I realise that WHDLoad is geared towards Amiga users (rather than emulator WINUAE users), maybe a small add-on to the FAQ for newbies wanting to know how to install/run this utility via WinUAE would be helpful.
(ie:unpacking from the PC & putting it onto a WinUAE harddisk).

wizard66 · 17 October 2004, 14:39

So I have to use whdload AND kickemu !! to load games for a500 kickstart ?

i have a A1200 kick3.1 OS 3.9

adolescent · 18 October 2004, 00:55

Quote:

Originally Posted by wizard66

So I have to use whdload AND kickemu !! to load games for a500 kickstart ?

i have a A1200 kick3.1 OS 3.9

Yes and no. You simply have to run the game and have an appropriate kickstart file available. WHDLoad does all of the system setup for you.

synchro · 18 October 2004, 01:30

Very nice Cody !!!!

Wouldnt like to whip me up a html page for the DVD would ya ?
Perhaps something with a link to the "Hall Of Light" and maybe a few others would be cool.

keropi · 28 June 2005, 09:45

I think you should add the chipnocache option infos, for ppc users...

EmuChicken · 29 June 2005, 11:56

how about this one-

q. "I'm rubbish at pc/ amiga technical stuff- how do I install whdload WITH EASE"
a. "use one of the custom workbench installs, such as Classicwb, and it all comes preinstalled" :-)

Anubis · 26 March 2007, 13:35

Shouldn't this be removed now that we have WIKI??

rlcarr · 23 April 2008, 04:29

Quote:

Originally Posted by CodyJarrett

Make sure that the standard 'installer' tool is available - download it at http://uk.aminet.net/aminet/dirs/ami...aller-43_3.lha

That link doesn't work. But if you change the "uk" to "www", then it does work.

CodyJarrett · 23 April 2008, 09:43

Thanks, fixed!

29 June 2002, 15:11	#1
CodyJarrett Global Moderator Join Date: Mar 2001 Location: UK Age: 46 Posts: 6,160	Cody's WHDLoad FAQ Here's a first draft of a WHDLoad FAQ that I've written for the EAB. Any suggestions or additions? What is WHDLoad? WHDLoad is a tool which allows you to run Amiga games from your hard disk. What is the URL of the WHDLoad homepage? www.whdload.de What are the main advantages of WHDLoad? 1. Games load quickly from hard disk. 2. All games have a quit option to return to Workbench. 3. The games are fixed to work on modern machines. 4. No more bothering with ADFs or floppies or disk swapping. 5. You are running the original game, not a pirate version. 6. The games are patched to pass any copy protection. 7. Hiscores or save games can be sent to the hard disk. 8. Bugs or annoying features are fixed. 9. Over 1000 games are currently supported with installs. 10. Game compatibility with emulators is often improved What are the components of a WHDLoad install? WHDLoad - the tool itself. This is a command, which usually resides in the C directory. Slave - compiled 68000 assembler code. This has been written specifically for a certain game and can call functions provided by WHDLoad. Disk image/files - actual game files. Either one or more disk images (default filenames are disk.1, disk.2 etc.) or game files copied from the disks (in a 'data' dir). Icon - although not necessary, an icon is an easy way to call WHDLoad with a tooltype which will specify the slave. Installer - standard Workbench installer. Automates the process of setting the game up on the hard disk, ready to run. Readme - explains features of the install etc. What is the difference between disk images and data files? If the original game is non-DOS, then a complete dump of the disk will be used in the form of a disk image. If the game is DOS, then the files will be placed in a subdirectory, usually called 'data'. However, for some non-DOS disks, the patcher of the game will extract the files to hard disk, knowing that they are stored in a custom format on the original disk. Who is involved with WHDLoad? Bert Jahn is the author of WHDLoad itself and also writes some installers. Dedicated patchers such as Bored Seal only write installers. What is the process of installing and running a game with WHDLoad? Make sure that the standard 'installer' tool is available - download it at http://www.aminet.net/aminet/dirs/am...aller-43_3.lha Download the actual WHDLoad archive from the homepage. Extract the LZX/LHA archive and run the installer, which will place all the WHDLoad files in relevant directories. Download the specific patch for your game from the homepage and extract the LHA archive. Run the patch installer. Follow the on-screen instructions, specify where the game is to be installed and insert the original disks when prompted. Navigate to the directory when you installed the game and double-click the icon to run the game. Why are the game files not available on the WHDLoad website? Putting copyrighted games on the website would endanger WHDLoad itself. It is primarily designed for use by owners of original games. Can I use cracked games with WHDLoad? Many crack images will work, although it is not guaranteed. Patchers like Codetapper design their installs to work with cracks sometimes. How much is WHDLoad? As of version 18.2, WHDLoad is now free. A donation may be made to support the project: http://www.whdload.de/reg.html Previously, there was a one-time payment of 20 Euros, £15 or $20 to register WHDLoad. This went to Bert Jahn to help run the website and continue development of WHDLoad. The patchers write slaves for free (and usually as a hobby or interest). Why should I pay for WHDLoad? Other emulation projects are free. WHDLoad is a shareware program, designed to run on real Amigas. It isn't about emulators. Where can I get game files to use with WHDLoad? Try Codetapper's Action Web Headquarters ( http://action.reversers.net/ ) or ask at the English Amiga Board ( abime.net ). Why don't the WHDLoad patchers fix the games which don't work with emulators? WHDLoad is designed to work on real Amigas and the patchers don't have time to work around emulator bugs, which may be fixed in a future emulator version. Often the compatibility of game with an emulator is improved, due to the fixing of non-standard features of the game or the removal of a badly-coded disk routine. What is JST? JST is a similar system to WHDLoad, but has now been discontinued (see the old homepage at http://jffabre.free.fr/amiga/patches.html ). The author, Jean-François Fabre now writes WHDLoad patches. I got an error 'DOS-Error #205 (object not found) on reading "devs:kickstarts/kick34005.a500"' when running a game under WHDLoad. The specific game uses KickEmu and requires an A500 kickstart image and an associated .rtb file. The kickstart image must be located in the directory "Devs:Kickstarts" and must be named "kick34005.A500". The image can be extracted from an A500 with tools like "GrabKick" or similar which can be found on Aminet. If the image is the wrong version or altered in any way, WHDLoad will quit with an appropriate error message. Additionally the file "kick34005.A500.RTB" must be installed in the same directory as the kickstart image. It can be found in the archive "util/boot/skick343.lha" on Aminet. What is KickEmu? Some games use a lot of operating system calls to the Amiga ROM, which can't be accessed directly within WHDLoad. A patcher can emulate the calls in the slave, or else use KickEmu and WHDLoad functions which allow access to a ROM image in FAST RAM (and therefore requires 512K more RAM to run the slave). The game disk images are big. Can they be compressed? Yes, install the user version of the tool XPK and compress the images (for example, using the MASH compression algorithm). What is CAPS / SPS? CAPS is the Classic Amiga Preservation Society - http://www.caps-project.org/ (Now known as SPS - The Software Preservation Society - http://www.softpres.org/) and aims to rescue Amiga games in a different way than WHDLoad. CAPS dumps original disks for preservation as they are, including protection, while WHDLoad removes protection and aims to run the games off a hard disk. How to make WHDload install with .IPF? N.B you will need RawDIC 4.0 for this so, first make sure you have the latest version of Whdload installed and then download: TrackWarp from: http://www.whdload.de/whdload/TrackWarp14.lha ipflib_amigaos-m68k.lha from: http://www.softpres.org/?id=download Copy capsimage.device to Devs: Copy trackwarp.library to Libs: Proceed as if you were going to install from disk. When RawDIC appears and asks for disk 1, click the Select file button in the middle. Select the first .IPF file. Click Start. Repeat the above operation if/when asked for the next disk. Done Last edited by CodyJarrett; 03 January 2019 at 14:26. Reason: fixed Codetapper's site link

Similar Threads
Thread	Thread Starter	Forum	Replies	Last Post
KGWHD - KillerGorilla's WHDLoad site FAQ	killergorilla	project.Killergorilla's WHD packs	33	15 January 2023 14:41
What the FAQ do you want? :D	Amiga1992	project.EAB	14	31 May 2004 13:18
What List Should Cody Do Next?	CodyJarrett	Nostalgia & memories	30	09 December 2002 01:37
Cody's WHDLoad News	CodyJarrett	Amiga scene	6	20 April 2002 08:37
Cody's Honour List AKA Cody's Game Name Request Game	CodyJarrett	request.Old Rare Games	16	17 September 2001 00:17

29 June 2002, 15:21	#2
Paul RIP Friends Join Date: Sep 2005 Location: UK Posts: 2,157	Very good Only suggestion I can think of is, have a link to installer?

29 June 2002, 15:55	#3
CodyJarrett Global Moderator Join Date: Mar 2001 Location: UK Age: 46 Posts: 6,160	The links to the WHDLoad archive might change, so I'll just leave a link to the webpage.

29 June 2002, 16:29	#4
Paul RIP Friends Join Date: Sep 2005 Location: UK Posts: 2,157	I am on about the latest C:Installer file, which is needed for the install scripts to work found on BTTR and aminet.

29 June 2002, 17:36	#5
CodyJarrett Global Moderator Join Date: Mar 2001 Location: UK Age: 46 Posts: 6,160	Doh! Done!

29 June 2002, 17:44	#6
Konrad Registered User Join Date: Apr 2002 Location: Germany Age: 43 Posts: 742	Very good FAQ for those how don't know how to get WHDLoad to run. Seems to be complete.

30 June 2002, 04:50	#8
Amiga1992 Registered User Join Date: May 2001 Location: ? Posts: 19,644	Sounds fine. Though I'd add a troubleshooting thingie in there too.

30 June 2002, 09:09	#9
CodyJarrett Global Moderator Join Date: Mar 2001 Location: UK Age: 46 Posts: 6,160	Okay, I've made some more changes. I've changed Codetapper to Bored Seal as an example patcher.

30 June 2002, 09:29	#10
Twistin'Ghost Give up the ghost Join Date: Apr 2001 Location: U$A Age: 33 Posts: 4,662	What if Codetapper feels chuffed that... [SNIP!] OK, you got him in there with the Action link. One more thing: link to the CAPS page maybe? I realize it's not really WHD-related, but it's more complete that way.

30 June 2002, 09:51	#11
CodyJarrett Global Moderator Join Date: Mar 2001 Location: UK Age: 46 Posts: 6,160	Don't worry, Codetapper himself suggested the change to Bored Seal! Link to CAPS done.

30 June 2002, 14:53	#12
7-Zark-7 Zone Friend Join Date: Aug 2001 Location: Brisbane/Australia Posts: 1,270	Although I realise that WHDLoad is geared towards Amiga users (rather than emulator WINUAE users), maybe a small add-on to the FAQ for newbies wanting to know how to install/run this utility via WinUAE would be helpful. (ie:unpacking from the PC & putting it onto a WinUAE harddisk).

17 October 2004, 14:39	#13
wizard66 FPGA Replay inside A590 Join Date: Sep 2004 Location: Rotterdam/Netherlands Age: 57 Posts: 294	So I have to use whdload AND kickemu !! to load games for a500 kickstart ? i have a A1200 kick3.1 OS 3.9

18 October 2004, 01:30	#15
synchro Sending You Back In Time Join Date: Mar 2004 Location: UK Age: 61 Posts: 986	Very nice Cody !!!! Wouldnt like to whip me up a html page for the DVD would ya ? Perhaps something with a link to the "Hall Of Light" and maybe a few others would be cool.

28 June 2005, 09:45	#16
keropi . Join Date: Oct 2004 Location: Ioannina/Greece Posts: 5,040	I think you should add the chipnocache option infos, for ppc users...

29 June 2005, 11:56	#17
EmuChicken Senior Member Join Date: Jul 2004 Location: Nagoya, Japan (moved!) Age: 41 Posts: 746	how about this one- q. "I'm rubbish at pc/ amiga technical stuff- how do I install whdload WITH EASE" a. "use one of the custom workbench installs, such as Classicwb, and it all comes preinstalled" :-)

26 March 2007, 13:35	#18
Anubis Retro Gamer Join Date: Jan 2005 Location: Underworld Age: 51 Posts: 4,058	Shouldn't this be removed now that we have WIKI??

23 April 2008, 09:43	#20
CodyJarrett Global Moderator Join Date: Mar 2001 Location: UK Age: 46 Posts: 6,160	Thanks, fixed!

Currently Active Users Viewing This Thread: 1 (0 members and 1 guests)