86
edits
Difference between revisions of "AGI/Debug Modes"
Jump to navigation
Jump to search
m
no edit summary
(simple wiki-fication) |
m |
||
| (5 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
Sierra On-Line Debug Mode FAQ | |||
Version 0.94 [15-Apr-08] by HWM | |||
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. | This FAQ will explain the several debug modes found in Sierra On-Line adventure games. | ||
| Line 14: | Line 14: | ||
* Between quotation marks means it should be typed in. | * 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". | * 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". | ||
* Commands to be used in the debug modes are listed in upper case and are followed by dash and a description of their effect. The input of commands is case insensitive. | |||
And while you might know, Sierra games use an "interpreter". This basically is a | 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 | program/system which translates the program statements (in byte-code) into | ||
| Line 56: | Line 58: | ||
pretty much all the games have a debug mode, except for Mixed-Up Mother Goose | 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 | 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 | to 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. | packs and other demonstrations also don't include a debug mode. | ||
There are | There are three major versions of AGI. AGIv1, AGIv2, and surprisingly, AGIv3. | ||
AGIv3. | |||
AGIv1 is an old and uncommon interpreter. The only games using it are the self-booting first versions of King's Quest, King's Quest 2 and The Black Cauldron, which are rare and hardly used nowadays. However, the AGIv1 games do have a debug mode, so they're included here. Donald Duck's Playground is also self-booting, but in many aspects more like AGIv2, including the version number given by Sierra (v2.001), so it's listed under AGIv2. The first release of the first part of King's Quest is sometimes listed as AGIv0, but technically this is more a container category for the first versions of the first release of King's Quest, not really one interpreter. | |||
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 (v2.10) of The Black Cauldron. Some demos also use AGIv3. The rest of the games use AGIv2. | |||
==== Script Debugger: AGIv1 ==== | |||
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! | |||
debug mode | |||
After the debug mode is activated, the following commands are available: | |||
==== Script Debugger ==== | 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 a given object added to inventory | |||
QUIT - Quit game (originally, but now locks up) | |||
* Does not work with King's Quest 2 | |||
==== Script Debugger: AGIv2/AGIv3 ==== | |||
Usually, the debug mode is activated by pressing [ALT + D]. However, there | Usually, the debug mode is activated by pressing [ALT + D]. However, there | ||
are some alternative ways/exceptions with some games. These games require a | are some alternative ways/exceptions with some games. These games require a | ||
certain sentence typed in | certain sentence to be typed in; perhaps this was done to access the debug | ||
platforms. | mode on other platforms, without redefining keys in the code. The games and | ||
their sentences are: | |||
Gold Rush! - BIRD BOY | Gold Rush! - BIRD BOY | ||
| Line 84: | Line 98: | ||
King's Quest 3 - RATS ASS (only in v2.14) | King's Quest 3 - RATS ASS (only in v2.14) | ||
Police Quest 1 - STINK BUGS (only in v2.0G) | Police Quest 1 - STINK BUGS (only in v2.0G) | ||
Space Quest 2 - DBG | Space Quest 2 - BACKSTAGE or DBG (TESTER brings up ego position) | ||
After the debug mode is activated, the following | After the debug mode is activated, the following commands are available: | ||
TP - Teleport (change room/scene/script) | TP - Teleport (change room/scene/script) | ||
| Line 97: | Line 110: | ||
RESET FLAG - Resets a given flag | RESET FLAG - Resets a given flag | ||
GET OBJECT - Get a given object added to inventory | GET OBJECT - Get a given object added to inventory | ||
[SCROLL LOCK] - Trace mode (only works with AGI v2) | [SCROLL LOCK] - Trace mode (only works with AGI v2) | ||