What Is Residual?

Residual is a cross-platform interpreter which allows you to play LucasArts' LUA-based 3D adventures: Grim Fandango and Escape from Monkey Island, provided you already have their data files. The clever part about this: Residual just replaces the executables shipped with the games, allowing you to play them on systems for which they were never designed!

You can find a thorough list with details on which games are supported and how well on the compatibility page. Residual is continually improving, so check back often.

Our forum and IRC channel, #residual on irc.freenode.net, are open for comments and suggestions. Please read our FAQ before posting.

Residual: A LucasArts 3D game interpreter

Last updated: $Date: 2009-04-20 10:26:30 +0200 (Mon, 20 Apr 2009) $
------------------------------------------------------------------------------

What is Residual?
-----------------
Residual allow to play LucasArts' LUA-based 3D adventures, such as
Grim Fandango.

Residual utilizes OpenGL for 3d graphics hardware acceleration.
A software renderer is also included for machines without hardware OpenGL.

Which games does it support?
----------------------------
Residual is a fairly slow developing project and is still very much considered
alpha. Currently it contains initial support for Grim Fandango.

It is possible, but far from promised, that the other LucasArts LUA-based
title 'Escape from Monkey Island' may be supported in the distant future.

How do I run Residual?
----------------------
As Residual is still under heavy development it is not yet stable, easy
to use, or complete. Some technical ability is required.

See the Configuration File section to see how to create the configuration
file.

To see a list of supported command-line parameters, run Residual with the
argument --help

Configuration file:
-------------------
By default, the configuration file is saved in, and loaded from:

Windows Vista:
\Users\username\AppData\Roaming\Residual\residual.ini

Windows 2000/XP:
\Documents and Settings\username\Application Data\Residual\residual.ini

Windows NT4:
<windir>\Profiles\username\Application Data\Residual\residual.ini

Windows 95/98/ME:
<windir>\residual.ini

Unix:
~/.residualrc

Mac OS X:
~/Library/Preferences/Residual Preferences

Others:
residual.ini in the current directory

An example config file looks as follows:
[residual]

[grim]
path=[path to all the .lab files]
game_devel_mode=TRUE

It runs really slow when using -zbuffer!
----------------------------------------
A large portion of gfx cards do not have a fast glDrawPixels access to zbuffer
implementation in the driver.

Unix users may be able to achieve playable framerates by using Mesa 5.0 or
above, but people unable to upgrade or Windows users must use software
renderer. Software renderer is generally faster on modern platform.

Black screen while menu dialogs on Radeon with Windows!
-------------------------------------------------------
Turn off "force fullscene antialiasing" in the OpenGL gfx driver options.

What is the state of Residual?
------------------------------
Basic gameplay works, including cutscenes. Parts of the game are playable,
but many features are either missing or unstable. There is no ability
to reliably save/load games, etc. Crashes are likely.

Game currently playable to:
Meche leaves Manny again (Rubacava, Year 2)

Caveats (in order of appearance):
1) Sound track destruction doesn't do quite a good enough job when
entering the spider web area (sp.set) in the Petrified Forest
2) Video of Copal's death (among other movies) plays at *almost* 2x
the correct speed, this causes buffer overflows in the audio.
While hardcoding the speed to the correct value used by the other
movies works, it is not a good fix and so it is not implemented
3) Sometimes the Demon Beavers get stuck on obstacles - open the
menu for a moment and they will correct themselves

For more information, see the page on Residual at the wiki page:
https://apps.sourceforge.net/mediawiki/residual

Which datafiles are needed?
---------------------------
*.LAB
GRIM.TAB

What are the default keys?
--------------------------
e,u,p,i : Examine, Use, Pickup, Inventory
Arrow keys : Movement
Shift : Hold to run
Enter : Selects items in inventory, conversation, etc
Escape : Skips cutscenes, exits certain screens
q : Exit Dialog Menu
Ctrl + c : Force Quit (from command-line)
Alt + x : Quit (ingame)
F1 : Menu

Development/debug keys from the original game
---------------------------------------------
Ctrl + e : Enter lua string to execute
Ctrl + g : Jump to set
Ctrl + i : Toggle walk boxes
Ctrl + l : Toggle lighting
Ctrl + n : Display background name
Ctrl + o : Create a door
Ctrl + p : Execute patch file
Ctrl + s : Turn on cursor
Ctrl + u : Create a new object
Ctrl + v : Print the value of a variable
Alt + n : Next viewpoint
Apt + p : Prev viewpoint
Alt + s : Run lua script
Shift + n : Next set
Shift + p : Prev set
Shift + o : Toggle object names
F3 : Toggle sector editor
Home : Go to default position in current set
j : Enter jump number

How do I report bugs?
---------------------
Don't. Residual is very alpha and we KNOW it doesn't work right.