Go to file
foxtacles 7b114bbe59
Add multiplayer extension (#789)
* Add multiplayer extension

* Fix animation system to work when host is outside ISLE world

- Move TickHostSessions outside m_inIsleWorld gate so the host can
  coordinate animations from any world
- Load animation catalog early in HandleCreate so the host can
  coordinate before entering the ISLE world
- Use network-reported positions for remote player location detection
  instead of requiring spawned ROIs
- Always erase sessions at launch — the host's job ends when the
  animation starts; clients play and complete independently
- Replace BroadcastAnimComplete with locally-driven completion
  callbacks: host generates eventId at launch, clients cache
  completion JSON at start time, fire it when ScenePlayer finishes
- Make StopAnimation only do local cleanup (stop playback, cancel
  own interest, reset coordinator) without destroying the session
  host, so other players' sessions survive world transitions
- Broadcast state=0 in ResetAnimationState for full teardown paths
  (shutdown, reconnect, host migration) so clients aren't left with
  stale session state

* Fix use-after-free crash in ScenePlayer when remote player disconnects mid-animation

When a remote player's ROI is destroyed (disconnect, timeout, or respawn),
notify all active ScenePlayer instances to null out dangling references
before the ROI is freed. The animation engine already handles null ROI map
entries gracefully, so playback continues for remaining participants.

* Fix crash when performer's child ROIs are left dangling in ScenePlayer

NotifyROIDestroyed now walks the parent chain to also invalidate child
ROIs of the destroyed performer (head, limbs, etc.) that were placed
into the roiMap by BuildROIMap. The ancestor walk happens once; all
other fields are cleaned with simple pointer equality.

* Allow spectator to play click animation during scene playback

* Make PTATCAM track spectator ROI instead of camera in ScenePlayer

* Only regenerate emscripten version files when git state changes

Replace add_custom_target(ALL) with add_custom_command(OUTPUT) so the
version script only runs when .git/HEAD or the current branch ref file
changes, instead of on every build.

* Fix ROI name collision causing dangling pointers in NPC locomotion roiMaps

When ScenePlayer created cloned NPC ROIs for cooperative animations, it
renamed them to match the original character name and added them to the
ViewManager. This created a name collision: two ROIs with the same name.
The original game's AppendROIToScene searches by name and stops at the
first match, so if a locomotion BuildROIMap ran while the clone existed,
it could capture pointers to the clone's child ROIs. When the clone was
later destroyed (CleanupProps), those roiMap entries became dangling
pointers, crashing in AnimateWithTransform at roi.h:151 (SetVisibility).

Fix: use the alias mechanism (already supported by AnimUtils::BuildROIMap)
instead of renaming clones. Also unify all ROI name generation behind a
shared counter to prevent character manager key collisions.
2026-04-05 17:13:15 +02:00
.github/workflows Add FreeBSD CI job (#787) 2026-04-03 23:26:58 +00:00
3rdparty Add multiplayer extension (#789) 2026-04-05 17:13:15 +02:00
android-project Fix android build for legacy devices (#702) 2025-09-01 17:08:02 +00:00
assets Add new widescreen backgrounds (#703) 2025-09-01 17:52:02 +02:00
CMake Add multiplayer extension (#789) 2026-04-05 17:13:15 +02:00
CONFIG implement WASD control option (#740) 2025-12-12 21:36:08 -07:00
docker Add multiplayer extension (#789) 2026-04-05 17:13:15 +02:00
docs Add missing character name (#1751) 2026-03-23 23:42:05 +01:00
extensions Add multiplayer extension (#789) 2026-04-05 17:13:15 +02:00
ISLE Add multiplayer extension (#789) 2026-04-05 17:13:15 +02:00
LEGO1 Add multiplayer extension (#789) 2026-04-05 17:13:15 +02:00
miniwin Add multiplayer extension (#789) 2026-04-05 17:13:15 +02:00
packaging Fix AppRun script for AppImage execution (#779) 2026-03-01 19:12:55 +01:00
tools Add multiplayer extension (#789) 2026-04-05 17:13:15 +02: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 hdmusic.si asset pack, extend SiLoader with Replace directive (#671) 2025-08-16 21:21:39 +02: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 multiplayer extension (#789) 2026-04-05 17:13:15 +02: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 Nintendo Switch support to README [skip ci] 2025-11-15 23:51:56 +01: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 CI
Linux CI
macOS CI
Web CI
Nintendo 3DS CI
Xbox One CI
iOS CI
Android CI
Playstation Vita CI
Nintendo Switch 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.

As it stands, builds provided in the Releases tab are mainly for developers; as such, they may not work properly for all end-users. Work is currently ongoing to create workable release builds ready for gameplay and general use by end-users. If you are technically inclined, you may find it easiest to compile the project yourself to get it running at this current point in time.

Installation instructions for some ports can be found in our Wiki.

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.