ModLoader64 Flatpak Packaging

This directory contains the files required to build, test, and distribute ModLoader64 as a Flathub-compliant Flatpak.

Structure

• com.hylianmodding.ModLoader64.yml: Main Flatpak builder manifest.
• com.hylianmodding.ModLoader64.desktop: XDG Desktop entry.
• com.hylianmodding.ModLoader64.metainfo.xml: AppStream metadata file.
• start-modloader64: Launcher wrapper script handling template initialization and zypak Electron execution.
• node-sources/: Offline npm/yarn dependency manifests generated via flatpak-node-generator.

Generating Offline Node Sources

Flathub builds run with network access disabled during compilation. All npm and yarn dependencies must be vendored offline using flatpak-node-generator:

# Generate ModLoader64 runtime offline sources (yarn.lock)
flatpak-node-generator yarn ../ModLoader64/yarn.lock -o node-sources/modloader64-core.json

# Generate GUI offline sources (package-lock.json)
flatpak-node-generator npm ../ModLoader64-GUI/package-lock.json -o node-sources/modloader64-gui.json

Emulator, Game Cores, and Mods

This Flatpak bundles the single emulator used by ModLoader64: Mupen64Plus, including the native ml64_emu_addon.node binding and required Mupen64Plus plugins. Game cores and community mods are separate ModLoader64 content; they are not emulator cores and can be added by future GUI/update logic or by manual testing.

Building and Installing Locally

# Using flatpak-builder directly or via the Flatpak Builder flatpak
flatpak run org.flatpak.Builder --user --install --force-clean build-dir com.hylianmodding.ModLoader64.yml