Difference between revisions of "AGI/Debug Modes"

Jump to navigation Jump to search
2,322 bytes removed ,  20:40, 14 December 2011
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.
_____________________________________________________________________________
( [2] Intro                                                                  )
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯


  This FAQ will explain the several debug modes found in Sierra On-Line
  === Intro ===
AGI adventure games.


Before you read, keep in mind the following things:
This FAQ will explain the several debug modes found in Sierra On-Line adventure games.


- References to "ego" mean "the main character" or the object you control.
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.


- Any brackets, asterisks or quotation marks should NOT be typed in. They're
This FAQ only covers the debug modes of IBM PC versions, however, some of them might work on the other systems too.
  only used to clarify.


- Anything between brackets means it's either a key or a combination of
==== AGI ====
  keys. So:


  [CTRL + D] means you push the CONTROL-key and the D-key AT THE SAME TIME.
AGI (Adventure Game Interpreter)


- Between quotation marks means it should be typed in.
* 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


- Words between asterisks should be replaced with a proper word/object/thing.
Games using the AGI interpreter:
  So:


  "PITCH *object name*" means you should type the object you want to get,
* Donald Duck's Playground
  e.g. "PITCH WIG".
* 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


And while you might know, Sierra games use an "interpreter". This basically
=== Debug mode in AGI games ===
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
This debug mode is solely script related, which means that a debug script is
them might work on the other systems too.
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,
( [2.1] AGI                                                                  )
AGIv3.
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯


AGI (Adventure Game Interpreter)
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.


Video: 160x200 resolution, 16 colors (2 or 4 colors on some platforms)
AGIv2 and AGIv3 are pretty alike and so are their debug functions. Debug-wise
Audio: Up to 4 channels of audio (if platform supports it)
the only major difference is that AGIv3 does not contain the trace-function.
Platform: IBM PC (including PCjr & TANDY), Commodore AMIGA, Atari ST,
AGIv3 games are Gold Rush!, King's Quest 4 (AGI version), the ManHunter
          Apple ][(GS), Apple Macintosh & Coco 3 (TRS-80 Color)
series and a certain version of The Black Cauldron. The rest of the games use AGIv2.
Period: 1984-1989


Games using the AGI interpreter:
==== Script Debugger ====


Donald Duck's Playground
Usually, the debug mode is activated by pressing [ALT + D]. However, there
Gold Rush!
are some alternative ways/exceptions with some games. These games require a
King's Quest 1: Quest for the Crown
certain sentence typed in, perhaps to access the debug mode on other
King's Quest 2: Romancing the Throne
platforms. They are the following:
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
 
  _____________________________________________________________________________
( [3] 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.
 
_____________________________________________________________________________
( [3.1] 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
After the debug mode is activated, the following options are available, by
typing:
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:
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
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 =====
( [3.1.1] Game Specific: Al Lowe games                                       )
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯


Games programmed by Al Lowe: Leisure Suit Larry, The Black Cauldron, Police
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
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
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
commands will only apply to a specific game, that game's abbreviation is
given between brackets.
given between brackets.


Commands:
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)
  or will use different keys like F6 or F10 (e.g. v1.01)


_____________________________________________________________________________
===== Game Specific: Priority commands =====
( [3.1.2] Game Specific: Priority commands                                   )
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯


Games that use priority commands: Space Quest 1, Police Quest 1, Gold Rush!,
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
Leisure Suit Larry, The Black Cauldron, Donald Duck's Playground & King's
Quest 4.
Quest 4.


Commands:
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 =====
( [3.1.3] Game Specific: Space Quest series                                   )
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯


General commands:
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:
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! =====
( [3.1.4] Game Specific: King's Quest series & Gold Rush!                     )
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯


General commands:
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:
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:
King's Quest 4:


  CREATE DAY        -  Turns the game into day
  CREATE DAY        -  Turns the game into day
86

edits

Navigation menu