Adventure Game Interpreter Specifications

by Peter Kelly, ptrkelly@ozemail.com.au (editor)

Version 3.0 updated by Claudio Matsuoka, claudio@helllabs.org

v3.0, 22 May 1999

 

This document is a collection of all the information currently known about the structure and operation of the Adventure Game Interpreter, used in 1984--1989 for a variety of adventure games published by Sierra On-Line such as Space Quest I and II, and Leisure Suit Larry in the Land of the Lounge Lizards.

 Chapter 1 - Introduction

1.1  About this Document

1.2  Audience

1.3  Conventions Used in this Document

1.4  What's Still Missing

1.5  Change Log

1.6  Credits

 

Chapter 2 - Overview

2.1  Versions of the AGI Interpreter

2.2  AGI Game Files

2.3  LOGIC, PICTURE, SOUND, and VIEW Data Files

2.4  What is Ego?

2.5  AGI Commands

2.6  Debug Modes

2.7  Priority Bands and Control Lines

 

Chapter 3 - AGI Internals

3.1  How the Interpreter Works

3.2  Variable Types

3.3  Variables Used by the Interpreter

3.4  Flags Used by the Interpreter

3.5  Memory Organization

3.6  Game IDs and Loaders

3.7  Encrypted AGI Data

3.8  Player Input Parsing

93.9  AGI Interpreter Versions

3.10  Version Differences

 

Chapter 4 - The LOGIC Language

4.1  LOGIC Syntax

4.2  Reference of the LOGIC Commands

4.3  Discussion of Sample LOGIC Code from KQ4

 

Chapter 5 - Resource Formats

5.1  Directory Files

5.2  Format of VOL Files (version 2)

5.3  Version 3 Resource Storage

5.4  Sample Code

 

Chapter 6 - LOGIC Resources

6.1  Introduction

6.2  Command List and Argument Types

6.3  LOGIC Resource Format

6.4  Sample Code

 

Chapter 7 - PICTURE Resources

7.1  Introduction

7.2  PICTURE Resource Format

7.3  Implementation

7.4  Using Higher Resolution Modes

7.5  Sierra's Picture Editor

7.6  Sample Code

 

Chapter 8 - VIEW Resources

8.1  Introduction

8.2  VIEW Resource Format

8.3  VIEW Table

8.4  VIEW Test Commands

8.5  Sample Code

 

Chapter 9 - SOUND Resources

9.1  Introduction

9.2  Sound in the IBM PCjr

9.3  Sound in the Apple IIgs

9.4  Sound in Other Platforms

9.5  SOUND Resource Format (PCjr version)

9.6  SOUND Resource Format (IIgs version)

9.7  Playing the Sounds on a Sound Card

9.8  Sample code

 

Chapter 10 - Other Game Data

10.1  Format of the OBJECT File

10.2  Format of WORDS.TOK

10.3  Sample Code

 

Chapter 11 - Other Information

11.1  The AGDS Package

11.2  The Making of the Thunderstorm Educational Program

11.3  Other AGI Interpreters