Baike.dev
All toolsOnline toolsAI codingTrendingOpen sourceNewsSubmit
Log in
< Back to tools
R

residualvm

> 编程语言
Open source

ResidualVM main repository

400 stars0 likes0 views
WebsiteGitHub

About

ResidualVM main repository

ResidualVM: A 3D game interpreter

  1. What is ResidualVM?
  2. Current state
  3. Running GrimE games
  4. Running Myst III
  5. Running The Longest Journey
  6. Configuration
  7. Troubleshooting
  8. Debugging
  9. Bug reports
  10. Changelog
  11. Credits
  12. Contact

1. What is ResidualVM?

ResidualVM is a game engine reimplementation that allows you to play 3D adventure games such as Grim Fandango, Escape from Monkey Island, Myst III and The Longest Journey.

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 and Escape from Monkey Island, as well as Myst III and The Longest Journey.

2.1.1. GrimE games support

Game Status
Grim Fandango Completable with glitches
Grim Fandango (demo) Completable with glitches
Escape from Monkey Island Completable with glitches
Escape from Monkey Island (demo) Completable with glitches
Escape from Monkey Island (PS2) Untested

2.1.2. Other games support

Game Status
Myst III Exile Completable
The Longest Journey Untested
The Longest Journey (demo) Untested

Specifics can be found at https://www.scummvm.org/compatibility/

For more information, see the page on ResidualVM at the wiki page: https://wiki.scummvm.org/

3. Running GrimE games

3.1. Required files

For both Grim Fandango and Escape from Monkey Island, 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: https://downloads.scummvm.org/frs/extras/patches/gfupd101.exe

3.1.2. Escape from Monkey Island

You will need to copy the data files from your Escape from Monkey Island CDs into one directory. Specifically, you'll need:

  • All of the M4B files from both CDs. One of the files is easy to miss: local.m4b is located on CD1 in Monkey4/MonkeyInstall. Note: The file voiceAll.m4b is repeated on both CDs. Use the copy from the first CD, it contains all of the required voice data.
  • The Textures directory, combined from both CDs. When copying, rename the FullMonkeyMap.imt files to FullMonkeyMap1.imt and FullMonkeyMap2.imt from CDs 1 and 2 respectively.
  • The Movies directory from each CD.
  • A copy of the Escape from Monkey Monkey Island update EXE. You will need a patch specific to the EMI version you're using:
Language URL
English https://downloads.scummvm.org/frs/extras/patches/MonkeyUpdate.exe
Portuguese https://downloads.scummvm.org/frs/extras/patches/MonkeyUpdate_BRZ.exe
German https://downloads.scummvm.org/frs/extras/patches/MonkeyUpdate_DEU.exe
Spanish https://downloads.scummvm.org/frs/extras/patches/MonkeyUpdate_ESP.exe
French https://downloads.scummvm.org/frs/extras/patches/MonkeyUpdate_FRA.exe
Italian https://downloads.scummvm.org/frs/extras/patches/MonkeyUpdate_ITA.exe
  • "EFMI Installer" if you have the Mac version of EMI.

3.1.3. Escape from Monkey Island (PS2)

You will need to copy the data files from your Escape from Monkey Island DVD into one directory. Specifically, you'll need:

  • All of the M4B files from the DVD.
  • The Videos, demos, jambalay, lucre, melee and monkey directores.

3.2. Running the game

  1. Prepare the game directory as specified above.
  2. Open ResidualVM.
  3. Click Add Game....
  4. Select the directory you created in step 1.
  5. Click Start.

If you want to play with software rendering, see the configuration section below, or use the in-game 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
Arrow keys Movement
Shift Hold to run
Enter Selects items in inventory, conversation, etc
Escape Skips cutscenes, exits certain screens
e Examine
u Use
p Pickup
i Inventory
q Exit Dialog Menu
. Skips dialogue
F1 Menu
Alt + x Quit (in-game)
Ctrl + c Force quit (from command line)
Alt + Enter Switch between windowed mode and fullscreen
Alt + s Save a screenshot

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 6.1. how to find it).

4. Running Myst III

4.1. Required files

You will need to copy the data files from your Myst III CDs or DVD into one directory. Specifically, you'll need:

  • The M3Data directory.
  • The Data directory.
  • The menu language file [LANGUAGE].m3u (DVD only).

The game must be at least version 1.1. For most releases of the game, the update is already applied on the installation media and 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 https://downloads.scummvm.org/frs/extras/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 directory 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 directory. 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 directories (including the DVD version's menu language file)

4.2. Running the game

  1. Prepare the game directory as specified above.
  2. Open ResidualVM.
  3. Click Add Game....
  4. Select the directory 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
Space Skip cutscenes, interact
Ctrl + F5 ResidualVM menu
Ctrl + c Force quit (from command line)
Ctrl + q Quit (in-game)
Alt + s Save a screenshot

5. Running The Longest Journey

5.1. Required files

You will need to copy the data files from your The Longest Journey CDs, DVD or digital distribution into one directory. Specifically, you'll need:

  • The 1a—79 directories (only 4f for demo version).
  • The global directory.
  • The static directory.
  • The fonts directory (not critical, but recommended – see below).
  • x.xarc and all the INI files.
  • game.exe (not critical, but recommended for a styled message dialog)

The 2-CD and DVD versions have some of the data files packed in installer archives. The archives need to be unpacked before they can be used.

Steam version and demo from Steam are missing the fonts directory. The required fonts can be copied over from demo version obtained from different sources or a GOG or retail version.

Mixing files from different versions of the game is not supported.

5.2. Running the game

  1. Prepare the game directory as specified above.
  2. Open ResidualVM.
  3. Click Add Game....
  4. Select the directory you created in step 1.
  5. Click Start.

5.3. Input controls

The mouse is used to interact with objects and menu elements.

Available keyboard shortcuts:

Key Binding
Escape Skip video sequence or current line of dialogue, skip time if Time Skip option is enabled
F1 Diary Menu
F2 Save game
F3 Load game
F4 Conversation Log
F5 April's Diary (initially disabled)
F6 Video replay
F7 Game settings
F8 Save a screenshot
F9 Toggle subtitles on and off
F10 Quit game and return to main menu
A Cycle back through inventory cursor items
S Cycle forward through inventory cursor items
I Inventory
P Pause the game
X Display all exits on current location
Page Up Scroll up in dialogues and in your inventory
Up arrow Scroll up in dialogues and in your inventory
Page Down Scroll down in dialogues and in your inventory
Down arrow Scroll down in dialogues and in your inventory
Enter Select currently highlighted dialogue choice
1 – 9 Select a dialogue choice
Ctrl + F5 ResidualVM menu
Alt + Enter Switch between windowed mode and fullscreen
Ctrl + c Force quit (from command line)
Ctrl + q Quit (in-game)
Alt + x Quit
Alt + q Quit
Alt + s Save a screenshot

6. 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.

6.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
Linux ~/.config/residualvm/residualvm.ini
macOS/OS X ~/Library/Preferences/ResidualVM Preferences
Others residualvm.ini in the current

Issues· 3 open

View all issuesOpen on GitHub

No open issues yet, or sync has not completed.

> Tags

C++

No comments yet. Be the first to share.

> Details

PublishedAug 1, 2026
UpdatedSep 17, 2026
Category编程语言
PricingOpen source

> Related tools

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言