Installation

Desktop (Windows, Mac, Linux)

Pre-built

Prerequisites

• A copy of the game's files (likely LEGO_ISLANDI.ISO)
• A compatible desktop platform, one of:
  • Windows (x64 or ARM64)
  • Linux (x64)
  • macOS (ARM64)

1. Download the latest CI build for your platform from the Releases page.
2. Extract the contents of the download to a location of your choosing.
3. If you haven't already, extract the contents of LEGO_ISLAND.ISO to a location of your choosing. This can be anywhere, however it is recommended to put it in a folder alongside the game executable.
4. Run isle-config. For Windows users, this will be named isle-config.exe.
5. In isle-config, navigate to the Game tab.
6. Set Data Path to the directory you extracted LEGO_ISLANDI.ISO to. This directory should contain all the original LEGO Island files, including the DATA folder.
7. Set any additional settings using the config tool.
8. Save your changes either with Save and Exit or Save and Launch.
9. You can now run the game by simply executing isle (or isle.exe).

Build from source

Prerequisites

• A copy of the game's files (likely LEGO_ISLANDI.ISO)
• Git
• CMake

The process for building isle-portable is much like that of a regular CMake project.

git clone --recursive https://github.com/isledecomp/isle-portable.git
cd isle-portable
mkdir build && cd build
cmake ..
cmake --build . --parallel

After the build process is complete, follow along from step 2 in the instructions above.

Alternatively, if you would prefer to use pre-installed versions of SDL3 and iniparser;

cmake .. -DDOWNLOAD_DEPENDENCIES=OFF

Web port (Emscripten)

Prerequisites:

1. Docker is installed
2. A copy of the game files (mounted ISO) is present

The following command will set up the web port. Make sure to replace /path/to/iso with the path to the game's files:

docker run -p 6931:6931 \
           -v /path/to/iso:/assets \
           ghcr.io/isledecomp/isle-portable-emscripten:master

Open http://localhost:6931 in your browser to play the game.

Please note that this setup is primarily intended for local play. If you intend to host this publically on the Internet, be sure to set up a web server ready for production (handling SSL etc).

Using HTTPS may be necessary even in a local network if the server is not accessed through localhost. Here is an example using Docker Compose to set up the service together with a SSL-enabled reverse proxy:

ASSETS_PATH=/path/to/iso docker compose up

This should allow you to open https://localhost:6932 in your browser. You may have to skip possible security warnings.

3DS Family Port

Prerequisites:

1. Device is running custom firmware (Luma3DS)

⚠️ Never follow video guides when installing CFW. Please follow the 3DS Hacks Guide.

2. Device has a working touch screen
3. You have the game files. This guide assumes you have the mounted ISO on your system.

Installation:

1. Copy the isle.3dsx file to the 3ds folder on the root of your SD card.
2. Next, in the 3ds folder on the root of your SD card, make a new folder named isle.
3. Copy the /Lego and /DATA/disk/LEGO folders from the mounted ISO to the isle folder (you want to merge the two directories). All the game files should be in sd:/3ds/isle/LEGO.

Your SD card should have a tree like this:

File System Tree

3ds
├── isle
│   └── LEGO
│       ├── data
│       │   ├── ACT1INF.DTA
│       │   ├── ACT2INF.DTA
│       │   ├── ACT3INF.DTA
│       │   ├── BLDDINF.DTA
│       │   ├── BLDHINF.DTA
│       │   ├── BLDJINF.DTA
│       │   ├── BLDRINF.DTA
│       │   ├── GMAININF.DTA
│       │   ├── HOSPINF.DTA
│       │   ├── ICUBEINF.DTA
│       │   ├── IELEVINF.DTA
│       │   ├── IISLEINF.DTA
│       │   ├── IMAININF.DTA
│       │   ├── IREGINF.DTA
│       │   ├── OBSTINF.DTA
│       │   ├── PMAININF.DTA
│       │   ├── RACCINF.DTA
│       │   ├── RACJINF.DTA
│       │   ├── testinf.dta
│       │   └── WORLD.WDB
│       └── Scripts
│           ├── Act2
│           │   └── ACT2MAIN.SI
│           ├── Act3
│           │   └── ACT3.SI
│           ├── Build
│           │   ├── COPTER.SI
│           │   ├── DUNECAR.SI
│           │   ├── JETSKI.SI
│           │   └── RACECAR.SI
│           ├── CREDITS.SI
│           ├── Garage
│           │   └── GARAGE.SI
│           ├── Hospital
│           │   └── HOSPITAL.SI
│           ├── Infocntr
│           │   ├── ELEVBOTT.SI
│           │   ├── HISTBOOK.SI
│           │   ├── INFODOOR.SI
│           │   ├── INFOMAIN.SI
│           │   ├── INFOSCOR.SI
│           │   └── REGBOOK.SI
│           ├── INTRO.SI
│           ├── Isle
│           │   ├── ISLE.SI
│           │   ├── JUKEBOX.SI
│           │   └── JUKEBOXW.SI
│           ├── NOCD.SI
│           ├── Police
│           │   └── POLICE.SI
│           ├── Race
│           │   ├── CARRACE.SI
│           │   ├── CARRACER.SI
│           │   ├── JETRACE.SI
│           │   └── JETRACER.SI
│           └── SNDANIM.SI
└── isle.3dsx
14 directories, 47 files

