Open main menu

Difference between revisions of "AGI/Debug Modes"

138 bytes added ,  08:25, 23 December 2011
m
wiki-fication
m (fixing info)
m (wiki-fication)
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 three major versions of AGI. AGIv1, AGIv2, and surprisingly, AGIv3.
There are three major versions of AGI. AGIv1, AGIv2, and surprisingly, AGIv3.


AGIv1 is an old and uncommon interpreter. The only games using it are the
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.
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
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.
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 ====
==== Script Debugger: AGIv1 ====


In King's Quest 2, the debug mode is activated by entering "FAST SPEAK" at
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.
the command line. It will be activated on room change.


In The Black Cauldron, the debug mode is activated by pressing [ALT + D].
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!
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:
After the debug mode is activated, the following commands are available:


  TP            -  Teleport (change room/scene/script)
  TP            -  Teleport (change room/scene/script)
Line 102: Line 88:
==== Script Debugger: AGIv2/AGIv3 ====
==== 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 to be typed in; perhaps this was done to access the debug
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
mode on other platforms, without redefining keys in the code. The games and
their sentences are:
their sentences are:


  Gold Rush!      -  BIRD BOY
  Gold Rush!      -  BIRD BOY
Line 114: Line 100:
  Space Quest 2  -  BACKSTAGE or DBG (TESTER brings up ego position)
  Space Quest 2  -  BACKSTAGE or DBG (TESTER brings up ego position)


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


  TP            -  Teleport (change room/scene/script)
  TP            -  Teleport (change room/scene/script)
Line 127: Line 113:
  [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 =====
86

edits