How whitemsf/angry-birds-arm64 works
This repository reconstructs Angry Birds 1.4.2 as an ARM64 Android game runtime, preserving its original Lua gameplay and locally supplied assets while replacing the original ARMv7 native services. The principal flow is launching the game on Android, loading game logic and data, running gameplay through physics and native-facing systems, and presenting the result. The Windows Builder Preview is a separate user-facing route from a verified local APK to an ARM64 APK. The runtime source is largely unsampled, so capability nodes use the documented Stage24 entry-point path; edges are limited to relationships stated in the README or shown by excerpts.
Main entry points: stage24_live_surface.cpp Stage24 Runtime · windows_builder.py Windows Builder · build.py Build Orchestrator · presentation_geometry.cpp Presentation Geometry
Components 19
Android Runtime
- Stage24 Runtime
stage24_live_surface.cpp - Original Lua Logic
stage24_live_surface.cpp - Local Game Data
Gameplay Systems
- Input
stage24_live_surface.cpp - Physics Bridge
stage24_live_surface.cpp - Progression
stage24_live_surface.cpp - Menus
stage24_live_surface.cpp
Presentation
- Rendering
stage24_live_surface.cpp - Presentation Geometry
src/runtime/presentation/presentation_geometry.cpp
Native Services
- Audio
stage24_live_surface.cpp - Persistence
stage24_live_surface.cpp - Android Lifecycle
stage24_live_surface.cpp
Windows Builder
- Windows Builder
tools/windows_builder.py - APK Validation
tools/windows_builder_core.py - Build Orchestrator
build.py
Other components
- Game Player
- Android Device
- APK Provider
- ARM64 APK
Connections 17
- Game Player → Android Device: launches
README.md - Android Device → Stage24 Runtime: runs
README.md - Stage24 Runtime → Original Lua Logic: runs
README.md - Original Lua Logic → Local Game Data: uses
README.md - Stage24 Runtime → Input: reconstructs
README.md - Stage24 Runtime → Physics Bridge: reconstructs
README.md - Stage24 Runtime → Progression: reconstructs
README.md - Stage24 Runtime → Menus: reconstructs
README.md - Stage24 Runtime → Rendering: reconstructs
README.md - Rendering → Presentation Geometry: resolves geometry
src/runtime/presentation/presentation_geometry.cpp - Stage24 Runtime → Audio: reconstructs
README.md - Stage24 Runtime → Persistence: reconstructs
README.md - Stage24 Runtime → Android Lifecycle: reconstructs
README.md - APK Provider → Windows Builder: supplies APK
README.md - Windows Builder → APK Validation: validates APK
tools/windows_builder.py - Windows Builder → Build Orchestrator: invokes build
tools/windows_builder.py - Build Orchestrator → ARM64 APK: produces package
README.md