8,012
edits
Difference between revisions of "AGI/Debug Modes"
updating with 0.94 changes
(simple wiki-fication) |
(updating with 0.94 changes) |
||
| Line 1: | Line 1: | ||
Sierra On-Line Debug Mode FAQ | Sierra On-Line Debug Mode FAQ | ||
Version 0. | Version 0.94 [15-Apr-08] by HWM | ||
Thanks to Omer Mor, Lars Skovlund & Kelmer for their valuable information. | Thanks to Omer Mor, Lars Skovlund & Kelmer for their valuable information. | ||
| Line 59: | Line 59: | ||
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 | |||
only games using | self-booting first versions of King's Quest 2 and The Black Cauldron, which | ||
2 and The Black Cauldron, which are rare and hardly used nowadays. Donald | are rare and hardly used nowadays. However, the AGIv1 games do have a debug | ||
Duck's Playground | 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 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 | 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. | 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 | 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. | 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 ==== | ==== Script Debugger: AGIv1 ==== | ||
Usually, the debug mode is activated by pressing [ALT + D]. However, there | In King's Quest 2, the debug mode is activated by entering "FAST SPEAK" at | ||
are some alternative ways/exceptions with some games. These games require a | the command line. It will be activated on room change. | ||
certain sentence typed in | |||
platforms. | 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: | |||
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 | |||
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 | Gold Rush! - BIRD BOY | ||
| Line 86: | Line 114: | ||
Space Quest 2 - DBG | Space Quest 2 - DBG | ||
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 124: | ||
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) | ||
These commands will work in all the AGI games with a debug mode. However some | 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 | games have additional commands for use with the debug mode. The next chapters | ||
will cover them. | will cover them. | ||
===== Game Specific: Al Lowe games ===== | ===== Game Specific: Al Lowe games ===== | ||