NAGI

by Nick Sonneveld

Note: The AGI games run easily in DOSBox and if you select machine=tandy in the dosbox.conf you will even get the three voice tandy sound.

What is AGI?

AGI was developed by Sierra Online for the development and release of their adventure games in the late 1980's. Sierra was hailed for creating "3D" games, which meant the player could move their character around the screen and behind objects. Games using the interpreter have very distinctive blocky graphics and a text parser interface where the player could type in their commands.

The AGI interpreter was the starting point for many of Sierra's classic adventure game lines:

  • Kings Quest Series
  • Leisure Suit Larry Series
  • Police Quest Series
  • Space Quest Series
What is NAGI?

NAGI is a clone of Sierra's own interpreter. NAGI was created by disassembling the original AGI executable and writing equivalent C code that would run under SDL which is a free generic library for low-level access to graphics and audio.

Why do I need it?

Since it's a Windows program, NAGI doesn't depend on the hardware of the original IBM PC. If you have trouble running the original AGI games under Windows then NAGI might be helpful to you.

Symptoms with original AGI game:

  • Text is garbled (since the video card doesn't contain the appropriate font)
  • EGA/CGA do not display properly or you get a black screen
  • PC Speaker music does not work
Extra features with NAGI:
  • Mouse support for most games. You can control your character with the mouse.
  • Supports the 3 channel sound that's not possible with the PC Speaker.
  • Fake CGA support
  • You can play your games in a window instead of full screen.
How do I know if I have an AGI game?

Of all the AGI games I have encountered, they all follow a few basic file name arrangements.

  • Version 2 - object, words.tok, logdir, picdir, viewdir, snddir, vol.X
  • Version 3 - object, words.tok, <GAMEID>dir, <GAMEID>vol.X
  • Amiga Version 3 - object, words.tok, dirs, vol.X
Where <GAMEID> is replaced by the game's actual id (e.g."KQ4" for Kings Quest 4).

The original Sierra interpreter used these files and are not used by NAGI:
AGI, sierra.com, agidata.ovl, cga_graf.ovl, ega_graf.ovl, hgc_font, hgc_graf.ovl, hgc_objs.ovl, ibm_objs.ovl, jr_graf.ovl, vg_graf.ovl
They can be safely deleted or moved to another directory to save space.

Sierra also has a later interpreter called SCI. NAGI does not run these data files but FreeSCI does! You can pick out these files because they follow the format:
resource.XXX, resource.map

How to install NAGI?

You need TWO files: NAGI and the SDL Library which NAGI depends on. Both of these can be found at the.

Unzip both NAGI and SDL into the same directory such as "C:\NAGI\"

By default NAGI will look in the current directory and one directory level down to search for games, so if you wish, install your games like this:

c:\nagi\
c:\nagi\larry\
c:\nagi\timequest\
c:\nagi\kingsquest4\
c:\nagi\v\

and then run n.exe from c:\nagi. NAGI will display a menu of all detected AGI games.

If you have trouble running NAGI in Windows NT, 2000, XP

Edit nagi.ini and go to the [sdl] section (should be at the bottom). Change "drv_video" or "drv_sound" to its alternative values. These should be available in the ini file as well.

If you get an "the dynamic link library SDL.dll could not be found" error

You need to make sure NAGI and SDL have been installed in the same directory. Alternatively, you could make sure SDL.DLL is in c:\windows\system.

For full-screen

Edit nagi.ini. Go to the [vid] section. Change the value of "full_screen" to 1.

To switch to CGA mode

Edit nagi.ini. Go to the [vid] section. Change the the value of "renderer" to "cga0", "cga1" or "ega". The "ega" option will give you back your 16 mode mode.

Other AGI clones

Sarien has been around a lot longer and has been ported to other platforms. Another clone is AGIL but this has been discontinued so work can be made on NAGI to port it to Linux.

More sites to learn more about AGI

AGI Messageboard - most people interested in AGI or have questions come here.
AGI Development Site - if you wish to create your own AGI game. Has a huge links page.

NAGI - the homepage of NAGI.
NAGI Docs - Online docs for NAGI.
Sarien - the oldest AGI clone.
AGIL - Linux upstart

sonneveld@hotmail.com - e-mail address if you have any more questions.

Permissions:
You can post this anywhere as long as you note that I'm the original author.

NAGI download page
__________________
-Colin Snover

 


by helping to defray some of the costs of hosting this site. If it has been of help to you, please consider contributing to help keep it online.
Thank you.
pixe
Top

© 2006 to present The Sierra Help Pages. All rights reserved. All Sierra games, artwork and music © Sierra.