A work-in-progress modernization of LEGO Island (1997)
  • Python 79.4%
  • C++ 17.8%
  • C 1.9%
  • CMake 0.4%
  • HTML 0.3%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
foxtacles dc55ff7352
Some checks are pending
CI / clang-format (push) Waiting to run
CI / DOS (push) Waiting to run
CI / Vita (push) Waiting to run
CI / Xbox One (push) Waiting to run
CI / Nintendo 3DS (push) Waiting to run
CI / Nintendo Switch (push) Waiting to run
CI / Emscripten (push) Waiting to run
CI / MSVC (arm64) (push) Waiting to run
CI / MSVC (x86) (push) Waiting to run
CI / MSVC (x64) (push) Waiting to run
CI / macOS (Intel) (push) Waiting to run
CI / macOS (push) Waiting to run
CI / iOS (push) Waiting to run
CI / Android (push) Waiting to run
CI / msys2 mingw64 (push) Waiting to run
CI / Linux (push) Waiting to run
CI / FreeBSD (push) Waiting to run
CI / Flatpak (aarch64) (push) Waiting to run
CI / Flatpak (x86_64) (push) Waiting to run
CI / C++ (push) Waiting to run
CI / Release (push) Blocked by required conditions
Docker / Publish web port (push) Waiting to run
Pages / Deploy guided installer (push) Waiting to run
Fix the WasmFS fetch-backend language race and stop the rabbits composite from re-streaming (#890)
* Fix startup race in the WasmFS fetch backend language lookup

The emscripten patch read the language from isle.ini in OPFS and only
assigned wasmFS$language, an undeclared implicit global, after that
async read completed. The fetch backend was already registered by then,
so any file read issued before the OPFS read finished threw a
ReferenceError in getFileRange and failed with EBADF. Extra SI files
loaded at startup (widescreen, rabbits) were the first reads whenever HD
textures were off, so they failed intermittently.

Declare the variable, store the pending language promise in it during
backend creation, and await it when building the request headers. Every
request, including the first, now carries the language from isle.ini,
with 'en' as the fallback.

* Stop the rabbits composite from re-streaming forever

The rabbits composite carried the LoopStream flag (c_bit3) while its
looping animation child has an infinite duration. On the composite's end
chunk the disk streamer therefore rewound to the object's offset instead
of ending the stream, re-reading and re-parsing the object 55-90 times
per second for as long as the Isle world was enabled.

The animation loops in memory in LegoLoopingAnimPresenter::PutFrame, so
the flag only controlled the streamer. Drop it; the animation still loops
and the stream is read once.
2026-09-06 16:28:47 +00:00
.github Add a guided installer wizard, deployed to GitHub Pages (#885) 2026-09-05 17:59:22 +00:00
3rdparty Add HD audio asset pack (#816) 2026-07-25 10:51:11 -07:00
android-project Add a guided installer wizard, deployed to GitHub Pages (#885) 2026-09-05 17:59:22 +00:00
assets Fix the WasmFS fetch-backend language race and stop the rabbits composite from re-streaming (#890) 2026-09-06 16:28:47 +00:00
CMake DOS port (#799) 2026-05-04 01:25:27 +02:00
CONFIG Add a guided installer wizard, deployed to GitHub Pages (#885) 2026-09-05 17:59:22 +00:00
docker ci: suffix debug-build artifacts to avoid release filename collision (#808) 2026-05-17 21:52:22 +00:00
docs Add missing character name (#1751) 2026-03-23 23:42:05 +01:00
extensions Fix lifetime and NULL-dereference crashes surfaced by isle.pizza crash reports (#884) 2026-09-05 02:37:28 +00:00
installer Installer: Start Over button, Discussions link, and a viewport probe (#887) 2026-09-05 19:39:53 +00:00
ISLE Fix the WasmFS fetch-backend language race and stop the rabbits composite from re-streaming (#890) 2026-09-06 16:28:47 +00:00
LEGO1 Fix lifetime and NULL-dereference crashes surfaced by isle.pizza crash reports (#884) 2026-09-05 02:37:28 +00:00
miniwin Defer GPU buffer frees on 3DS until the in-flight frame completes (#883) 2026-08-31 11:45:06 -07:00
packaging Add a guided installer wizard, deployed to GitHub Pages (#885) 2026-09-05 17:59:22 +00:00
tools Merge remote-tracking branch 'isle/master' 2026-05-15 15:21:08 -07:00
util Merge remote-tracking branch 'isle/master' 2026-01-07 16:39:54 -07:00
.clang-format User clang-format InsertBraces instead of clang-tidy (#1059) 2024-07-04 23:35:49 +02:00
.clang-tidy Add clang-tidy readability-redundant-inline-specifier (#1060) 2024-07-05 01:06:32 +02:00
.editorconfig Flatpak Build Support (#407) 2025-06-29 19:04:08 +00:00
.gitattributes Add HD audio asset pack (#816) 2026-07-25 10:51:11 -07:00
.gitignore Add third person camera extension (#786) 2026-03-31 01:00:07 +02:00
.gitmodules Remove libweaver git submodule (#737) 2025-11-24 20:50:16 +00:00
.lfsconfig Add hdmusic.si asset pack, extend SiLoader with Replace directive (#671) 2025-08-16 21:21:39 +02:00
CMakeLists.txt Add a guided installer wizard, deployed to GitHub Pages (#885) 2026-09-05 17:59:22 +00:00
CONTRIBUTING.md Make Ghidra server instructions clearer (#1727) 2026-01-24 17:28:50 -08:00
LICENSE Create LICENSE (#1497) 2025-06-24 18:00:23 +02:00
pyproject.toml Python Linting and Code Formatting (#298) 2023-11-25 13:27:42 -05:00
README.md Add a guided installer wizard, deployed to GitHub Pages (#885) 2026-09-05 17:59:22 +00:00
settings.gradle Android port (#656) 2025-08-15 15:12:35 +00:00

LEGO Island, portable

Development Vlog | Contributing | Matrix | Forums | Patreon

This initiative is a portable version of LEGO Island (Version 1.1, English) based on the decompilation project. Our primary goal is to transform the codebase to achieve platform independence, thereby enhancing compatibility across various systems while preserving the original game's experience as faithfully as possible.

Please note: this project is primarily dedicated to achieving platform independence without altering the core gameplay or rewriting code for improvement's sake. While those are worthwhile objectives, they are not within the scope of this project. isle-portable offers support for light modding using extensions.

Status

Platform Status
Windows (x86, x64, arm64) CI
MacOS (arm64, x64) CI
Linux (x64, arm64) CI
FreeBSD (x64) CI
DOS (x86) CI
Web CI
iOS CI
Android CI
Xbox One CI
Playstation Vita CI
Nintendo Switch CI
Nintendo 3DS CI

We are actively working to support more platforms. If you have experience with a particular platform, we encourage you to contribute to isle-portable. You can find a list of ongoing efforts in our Wiki.

Usage

An existing copy of LEGO Island is required to use this project.

The guided installer walks you through the installation on every supported platform, step by step, using the builds from the Releases tab. These are continuous builds of the latest master, so an occasional regression is possible; if something does not work for you, please open an issue. Developers can also build the project from source, see below.

The installer's source lives in installer/ and is deployed to GitHub Pages from master.

Library substitutions

To achieve our goal of platform independence, we need to replace any Windows-only libraries with platform-independent alternatives. This ensures that our codebase remains versatile and compatible across various systems. The following table serves as an overview of major libraries / subsystems and their chosen replacements. For any significant changes or additions, it's recommended to discuss them with the team on the Matrix chat first to ensure consistency and alignment with our project's objectives.

Library/subsystem Substitution Status
Window, Events SDL3 Remarks
Windows Registry (Configuration) libiniparser Remarks
Filesystem SDL3 Remarks
Threads, Mutexes (Synchronization) SDL3 Remarks
Keyboard/Mouse, DirectInput (Input) SDL3 Remarks
Joystick/Gamepad, DirectInput (Input) SDL3 Remarks
WinMM, DirectSound (Audio) SDL3, miniaudio Remarks
DirectDraw (2D video) SDL3 Remarks
Smacker libsmacker Remarks
Direct3D (3D video) SDL3 (Vulkan, Metal, D3D12), D3D9, OpenGL 1.1, OpenGL ES 2.0, OpenGL ES 3.0, Software Remarks
Direct3D Retained Mode Custom re-implementation Remarks
SmartHeap Default memory allocator - -

Building

This project uses the CMake build system, which allows for a high degree of versatility regarding compilers and development environments. Please refer to the GitHub action for guidance.

Contributing

If you're interested in helping or contributing to this project, check out the CONTRIBUTING page.