1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325
|
ResidualVM: A 3D game interpreter
=================================
1. [ What is ResidualVM? ](#1-what-is-residualvm)
2. [ Current state ](#2-current-state)
3. [ Running GrimE games ](#3-running-grime-games)
4. [ Running Myst III ](#4-running-myst-iii)
5. [ Configuration ](#5-configuration)
6. [ Troubleshooting ](#6-troubleshooting-known-bugs-issues)
7. [ Debugging ](#7-debugging)
8. [ Bug Reports ](#8-bug-reports)
9. [ Contact ](#9-contact)
## 1. What is ResidualVM?
ResidualVM is a game engine reimplementation that allows you
to play 3D adventure games such as Grim Fandango and Myst III.
ResidualVM utilizes OpenGL for 3D graphics hardware acceleration.
A software renderer is also included for machines without hardware OpenGL.
## 2. Current state
At this point ResidualVM is fit for normal use, when playing supported
games, it is however worth noting that you should still save early, and
save often, as problems or dead-ends might still exist. (Grim Fandango
itself originally had a few unintentional ways to get the game stuck).
### 2.1. Which games does ResidualVM support? ###
Currently ResidualVM supports Grim Fandango as well Myst III.
#### 2.1.1. GrimE-games support ####
Game | Status
-------------------------------- | -------------------------
Grim Fandango | Completable with glitches
Grim Fandango (demo) | Completable with glitches
#### 2.1.2. Other games support ####
Game | Status
-------------------------------- | -------------------------
Myst III Exile | Completable with glitches
Specifics can be found at
http://www.residualvm.org/compatibility/
For more information, see the page on ResidualVM at the wiki page:
http://wiki.residualvm.org/
## 3. Running GrimE games
### 3.1. Required files
For Grim Fandango, you will need the original game files as well
as the official update patch.
#### 3.1.1. Grim Fandango ####
You will need to copy the data files from your Grim Fandango CDs into one
directory. Specifically, you'll need:
* All of the .LAB files from both CDs
* A copy of the Grim Fandango 1.01 update EXE
The patch can be downloaded from:
http://demos.residualvm.org/patches/gfupd101.exe
### 3.2. Running the game ###
1. Prepare the game directory as specified above
2. Open ResidualVM
3. Choose "Add Game"
4. Select the folder you created in Step 1
5. Click Start
If you want to play with software-rendering, see the configuration-section
below, or use the ingame settings to disable 3D Acceleration.
When launching the game for the first time, ResidualVM will perform a full
integrity check of your game data files. This can take a bit of time, but it
will not happen again on successive runs. This prevents bugs from incompatible
game data, and helps us to find game variants that we're not aware of.
### 3.3. Default Keyboard-settings ###
Key | Binding
----------- | ---------------------------------------------
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
. | Skips dialogue
q | Exit Dialog Menu
Ctrl + c | Force Quit (from command-line)
Alt + x | Quit (ingame)
Alt + enter | Switch between windowed-mode and fullscreen
F1 | Menu
### 3.4. Joystick/gamepad support ###
If you want to use a joystick or gamepad for navigation, the joystick support
of the engine needs to be enabled using one of the following two options:
* start residualvm with "--joystick" parameter
* add "joystick\_num=0" to the "[residualvm]" section of the configuration file
(see section 5.1. how to find the file)
## 4. Running Myst III
### 4.1. Required files ###
You will need these elements from your game CDs or DVD :
* M3Data directory
* Data directory
* The menu language file '[LANGUAGE].m3u' (DVD only)
When using the CD version, you will need to merge the 'Data' directories from
all four discs. Playing directly from the CDs is not supported.
The game must be at least version 1.1. For most releases of the game, the
update is already applied on the installation media, no action is required.
Otherwise, ResidualVM asks for the update to be installed and refuses to run
the game. The updates can be downloaded from
http://demos.residualvm.org/patches/.
The DVD version is multilingual, you can change the in-game language from the
game menu. However, you must choose the language of the menus by copying the
appropriate files. You have to copy the menu language file from your chosen
language folder on the disc. On the DVD, the menu language file can be named
'language.m3u' or '[LANGUAGE].m3u' depending on the release. It should
be copied to the 'M3Data/TEXT' folder. If the file is named 'language.m3u',
it should be renamed to the explicit language e.g. ENGLISH.m3u for English.
The required files must be organized in the following manner to be recognized:
├── Data
│ └── *.m3a
└── M3Data
└── Various files and folders (including the DVD version's menu language file)
### 4.2. Running the game ###
1. Copy the necessary files to a folder on your Hard Drive
2. Open ResidualVM
3. Choose "Add Game"
4. Select the folder you created in step 1
5. Click Start
### 4.3. Input controls ###
The mouse is used to look around and interact with the ages.
Available keyboard shortcuts:
Key | Binding
---------- | ------------------------------
Escape | Original Myst III Menu
Ctrl + F5 | ResidualVM Menu
Space | Skip cutscenes, interact
Ctrl + c | Force Quit (from command-line)
Ctrl + q | Quit (ingame)
## 5. Configuration
Currently, not all the settings for ResidualVM are available through the GUI,
if you have problems with getting anything to work, first try to pass the
settings from the command line, then, if that doesn't work, try to change your
configuration file manually.
### 5.1. Location of configuration file ###
By default, the configuration file is saved in, and loaded from:
Operating System | Location
-------------------- | ---------------------------------------------------------------------------
Windows Vista/7/8/10 | \Users\username\AppData\Roaming\ResidualVM\residualvm.ini
Windows 2000/XP | \Documents and Settings\username\Application Data\ResidualVM\residualvm.ini
Unix | ~/.residualvmrc
Mac OS X | ~/Library/Preferences/ResidualVM Preferences
Others | residualvm.ini in the current directory
### 5.2. Interesting settings for GrimE games ###
The following settings are currently available in the config-file,
however some of them might not work with your current build. And
some of them might make ResidualVM crash, or behave in weird ways.
Setting | Values | Effect
-------------- | ----------------- | ---------------------------------------------------
show_fps | [true/false] | If true, then ResidualVM will show the current FPS-rate, while you play.
last_set | [set-name] | The set you were last on, ResidualVM will try to continue from there.
last_save | [save-number] | The save you last saved, ResidualVM will have that selected the next time you try to load a game.
use_arb_shaders| [true/false] | If true, and if you are using the OpenGL renderer ResidualVM will use ARB shaders. While fast they may be incompatible with some graphics drivers.
fullscreen_res | [desktop/WWWxHHH] | If set to "desktop" (the default), ResidualVM will use your desktop resolution in fullscreen mode. If set to a resolution such as "640x480" or "1280x720", that resolution will be used.
## 6. Troubleshooting, Known Bugs, Issues
Grim Fandango had a few issues when it came out, and a few new and exciting
issues when you try to run it on newer hardware. Some of these have been
fixed in ResidualVM, but ResidualVM itself also has a few new issues that we
know about:
http://github.com/residualvm/residualvm/blob/master/KNOWN_BUGS
Look below for help with these issues, and if you can't find help here, try
either the forums at our homepage, or IRC: #residualvm at freenode.
### 6.1. I played a bit, but can't start a new game! ###
This is because the last save and visited scene is stored in your configuration
file, either delete grim-fandango from the ResidualVM-menu, and re-add it, or
go to your configuration file, and clean out the last-save and last-set entries.
### 6.2. My Save Games don't work any more ###
Did you recently update to a newer build of ResidualVM?
ResidualVM is still a work in progress, which means that the save format might
change between builds. While attempts are made to keep save file compatibility,
this isn't always possible.
### 6.3. In fullscreen mode, the picture is stretched! ###
This is know issue, in future versions it will be resolved.
## 7. Debugging
WARNING: This section contains information about the various tools that
are included for debugging ResidualVM, this should not be necessary for
normal play at all! However, the curious might like to know how to access
these tool. Please use at your own risk!
### 7.1. Debugging GrimE Games ###
The development console can be used to debug Grim Fandango.
To enter the debug console, press Ctrl + d. Use the `help`
command to display a list of the available commands.
Some of the useful commands are:
Command | Description
------------- | -----------------------------------------------------------
jump | Jump to a section of the game
lua_do | Execute a lua command
openlog | Show the log of errors/warnings/information from the engine
set_renderer | Select a renderer (software, OpenGL or OpenGL with shaders)
The `jump` targets can be found at:
* http://wiki.residualvm.org/index.php/Grim_Fandango_Debug_Mode#jump_targets
### 7.2. Debugging Grim Fandango ###
Grim Fandango also includes a built in debug mode. To enable debug-keys and
debug-mode, you will have to add the following line to your configuration file
under the Grim Fandango-entry:
game_devel_mode=true
Development/debug keys from the original game:
Key | Binding
---------- | ------------------------------------
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
Note that these are only available after enabling debug-mode.
### 7.3. Debugging Myst III ###
The debug console can be triggered using Ctrl + d. Use the `help` command to
display a list of the available commands.
The most useful commands are:
Command | Description
----------- | ------------------------------------------------------------
dumpArchive | Extract a game archive
infos | Display the name of a node and show the associated scripts
go | Jump to a node
var | Display or alter the value of a variable from the game state
## 8. Bug Reports
ResidualVM still has a few bugs, many might already have been reported,
but should you find a new one, don't hesitate to report it.
### 8.1. How, and where do I report bugs? ###
You can report bugs at our github-issue-tracker:
http://www.github.com/residualvm/residualvm/issues
Please read the Wiki regarding how to report bugs properly first though:
http://wiki.residualvm.org/index.php?title=Reporting_Bugs
Remember to always have the following information in your bug reports:
* Information about the game (Grim Fandango, Myst III)
* Language of game (English, German, ...)
* Platform and Compiler (Win32, Linux, Mac OS X, ...)
* Bug details, including instructions on reproducing it
* Preferably also a link to a save game right before the bug happened.
## 9. Contact
* Homepage: http://www.residualvm.org/
* Wiki: http://wiki.residualvm.org/
* Forums: http://forums.residualvm.org/
* IRC: #residualvm on freenode
|