Debug Modes

Partially based on the On-Line Debug Mode FAQ by HWM

 

Introduction

This debug mode is solely script related. A debug script is located directly in the game logic itself, not in the interpreter (although the interpreter of course offers the commands to use in the script). If a game does not have the debug script in its logic, it will not work. However, pretty much all the games have a debug mode, except for Mixed-Up Mother Goose and the Manhunter series. The latter does have some unused messages relating to a debug mode in it, but it's likely removed from the final release. The AGI demo packs and other demonstrations also don't include a debug mode.

AGI1 is an old and uncommon interpreter. The only games using it are the self-booting first versions of King's Quest 2 and The Black Cauldron, which are rare and hardly used nowadays. However, the AGI1 games do have a debug mode, so they're included here. Donald Duck's Playground is also a booter game, but in many aspects more like AGI2, including the version number given by Sierra (v2.001), so it's listed under AGI2. The first release of the first part of King's Quest is sometimes listed as AGI0, but technically this more a container category for the first versions of the first release of King's Quest, not really one interpreter.

AGI2 and AGI3 are pretty alike and so are their debug functions. Debug-wise the only major difference is that AGI3 does not contain the trace-function. AGI3 games are Gold Rush!, King's Quest 4 AGI, the Manhunter series and a certain version (v2.10) of The Black Cauldron. Some demos also use AGI3. The rest of the games use AGI2.

Most AGI games still have the debug code that developers used while the games were being developed. Most of the games activate their debug modes by pushing the ALT-D key combination. The other games use a "magic phrase" to enter the debug mode. Once activated, here are commands that can be used.

AGI1 Debugger

In King's Quest 2, the debug mode is activated by entering "FAST SPEAK" at the command line. It will be activated on room change.

In The Black Cauldron, the debug mode is activated by pressing [ALT + D]. This would eventually become the standard way of activation. The debug mode will be deactivated on room change. Also, activating the debug mode multiple times will generate multiple input/output lines!

After the debug mode is activated, the following commands are available:

Command	Result	TP	Teleport (change room/scene/script)
SP	Shows position of ego *
SHOW POSITION	Shows position of ego *
SHOW PRIORITY	Shows priority of ego
SHOW FLAG	Shows a given flag (or rather variable)
SET FLAG	Sets a given flag (or rather variable)
GET OBJECT	Get specified object and added to inventory
QUIT	Quit game (originally, but now locks up)

* Does not work with King's Quest 2

 

AGI2/AGI3 Debugger

Usually, the debug mode is activated by pressing [ALT + D]. However, there are some alternative ways/exceptions with some games. These games require a certain sentence to be typed in; perhaps this was done to access the debug mode on other platforms, without redefining keys in the code. The games and their sentences are:

Gold Rush!	BIRD BOY
King's Quest 2	FAST SPEAK
King's Quest 3	RATS ASS (only in v2.14)
Police Quest 1	STINK BUGS (only in v2.0G)
Space Quest 2	DBG

After the debug mode is activated, the following commands are available:

TP	Teleport (change room/scene/script)
POSITION	Shows position of ego
SHOW VARIABLE	Shows value of a given variable
SET VARIABLE	Sets value of a given variable
SHOW FLAG	Shows a given flag (if set or not set)
SET FLAG	Sets a given flag
RESET FLAG	Resets a given flag
GET OBJECT	Get a given object added to inventory
[SCROLL LOCK]	Trace mode*

* Only works with AGI v2

Standard AGI Debug Mode Commands

Command	Result
TP	Teleport to room.
SHOW PRIORITY	Displays the current rooms priority bands and control lines.
GET OBJECT	Get any inventory item.
GIMME GIMME	Get all inventory items.
SHOW FLAG	Displays one of the 256 flags.
SET FLAG	Set one of the 256 flags.
RESET FLAG	Clear one of the 256 flags.
SHOW VAR	Displays one of the 256 variables.
SET VAR	Change the value of one of the 256 variables.
POSITION	Change egos position.
SHOW POSITION	Show egos current screen coordinates.
OBJECT NUMBER	Displays list of all the objects and their object numbers.
OBJECT ROOM	Displays which room an object is found in.
ROOM	Displays room number.
SET PRIORITY	et the priority of ego.
RELEASE PRIORITY	Release the last priority that ego was set to.

 

AGI Game Specific Debug Modes

Of all the AGI games, it is unknown whether the KQ4 256K version, MH1, MH2 and Mixed Up Mother Goose have a debug mode or not. KQ4 will almost certainly have one, while MUMG probably doesn't even though its words.tok file has all the debug words contained in it. Manhunter 2 has some kind of debug mode which allows you to teleport and change variable values because there are text messages in the first LOGIC file along these lines. Manhunter: New York probably has the same debug mode.

To access the debug mode in King's Quest I-III (in the newer versions of the game most of the debugging options won't work) while playing press Alt+D. Two information boxes will appear. Press Enter to get rid of them. Enter the right command to enter debug mode.

Game	Command
Gold Rush	type "bird man".
Kings Quest I	Alt+D and Enter twice
Kings Quest II	Alt+D and Enter twice
Kings Quest III	type "rats ass" or Alt+D
Kings Quest IV AGI	Alt+D and Enter twice
Leisure Suit Larry 1	Alt+D and Enter twice
Police Quest 1	type "stink bug".
Space Quest 1	type "backstage" or "dbg".
Space Quest 2	Alt+D and Enter twice

 

AGI Game Specific Debug Commands

 

King's Quest III

Here are a few interesting tricks to help you deal with that intolerable wizard in debug mode (). Type:

Command	Result
enchanter status	Were wizard is, when he'll return, etc.
do chore	To have your task done for you.
sleep enchanter	To put him to sleep.
bye bye enchanter	To kill him.

 

King's Quest 4 AGI

While playing, press Alt+D. Two information boxes will appear. Press enter to get rid of them (in the newer versions of the games though, most of the debugging options won't work).

Command	Result
TP	Teleport to room.*

* For a list of room numbers for KQ4, see the King's Quest IV Room Maps.

 

Leisure Suit Larry 1

Press ALT+D and press enter twice to enable Debug Mode.

Command	Result
TP (room #*)	Teleport to specified room.
OBJECT NUMBER	Show a list of items and numbers
GET OBJECT (item #)	To get specified object
GIMME GIMME	Obtain all objects
OBJECT ROOM (object #)	Shows room where an item is
ROOM NUMBER	X/Y Coordinates and current room number
SHOW VAR or SV	Display value of variable
SET VAR or CHANGE VAR	Change value of variable
SET FLAG or SF	Set a flag
VIEW FLAG or SHOW FLAG	See flags
RESET FLAG	Reset a flag
ALT+M	Display heap size
ALT+I or SP (object #)	Shows information about screen objects
ALT+V or PRIORITY	Displays priority screen

• For a list of room numbers, see here.

 

Space Quest I-II

Command	Result
tester	Displays Rogers screen coordinates.