LEGOIslandRebuilder/README.md
2022-04-01 16:23:31 -04:00

3.8 KiB


LEGO Island Rebuilder LEGO Island Rebuilder

A launcher and modification/patching tool for the 1997 video game LEGO Island

HomepageInfoDownloadBuildingUsageContributing

Supports Windows 95 - Windows 11 (Linux and macOS through Wine)

Info

LEGO Island Rebuilder is a launcher and modification tool for Mindscape's 1997 video game LEGO Island. It is the product of in-depth research done on the game; the bulk of which is documented on the LEGO Island Wiki.

It includes fixes to numerous bugs in the original game and multiple quality of life patches while making no permanent changes to the game installation. Additionally, Rebuilder acts as a full replacement for the original configuration tool.

Rebuilder currently supports all known versions of LEGO Island.

Download

The latest binaries are available on the releases page.

Building

Rebuilder utilizes the CMake build system. Ensure that it is installed before proceeding with the compilation.

Compilation is currently broken with build systems other than Ninja, so it must be installed until this is addressed.

In order to retain compatibility with Windows 95, Rebuilder is compiled using MSVC 4.2.* For convenience and compatibility, a portable version of MSVC 4.2 is available here. Its command line can be accessed by running bin/VCVARS32.BAT from any normal command prompt.

Using the MSVC command line:

# Clone this repository and enter it
$ git clone https://github.com/itsmattkc/LEGOIslandRebuilder

$ cd LEGOIslandRebuilder

# Create build directory and enter it
$ mkdir build

$ cd build

# Generate the build files
$ cmake -G Ninja -DCMAKE_BUILD_TYPE=Release ..

# Build the program
$ ninja

*While using a modern compiler for building is possible, there are no guarantees that Rebuilder will continue to function on older operating systems.

Usage

By default, Rebuilder opens a graphical interface which can be used to set the patch configuration and to launch the game. However, command line arguments are also supported:

  • -r/--run: Runs LEGO Island with the currently saved configuration, bypassing Rebuilder's interface entirely.
  • -h/--help: Shows a help screen with usage details.

Linux and macOS

Rebuilder works on non-Windows platforms using Wine.

It is important to note that mfc42 must be installed before using Wine with Rebuilder. This can be done using winetricks mfc42.

After the installation is complete, simply run Rebuilder with Wine using wine Rebuilder.exe.

Contributing

Contributions like code changes, documentation, or findings and research about the game are welcome. The best way of contributing code to Rebuilder is to open a pull request.