86
edits
Difference between revisions of "AGI/Debug Modes"
simple wiki-fication
(Initial FAQ Import) |
(simple wiki-fication) |
||
| Line 3: | Line 3: | ||
Thanks to Omer Mor, Lars Skovlund & Kelmer for their valuable information. | Thanks to Omer Mor, Lars Skovlund & Kelmer for their valuable information. | ||
=== Intro === | |||
This FAQ will explain the several debug modes found in Sierra On-Line adventure games. | |||
Before you read, keep in mind the following things: | |||
* References to "ego" mean "the main character" or the object you control. | |||
* Any brackets, asterisks or quotation marks should NOT be typed in. They're only used to clarify. | |||
* Anything between brackets means it's either a key or a combination of keys. So [CTRL + D] means you push the CONTROL-key and the D-key '''at the same time'''. | |||
* Between quotation marks means it should be typed in. | |||
* Words between asterisks should be replaced with a proper word/object/thing. So "PITCH *object name*" means you should type the object you want to get, e.g. "PITCH WIG". | |||
And while you might know, Sierra games use an "interpreter". This basically is a | |||
program/system which translates the program statements (in byte-code) into | |||
executable machine code one line at a time as the program is running; as opposed | |||
to a compiler, which translates the entire program before the program is executed. | |||
The different interpreters used by Sierra for their games are described in the next chapter. | |||
This FAQ only covers the debug modes of IBM PC versions, however, some of them might work on the other systems too. | |||
==== AGI ==== | |||
AGI (Adventure Game Interpreter) | |||
* Video: 160x200 resolution, 16 colors (2 or 4 colors on some platforms) | |||
* Audio: Up to 4 channels of audio (if platform supports it) | |||
* Platform: IBM PC (including PCjr & TANDY), Commodore AMIGA, Atari ST, Apple ][(GS), Apple Macintosh & Coco 3 (TRS-80 Color) | |||
* Period: 1984-1989 | |||
Games using the AGI interpreter: | |||
* Donald Duck's Playground | |||
* Gold Rush! | |||
* King's Quest 1: Quest for the Crown | |||
* King's Quest 2: Romancing the Throne | |||
* King's Quest 3: To Heir is Human | |||
* King's Quest 4: The Perils of Rosella | |||
* Leisure Suit Larry in the Land of the Lounge Lizards | |||
* Manhunter 1: New York | |||
* Manhunter 2: San Francisco | |||
* Mixed-Up Mother Goose | |||
* Police Quest 1: In Pursuit of the Death Angel | |||
* Space Quest 1: The Sarien Encounter | |||
* Space Quest 2: Vohaul's revenge | |||
* The Black Cauldron | |||
=== Debug mode in AGI games === | |||
This debug mode is solely script related, which means that a debug script is | |||
located directly in the game code itself, not in the interpreter's (although | |||
the interpreter of course offers the commands to use in the script). So if a | |||
game does not have the debug script in it's code, 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 | |||
a debug mode in it, but it's likely removed from the final release. The demo | |||
packs and other demonstrations also don't include a debug mode. | |||
There are four major versions of AGI. AGIv0, AGIv1, AGIv2 and surprisingly, | |||
AGIv3. | |||
AGIv0/AGIv1 are old and uncommon interpreters with no known debug mode. The | |||
only games using them are the self-booting first versions of King's Quest 1 & | |||
2 and The Black Cauldron, which are rare and hardly used nowadays. Donald | |||
Duck's Playground uses a hybrid between AGIv1 and AGIv2, it does include a | |||
debug mode. | |||
AGIv2 and AGIv3 are pretty alike and so are their debug functions. Debug-wise | |||
the only major difference is that AGIv3 does not contain the trace-function. | |||
AGIv3 games are Gold Rush!, King's Quest 4 (AGI version), the ManHunter | |||
series and a certain version of The Black Cauldron. The rest of the games use AGIv2. | |||
==== Script 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 typed in, perhaps to access the debug mode on other | |||
platforms. They are the following: | |||
Gold Rush! - BIRD BOY | Gold Rush! - BIRD BOY | ||
| Line 112: | Line 86: | ||
Space Quest 2 - DBG | Space Quest 2 - DBG | ||
After the debug mode is activated, the following options are available, by | |||
typing: | |||
TP - Teleport (change room/scene/script) | TP - Teleport (change room/scene/script) | ||
| Line 124: | Line 98: | ||
GET OBJECT - Get a given object added to inventory | GET OBJECT - Get a given object added to inventory | ||
Or by pushing: | |||
[SCROLL LOCK] - Trace mode (only works with AGI v2) | [SCROLL LOCK] - Trace mode (only works with AGI v2) | ||
These commands will work in all the AGI games with a debug mode. However some | |||
games have additional commands for use with the debug mode. The next chapters | |||
will cover them. | |||
===== Game Specific: Al Lowe games ===== | |||
Games programmed by Al Lowe: Leisure Suit Larry, The Black Cauldron, Police | |||
Quest, King's Quest 3 and King's Quest 4. Donald Duck's Playground is also | |||
programmed by Al, but does not support these debug commands. When certain | |||
commands will only apply to a specific game, that game's abbreviation is | |||
given between brackets. | |||
Commands: | |||
GIMME GIMME - All objects get added to inventory | GIMME GIMME - All objects get added to inventory | ||
| Line 160: | Line 132: | ||
[ALT + D] - Exits debug mode (BC) | [ALT + D] - Exits debug mode (BC) | ||
* King's Quest 3 has several versions and with some this command won't work, | * King's Quest 3 has several versions and with some this command won't work, or will use different keys like F6 or F10 (e.g. v1.01) | ||
===== Game Specific: Priority commands ===== | |||
Games that use priority commands: Space Quest 1, Police Quest 1, Gold Rush!, | |||
Leisure Suit Larry, The Black Cauldron, Donald Duck's Playground & King's | |||
Quest 4. | |||
Commands: | |||
SHOW PRIORITY - Shows priority screen | SHOW PRIORITY - Shows priority screen | ||
| Line 179: | Line 148: | ||
* Does not work with King's Quest 3 and Donald Duck's Playground | * Does not work with King's Quest 3 and Donald Duck's Playground | ||
===== Game Specific: Space Quest series ===== | |||
General commands: | |||
OBJECT - Gives information on objects on screen | OBJECT - Gives information on objects on screen | ||
| Line 189: | Line 156: | ||
SHOW PRIORITY - Shows priority screen | SHOW PRIORITY - Shows priority screen | ||
Space Quest 1 includes a bunch of extra commands: | |||
CASH - Change amount of money | CASH - Change amount of money | ||
| Line 197: | Line 164: | ||
NO HELMET - Changes ego to alien (without helmet) | NO HELMET - Changes ego to alien (without helmet) | ||
===== Game Specific: King's Quest series & Gold Rush! ===== | |||
General commands: | |||
OBJECT - Gives information on objects on screen (except KQ3) | OBJECT - Gives information on objects on screen (except KQ3) | ||
| Line 218: | Line 183: | ||
[ALT + S] - Gives information on objects on screen (GR) | [ALT + S] - Gives information on objects on screen (GR) | ||
King's Quest 3 has a more extensive debug mode: | |||
SLEEP WIZARD - Wizard goes to sleep | SLEEP WIZARD - Wizard goes to sleep | ||
| Line 230: | Line 195: | ||
WIZARD STATUS - Gives a detailed status of the wizard | WIZARD STATUS - Gives a detailed status of the wizard | ||
King's Quest 4: | |||
CREATE DAY - Turns the game into day | CREATE DAY - Turns the game into day | ||