Open "LEGO Island" in the Homebrew Launcher to play the game.

Switch Port

Requirements:

• Device running Atmosphère 1.10.1 and Firmware 21.0.0
• Homebrew Menu launched via Title Override ONLY
• Original LEGO Island game files
  • This guide assumes the original ISO has already been mounted or extracted on a PC

⚠️ IMPORTANT This port DOES NOT WORK when launched via the Album. You MUST launch the Homebrew Menu using Title Override (hold R + any installed game).

Installation:

1. Copy isle.nro to: sd:/switch/
2. Create the following directory: sd:/switch/isle
3. From the mounted or extracted LEGO Island ISO, copy:
   • Lego
   • DATA/disk/LEGO into: sd:/switch/isle (Merge folders when prompted).
4. Final required path: sd:/switch/isle/LEGO

SD Card Layout:

File System Tree

switch
├── isle
│   └── LEGO
│       ├── data
│       │   ├── ACT1INF.DTA
│       │   ├── ACT2INF.DTA
│       │   ├── ACT3INF.DTA
│       │   ├── BLDDINF.DTA
│       │   ├── BLDHINF.DTA
│       │   ├── BLDJINF.DTA
│       │   ├── BLDRINF.DTA
│       │   ├── GMAININF.DTA
│       │   ├── HOSPINF.DTA
│       │   ├── ICUBEINF.DTA
│       │   ├── IELEVINF.DTA
│       │   ├── IISLEINF.DTA
│       │   ├── IMAININF.DTA
│       │   ├── IREGINF.DTA
│       │   ├── OBSTINF.DTA
│       │   ├── PMAININF.DTA
│       │   ├── RACCINF.DTA
│       │   ├── RACJINF.DTA
│       │   ├── testinf.dta
│       │   └── WORLD.WDB
│       └── Scripts
│           ├── Act2
│           │   └── ACT2MAIN.SI
│           ├── Act3
│           │   └── ACT3.SI
│           ├── Build
│           │   ├── COPTER.SI
│           │   ├── DUNECAR.SI
│           │   ├── JETSKI.SI
│           │   └── RACECAR.SI
│           ├── CREDITS.SI
│           ├── Garage
│           │   └── GARAGE.SI
│           ├── Hospital
│           │   └── HOSPITAL.SI
│           ├── Infocntr
│           │   ├── ELEVBOTT.SI
│           │   ├── HISTBOOK.SI
│           │   ├── INFODOOR.SI
│           │   ├── INFOMAIN.SI
│           │   ├── INFOSCOR.SI
│           │   └── REGBOOK.SI
│           ├── INTRO.SI
│           ├── Isle
│           │   ├── ISLE.SI
│           │   ├── JUKEBOX.SI
│           │   └── JUKEBOXW.SI
│           ├── NOCD.SI
│           ├── Police
│           │   └── POLICE.SI
│           ├── Race
│           │   ├── CARRACE.SI
│           │   ├── CARRACER.SI
│           │   ├── JETRACE.SI
│           │   └── JETRACER.SI
│           └── SNDANIM.SI
└── isle.nro
14 directories, 47 files

Running the Game:

1. Hold R
2. Launch any installed game
3. Homebrew Menu will open (Title Override)
4. Select LEGO Island (isle.nro)

Notes:

• Launching via Album will result in a crash or black screen.
• Folder names are case-sensitive
• LEGO directory must be uppercase
• Album applet mode is not supported
• Title Override is required for proper memory allocation

