The multi-install tool is a program which allows side-by-side installs of
Baldur's Gate II at a minimal size. This can be useful for example when playing
incompatible mods, or when wanting to test a mod on a fresh install. Specifically,
it follows the instructions posted by igi in Discussion:
Multiple BG2 Installations.
To use the multi-install tool, you will need:
- An installed copy of a supported Infinity Engine game.
- A recent java runtime environment - if you get an error saying 'Unsupported
class version', your Java version is not new enough.
- The multi-install tool.
Supported Infinity Engine Games
The Multi Install Tool will work on any of the following Infinity Engine
- Baldur's Gate for Mac OS X
- Baldur's Gate II: Shadows of Amn for Windows, with or without the official
- Baldurs Gate II: Shadows of Amn for Mac OS X
- Baldur's Gate II: Thrown of Bhaal, with the official patch.
- Baldur's Gate II: Throne of Bhaal for Mac OS X
- Baldur's Gate II: The Collection
- Icewind Dale for Mac OS X or Windows, with or without the official patch,
but without any expansion packs.
Note: Mac OS 9 games are not supported.
In general, any patches or mods after the official patches for each game
will have no impact on support by the Multi Install Tool.
- Ensure that you have met the requirements above.
- Download and run the multi-install tool.
- Fill in the fields as follows:
- Source: an existing installation, to be used as a basis for
- Sink: where you want the new installation to live on your
- Optionally, change any available preferences in the lower pane. Depending
on the game you have selected to clone, your operating system, and whether
you have any save games, not all of the displayed options will be enabled.
Each option will increase the size of the clone directory, but may be required
for certain functionality or mods.
Note: if 'data' is selected, 'music' will always be copied,
regardless of whether that checkbox is selected.
- Click 'Go'.
- Wait until the progress bar fills in and says 'Done'.
- Run the clone with the main executable (eg, 'bgmain.exe' - not baldur.exe)
in the clone folder.
The newly-created install will have the same set of patches and mods to
start with as the one it was cloned from. You can apply mods as usual to
the cloned game, and they will not affect any other installation you have
on your system.
The Multi-Install Tool supports the following command-line options, useful
for batch-mode operations and for launching the Multi Install Tool from another
application with pre-filled default values.
- Select a folder to use as a source game.
- Select a destination folder for the clone.
- If provided, do not launch the GUI, and operate in batch mode. Otherwise
- If given, duplicate the entire contents of the 'data' folder, the 'music'
folder, and the 'movies' folder, if they exist. Also change the value of
hd0: in the ini file to point to the sink, rather than patching the main
Otherwise, create a data folder in the sink directory filled with nonsense
data (so that mods checking for the existance of an expansion pack will
- If given, duplicate the entire contents of the 'music' folder, if it
exists. Otherwise, create a cloned game which reads this information from
the original game.
Note: This preference is implicitly given by giving '--copy-data'.
- If given, duplicate the entire contents of the 'characters' folder, if
it exists. Otherwise, create a cloned game without this data.
- If true, duplicated any save games that exist. Otherwise, create a clone
game with no saved games.
- If true, duplicate the entire contents of the 'portraits' folder, if
it exists. Otherwise, create a clone without this information.
- -v, --verbose
- If given, print everything that's happening to STDOUT. Otherwise, be
quiet unless something goes wrong.
Not all --copy-* options are meaningful on all configurations. In particular,
if the Multi-Install tool detects that it can use symbolic links, then only
--copy-save has any effect.
This tool was created by andrewas and Orion's Stardom. Visit the Gibberlings
Three forums for information on this and any other Gibberlings Three
projects on which they may be working.
Credits and Copyright Information
The Multi Install Tool, and this readme, are copyright 2006-2007, Multi-Install
Tool contributors. All rights reserved.
The Multi Install Tool is Free Software released under the GNU
General Public License, version 2 or any later version. The source
code is included in the package.
This readme is released under the GNU Free Documentation
License, Version 1.2 or any later version, with no front-cover texts,
no back-cover texts, and no invariant sections.
The Multi Install Tool uses and includes jargs.
Copyright and licensing information for jargs can be found in the 'jargs'
folder in the jar.
Version 5.1.12 - September 20, 2007
- Added support for Baldur's Gate II: The Collection
Version 5.1.11 - July 12, 2007
- (CloningData.java) Added support for Icewind Dale, Baldur's Gate (and
Tales of the Sword Coast) support, as well as (hopefully) full support
for the same games on OS X.
- Possibly other changes in the intervening months.
Version 5.1.10 - Feburary 15, 2007
- Removed SwiXML GUI because it was causing incredibly slow load times.
- Now featuring Java 1.5 support
Version 5.1.9 - February 14, 2007
- (CloningData.java, CloneWorker.java, CaseInsensitiveFileFilter.java)
- Added Mac OS X game support.
- (CloneWorker.java) Code cleanup
Version 5.1.8 - February 14, 2007
- (Filesystem.java) Fixed copy_textually routine so it works
- (CloningData.java) Fixed exe patch so that it has the correct number
- (CloningData.java) Added missing file chitin.key to common files.
Version 5.1.7 - February 14, 2007
- Added the 'jargs' package to the .jar so that the Multi Install Tool
will actually start
- (FileSystem.java) cleaned up the copy_binary method.
- (MultiInstall.java) added '--verbose' command-line option.
- (MultiInstall.java) reversed '--interactive' command-line option to '--batch'.
- (MulitInstall.java) turned all boolean options off by default.
Version 5.1.6 - February 13, 2007
- Clarified copyright notices in the readme.
- Introduced command-line API.
- Minor code clean ups.
Version 5.1.5 - Feburary 13, 2007
- (Filesystem.java) improved copy() so that it doesn't need files in the
system temp folder. This requirement was preventing files from being copied
in indeterminable circumstances.
- (Filesystem.java) fixed a bug where copy() would fail silently when large
files were copied verbatim.
- (CloneData.java) fixed wrongly-transcribed values for BG2, which was
causing a PatchFailedException
- (MultiInstall.java) exception stacktraces are now written to a file called
'MultiInstall.err' in the current directory as well as to standard error.
- (FileSystem.java) Fixed a bug where PatchFailedExceptions were reported
- (MultiInstall.java) reenableGUI() is now properly reentrant - it previously
threw a NullPointerException.
Version 5.1.4 - February 13, 2007
- Rolled back the progress bar granulation from 5.1.3, because it stopped
the clone from being performed.
Version 5.1.3 - Februrary 12, 2007
Version 5.1.2 - February 12, 2007
- (MultiInstall.java, CloneWorker.java) Re-implemented exception reporting,
which broke when
the cloning logic was put into a background thread.
- (CloneWorker.java) Made CloneWorker.cloneWithLinking() and CloneWorker.cloneWithoutLinking()
return if they notice isCancelled() to be true - ie, they
now honour the cancel button.
- Dev readme now points to dev versions thread
Version 5.1.1 - Feburary 12, 2007
- (Filesystem.java) recoded text replacement algorithm in "copy()" to use
Version 5.1 - Feburary 7, 2007
- Re-added support for copying extra folders which was not in the 5.0 series.
- Added support for Icewind Dale 1 (the expansion packs for this game are
not supported yet).
Version 5.0.1 - January 27, 2007
- The status bar should now work properly.
Version 5.0 - September 18, 2006
- This version represents a complete rewrite of the Multi-Install Tool.
This version is the first to work on Mac OS X, and should also fix bugs
which may have occured on Windows 98 and ME.
Version 4.2 - January 28, 2006
- Improved Throne of Bhaal compatibility checks
Version 4.1 - October 30, 2005
- Fixed starting XP so it
isn't always 0
- Improved sanity checks
Version 4 - June 14, 2005
- Various bugfixes
- Interface overhaul
- Various bugfixes
- Interface overhaul
- Various bugfixes
- Interface overhaul