joeyagi/games

AGI game data

Everything in this folder except this file is ignored by git. No game's files are, or should ever be, committed to the repository.

Place each game in its own subdirectory:

games/
  agidemo/    # Sierra's promotional AGIDEMO (freely redistributable)
  kq3/        # Local copy extracted from your licensed King's Quest 3
  ...

scripts/test-agi.sh runs the host tests against every subdirectory that holds a LOGDIR, and make iigs-game-disk-agi puts kq3 (or AGI_GAME=NAME) on the bootable IIgs volume. Everywhere else the interpreter reads the game from its DATA folder; joey-run --data games/kq3 copies a game there for one run.

Required files per game

For an AGI v2 game directory the loader needs:

• LOGDIR - logic script index
• PICDIR - picture (room background) index
• VIEWDIR - view (sprite/animation) index
• SNDDIR - sound index
• VOL.0 - resource volume 0 (always present)
• VOL.1..VOL.N - additional resource volumes (game-dependent)
• OBJECT - inventory table
• WORDS.TOK - parser dictionary

and it reads Sierra's interpreter version from AGIDATA.OVL when the folder has it, to behave as that version did (see agiQuirk); without it the interpreter behaves as 2.435, the version it was measured on.

File names are uppercase by AGI convention; the loader looks them up literally so the directory should match.

Sourcing AGI data

This repository never ships copyrighted Sierra game data. Two legitimate sources for development and testing:

1. Sierra's freely-distributed AGIDEMO promotional disk - redistributable since the late 1980s.
2. Fan-made AGI titles authored with AGI Studio - many are released under explicit redistribution licenses.

To test against a commercial Sierra game you legally own, extract the data files from your own copy and drop them in a new sibling directory here. Do not commit them.