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.

AGI Specifications: 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

AGI Specifications: 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

AGI Specifications: 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

AGI Specifications: 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

AGI Specifications: 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

AGI Specifications: Chapter 6 - LOGIC Resources

6.1  Introduction

6.2  Command List and Argument Types

6.3  LOGIC Resource Format

6.4  Sample Code

AGI Specifications: 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

AGI Specifications: 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

AGI Specifications: 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

AGI Specifications: Chapter 10 - Other Game Data

10.1  Format of the OBJECT File

10.2  Format of WORDS.TOK

10.3  Sample Code

AGI Specifications: Chapter 11 - Other Information

11.1  The AGDS Package

11.2  The Making of the Thunderstorm Educational Program

11.3  Other AGI Interpreters