Hey everyone!
Following up on my previous WIP showcase post, I’m thrilled to announce that LookingMetal — the native Apple Metal port of American McGee’s Alice (2000) for iOS and Apple Silicon macOS — is now fully playable from start to finish with rock-solid, locked 120 FPS!
No UTM, no x86 emulation, no slow translation layers, and no JIT required — this is a pure native 64-bit ARM (aarch64) port running directly on the Apple Metal 3 hardware pipeline.
🚀 What's New & Technical Achievements:
⚡️ Pure Apple Metal 3 Pipeline with Locked 120 FPS:
Switched the entire render loop to hardware-paced CADisplayLink (paused: NO, enableSetNeedsDisplay: NO) synchronized directly to the screen's VSync.
Asynchronous Triple-Buffering (AliceFramePacing): Eliminated sequential lockstep stalls (waitUntilCompleted removed on iOS). The CPU encodes commands while the GPU renders in parallel, delivering a completely flat, jitter-free 120 FPS line in the Metal Performance HUD!
Adaptive Retina Scaling: On ultra-dense 3x OLED screens (iPhone 16 Pro Max 2868x1320), the engine dynamically scales to 2.0x (1912x880, >300 PPI). This slashes GPU fillrate load by >55%, dropping GPU frame time to a breezy ~4.5ms and keeping the phone cool.
🎮 Ergonomic Adaptive Touch Controls:
Custom on-screen gamepad physically scaled to human thumb targets (~15–16 mm).
Floating Analog Stick (L): Dynamic thumb centering with analog speed (gentle push to sneak/walk, full tilt to sprint).
Right-Screen Look Swipe: Fluid 360° camera navigation across the entire right half of the display.
Physical Controller Support: Full plug-and-play support for DualSense, Xbox, Switch Pro, Backbone, and Razer Kishi via Apple's GameController.framework.
📱 Native Frosted Glass UIKit Interface (AliceNativeMenu):
Modern iOS design with UIBlurEffect and haptic feedback.
Quick Save, Load Game with slot metadata/dates, Chapter Select, and Difficulty selection (Easy / Medium / Nightmare).
Real-time audio sliders and Look Sensitivity / Invert Y toggles.
On-the-fly Apple Metal 3 Performance HUD overlay toggle.
📄 Built-in File Logging & Crash Tracer:
Auto-logs engine events and output to Documents/LookingMetal.log.
Integrated POSIX signal handler and Rust panic hook recording full callstack backtraces to LookingMetal_crash.log.
In-game log viewer in the Settings menu with a one-tap "Copy to Clipboard" button (accessible via the iOS Files app).
🛡️ Sideloading & LiveContainer 100% Ready:
Runs flawlessly in LiveContainer, SideStore, TrollStore, and AltStore.
Automatic Mach-O SDK header patch (0x00100500, iOS 16.5) built into the packaging script to prevent dyld version rejections.
Zero stack overflows (all heavy world structures are heap-allocated).
📦 Source Code & How to Play:
GitHub Repository: github.com/cloverfield11/LookingMetal
Single-Branch Model: Everything is unified on main.
Build Instructions:
Clone the repo and drop your original Alice .pk3 files (pak0 through pak5, plus optional Russian voice pak6) into base/.
Run ./build.sh ios on your Mac.
Install the generated dist/Alice_LookingMetal_iOS.ipa via LiveContainer, SideStore, or TrollStore.
Huge thanks to the LookingGlass project and the iOS porting community for the inspiration. Hope you all enjoy re-visiting Wonderland in buttery-smooth 120 FPS! Feedback and PRs are welcome! 🎩🐇🔪