Skip to content
MarcoSpengler edited this page Sep 1, 2025 · 14 revisions

Desktop (Windows, Mac, Linux)

Pre-built

Prerequisites

  • A copy of the game's files (likely LEGO_ISLANDI.ISO)
  • A compatible desktop platform, one of:
  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.

  1. Device has a working touch screen
  2. 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.

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.

How to find Xbox Device Portal address

  1. On "My games & apps" section, press "Add" button.
  1. Drag & Drop(or choose) isle_0.1.0.0_x64.msix file and click "Next".
  1. When it asks for dependencies, drag & drop(or choose) Microsoft.VCLibs.x64.14.00.appx file located in Dependencies/x64/ and click "Start".
  1. Navigate to "File Explorer" menu on the left.
  1. Click "Browse" button on the right.

  1. 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)
  1. Make a new folder called isle in root.
  1. Inside the folder, copy the /Lego and /DATA/disk/LEGO folders from the ISO. (you want to merge the two directories).
  1. 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

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.
Clone this wiki locally