Gizmoduck NX Modern v1.1.8

Modernized Nintendo Switch native wrapper and loader for Gizmoduck (v1.1.8), running the ARM64 Android engine (Godot 4.7.2) natively under Horizon OS with hardware OpenGL ES 3.0 acceleration.

---

📦 Installation Instructions

Asset Requirement: This release contains ONLY the Nintendo Switch homebrew wrapper. It does NOT contain any original game assets or Android APKs. You must supply your own copy of Gizmoduck-1.1.8-android.apk (available from the developer on itch.io).

Option A: Automatic On-Console Installation (Easiest)

1. Download Gizmoduck-NX-Modern-v1.1.8.zip (or gizmoduck_nx.nro) and copy switch/gizmoduck/gizmoduck_nx.nro to your SD card at:

   sdmc:/switch/gizmoduck/gizmoduck_nx.nro
   

2. Copy your legally obtained Gizmoduck-1.1.8-android.apk into the same directory:

   sdmc:/switch/gizmoduck/Gizmoduck-1.1.8-android.apk
   

3. Launch gizmoduck_nx from the Homebrew Menu (Title Override required by holding R while opening any installed game). The wrapper will automatically unpack the libraries and game assets on first boot with an on-screen progress bar.

Option B: PC Staging

If staging assets on PC using scripts/extract_apk.sh, extract the APK and copy the resulting files:

sdmc:/switch/gizmoduck/
├── gizmoduck_nx.nro
├── libgodot_android.so
├── libc++_shared.so
└── assets/
    ├── project.binary
    ├── assets.sparsepck
    └── ...

---

🎮 Controls

• Left Stick / D-Pad: Move / Aim / Direction
• A Button: Jump / Confirm / Select
• B Button: Shoot / Cancel / Back
• X / Y Buttons: Special Weapons / Abilities
• L / R Shoulders: Cycle Weapons
• ZL / ZR Triggers: Secondary Fire / Alt Action
• Plus (+): Pause Menu
• Minus (-): Options / Select
• Touchscreen: Menus and UI touch interaction

---

⚡ Boot & Performance Optimizations in v1.1.8

• ELF Symbol Resolution Cache: Eliminated over 10,000 redundant symbol string searches during module loading, drastically reducing boot freeze.
• Large-Block Buffered I/O: Chunked 4MB buffered reading for the 71MB engine binary, significantly accelerating SD card reading.
• Persistent Shader Cache: Automated directory setup for Mesa disk cache (save/cache/mesa) and skipped redundant file stat passes during startup.
• Smart Staging Check: Skips redundant APK unpacking on boot if game assets are already present on the SD card.

---

❤️ Enjoying the port?
If this project helped you out, consider buying me a coffee on Ko-fi or supporting on Patreon to support future updates!