PlayStation Vita/PlayStation TV

Prerequisites:

• Your device must be running the henkaku hack (see vita.hacks.guide)
• VitaShell or MolecularShell file manager
• A PC or file explorer app capable of connecting to USB, or FTP server.
• Game files

Installation:

1. Open VitaShell press the SELECT button for file transfer mode,
2. Download isle-portable.vpk and copy it to anywhere on your memory card.
3. Copy the Lego folder on the original ISO or disc version, to ux0:/data/isledecomp/isle/cd
4. Copy the Disk/LEGO folder on the original ISO or disc version, to ux0:/data/isledecomp/isle/disk
5. Inside VitaShell navigate to where you put isle-portable.vpk, and install it using the confirm button.
6. That's it! Enjoy playing LEGO Island on your PlayStation Vita!

-> You can change these directories in the configuration application, which is accessible via the "Configure" LiveItem on the LiveArea Screen!

Xbox One/Series X|S

Prerequisites:

1. Xbox with Dev mode enabled, and Remote Access enabled (Guide, Proceed through "ACCESSING THE XBOX DEVICE PORTAL")
2. A PC that can connect to Xbox using SMB(like Windows or macOS, for Linux install samba) and is connected to the same network as Xbox
3. Game files

Installation:

1. Open Xbox Device Portal on your browser(Check bottom-right panel on your Xbox for address).

• It might warn you about unencrypted connection, ignore it.

2. On "My games & apps" section, press "Add" button.

3. Drag & Drop(or choose) isle_0.1.0.0_x64.msix file and click "Next".

4. When it asks for dependencies, drag & drop(or choose) Microsoft.VCLibs.x64.14.00.appx file located in Dependencies/x64/ and click "Start".

5. Navigate to "File Explorer" menu on the left.

6. Click "Browse" button on the right.

7. Connect to Xbox via SMB. On Windows follow the guide on the screen, on macOS use Finder(Cmd + K to open connect dialog, type smb://<YOUR_XBOX_IP_HERE>/DevelopmentFiles and for credentials follow the guide)

8. Make a new folder called isle in root.

9. Inside the folder, copy the /Lego and /DATA/disk/LEGO folders from the ISO. (you want to merge the two directories).

10. Congratulations! You're ready to play LEGO Island on your Xbox! You don't need to uninstall the game when update, just proceed through number 4 and you're good to go!

Config file can be accessed in LocalAppData/LEGO Island/LocalState/isledecomp/isle/isle.ini.

iOS

Pre-built

Prerequisites

Prerequisites:

1. An iOS/iPadOS Device
2. AltStore, Sideloadly or other kind of sideload program
3. Game files

Installation:

1. Sideload the app and open once.
2. Open Files app. Go to Browse -> On My iPhone -> Isle Portable. Here you can see the config and folder isle.
3. Go to isle. Inside the folder, copy the /Lego and /DATA/disk/LEGO folders from the ISO. (you want to merge the two directories).
4. That's it! Enjoy playing LEGO Island on your iDevice! You don't need to reinstall assets when update, but you do need to remove and regenerate(or edit) isle.ini.

Build from source

Prerequisites

• A macOS system with XCode installed.
• iOS platform support on XCode.

The process for building isle-portable is much like that of a regular CMake project.

git clone --recursive https://github.com/isledecomp/isle-portable.git
cd isle-portable
cmake -S . -B build -G "Xcode" -DCMAKE_SYSTEM_NAME=iOS -DCMAKE_BUILD_TYPE=Release -DISLE_USE_DX5=false -DISLE_BUILD_CONFIG=false -DISLE_BUILD_ASSETS=false -DENABLE_CLANG_TIDY=false -DISLE_WERROR=true -DISLE_DEBUG=OFF -Werror=dev
cmake --build build --verbose --config Release

After the build process is complete, follow along from step 1 in the instructions above.

Android

Prerequisites:

1. An Android Device
2. A PC or file explorer app capable of writing to Internal Storage/Android/data (Android 11 or higher require specific file explorer apps, while lower Android versions can use any)
3. Game files

Installation:

1. Download and install app-debug.apk and open once.
2. Go to Internal Storage/Android/data/org.legoisland.isle/files either in the file explorer app or on PC
3. Copy the Lego and DATA/disk/LEGO folders from the ISO (you want to merge the two directories).
4. That's it! Enjoy playing LEGO Island on your Android device!