How timoheimonen/amiga-lemmings-editor works
This repository patches the original Amiga Lemmings game with an in-game custom-level editor. The principal workflow is: select or create a custom level, edit and save it, then play it from the one- or two-player list. Floppy level-disk management and WHDLoad .lvl storage are alternate persistence paths; savedisk.py also supports level exchange outside the game. Assembly connections below reflect README-documented behavior; the assembly source itself was not sampled, so internal call details are not asserted.
Main entry points: editor.s Level editor · levels.s Custom level lists · title.s Title and menu · disk_io.s Floppy disk I/O
Components 19
In-game experience
- Title and menu
src/title.s - Custom level lists
src/levels.s - Lemmings gameplay
src/menu.s
Level editing
- Level editor
src/editor.s - Terrain editing
src/editor.s - Steel editing
src/steel.s - Object editing
src/objects.s - Parameter editing
src/params.s - Undo and redo
src/undo.s
Level storage
- Save level
src/level_save.s - Delete level
src/level_delete.s - Floppy disk I/O
src/disk_io.s - Level disk codec
src/disk_codec.s - Level disk
- Disk and level exchange
savedisk.py
Patch and install
- Game disk patcher
patch.py - WHDLoad runtime
whdload/src/slave.s - WHDLoad level files
whdload/src/disk_file.s
Other components
- Amiga player
Connections 22
- Amiga player → Title and menu: starts game
README.md - Title and menu → Custom level lists: opens CUSTOM
README.md - Title and menu → Level editor: creates level
README.md - Custom level lists → Lemmings gameplay: plays selection
README.md - Custom level lists → Level editor: opens for editing
README.md - Custom level lists → Delete level: deletes selection
README.md - Level editor → Terrain editing: edits terrain
README.md - Level editor → Steel editing: edits steel
README.md - Level editor → Object editing: edits objects
README.md - Level editor → Parameter editing: edits parameters
README.md - Level editor → Undo and redo: undoes changes
README.md - Level editor → Save level: saves level
README.md - Save level → Floppy disk I/O: writes level
README.md - Floppy disk I/O → Level disk codec: encodes disk data
README.md - Floppy disk I/O → Level disk: reads and writes
README.md - Delete level → Floppy disk I/O: removes level
README.md - Disk and level exchange → Level disk: manages levels
README.md - Disk and level exchange → Amiga player: exchanges .lvl files
README.md - Game disk patcher → Title and menu: patches game
README.md - Amiga player → WHDLoad runtime: starts install
- Save level → WHDLoad level files: writes .lvl file
README.md - Delete level → WHDLoad level files: deletes .lvl file
README.md