mirror of https://github.com/isledecomp/isle.pizza.git synced 2026-02-28 13:57:38 +00:00

Custom frontend for the Emscripten port of isle-portable

Go to file

Christian Semmler 3116ac1c7f Some checks failed Build / build (push) Has been cancelled Details Buildings editor (#26 ) * Building editor Add a Buildings tab to the Save Game Editor that lets users browse all 16 buildings, preview them in 3D, and customize their properties (sound, move, mood, variant) by clicking, matching the original game behavior per character. - Parse 16 buildings + nextVariant from save files instead of skipping - Add serializer methods to patch building fields in-place - Create BuildingRenderer (extends AnimatedRenderer) for 3D preview with click animations from SNDANIM.SI - Create BuildingEditor component with per-character click behavior (Pepper: variants, Mama: sounds, Papa: moves, Laura: moods) - Extract 18 building animations and 2 building sounds into asset bundle - Fix centerAndScaleModel to account for scale in position offset * Add Building Editor to February 2026 changelog * DRY up renderer hierarchy: extract shared logic into base classes Move duplicated animation tree utilities (findAnimatedNode, evaluateNodeChain, findNodePath, evaluateLocalTransform), click animation (queueClickAnimation, playQueuedAnimation, buildRotationTracks), and raycast hit testing (getClickedMesh) from PlantRenderer and BuildingRenderer into AnimatedRenderer. Add loadTextures() and createMeshMaterial() helpers to BaseRenderer, replacing identical texture-loading loops and material-creation code across all four renderers. PlantRenderer: 279 → 73 lines (-74%) BuildingRenderer: 245 → 57 lines (-77%)		2026-02-14 19:35:52 +01:00
.github/workflows	Skip service worker in dev mode and copy isle.js/isle.wasm on build	2026-01-11 20:59:55 -07:00
public	Actor editor (#24 )	2026-02-14 02:29:55 +01:00
scripts	Buildings editor (#26 )	2026-02-14 19:35:52 +01:00
src	Buildings editor (#26 )	2026-02-14 19:35:52 +01:00
src-sw	Migrate frontend to Svelte 5	2026-01-11 19:10:16 -07:00
.gitignore	Actor editor (#24 )	2026-02-14 02:29:55 +01:00
index.html	Improve Lighthouse LCP and accessibility scores (#23 )	2026-02-08 00:43:07 +01:00
LICENSE	Initial commit	2025-06-13 00:30:51 +02:00
package-lock.json	Add dynamic tooltip positioning using Floating UI (#18 )	2026-02-03 02:00:24 +01:00
package.json	Actor editor (#24 )	2026-02-14 02:29:55 +01:00
README.md	Actor editor (#24 )	2026-02-14 02:29:55 +01:00
svelte.config.js	Migrate frontend to Svelte 5	2026-01-11 19:10:16 -07:00
vite.config.js	Improve development mode experience	2026-01-11 21:11:32 -07:00
workbox-config.cjs	Actor editor (#24 )	2026-02-14 02:29:55 +01:00

README.md

isle.pizza Frontend

A custom web frontend for the Emscripten port of isle-portable, allowing LEGO Island to run directly in modern web browsers.

Requirements

Node.js

Quick Start

Clone the repository:

git clone https://github.com/isledecomp/isle.pizza.git
cd isle.pizza

Install dependencies:
```
npm install
```
Obtain the game files (isle.js and isle.wasm) by building the Emscripten version of isle-portable, then copy them to the project root.
Set up the LEGO Island game assets:
```
npm run prepare:assets
```
This will prompt you for the path to your LEGO Island installation or mounted ISO and create the necessary symlinks. You can also provide the path directly:
```
npm run prepare:assets -- -p /path/to/your/LEGO
```
Generate the save editor asset bundle (requires game assets from step 4):
```
npm run generate:save-editor-assets
```
This extracts animations, sounds, textures, and character icons from the game files into save-editor.bin, used by the save editor's 3D previews.
Start the development server:
```
npm run dev
```
Open the URL shown in the terminal (usually http://localhost:5173).

Scripts

Command	Description
`npm run prepare:assets`	Set up LEGO Island game assets via symlinks
`npm run generate:save-editor-assets`	Extract save editor assets (animations, sounds, textures, icons) into `save-editor.bin`
`npm run dev`	Start development server with hot reload
`npm run build`	Build for production (outputs to `dist/`)
`npm run preview`	Preview the production build locally

Project Structure

isle.pizza/
├── src/
│   ├── App.svelte         # Main application component
│   ├── app.css            # Global styles
│   ├── stores.js          # Svelte stores for state management
│   ├── core/
│   │   ├── formats/       # Binary file parsers/serializers (WDB, save games, animations, textures)
│   │   ├── rendering/     # Three.js renderers (BaseRenderer, VehiclePartRenderer, ActorRenderer, etc.)
│   │   ├── savegame/      # Save game constants, actor data, color tables
│   │   └── ...            # Audio, OPFS, service worker, asset loading
│   └── lib/               # UI components and pages (save editor, configure, etc.)
├── public/
│   └── images/            # UI images (menu buttons, tab icons)
├── scripts/               # Build and asset generation scripts
├── src-sw/                # Service worker source
├── index.html             # HTML entry point
├── isle.js                # Emscripten JS (not in repo, build from isle-portable)
├── isle.wasm              # Emscripten WASM (not in repo, build from isle-portable)
├── save-editor.bin        # Packed save editor assets: animations, sounds, textures, icons (not in repo, generated)
└── LEGO/                  # Game data directory (not in repo)

Building the Game Files

The isle.js and isle.wasm files are not included in this repository. To obtain them:

Follow the isle-portable build instructions for the Emscripten target
Copy the resulting isle.js and isle.wasm to this project's root directory

Alternatively, a Docker image that bundles the runtime with this frontend is available.

Tech Stack

Svelte 5 - UI framework
Three.js - 3D rendering for save editor previews
Vite - Build tool and dev server
Workbox - Service worker and offline support

License

See LICENSE for details.