# npcx42/pojavlauncher_ios_crack architecture

> Architecture diagram of the GitHub repository npcx42/pojavlauncher_ios_crack, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/npcx42/pojavlauncher_ios_crack
- Repository: https://github.com/npcx42/pojavlauncher_ios_crack

## Overview

##### Project Type and Purpose
- This is a full‑stack, cross‑language application: a Java‑based Minecraft launcher ported to run on iOS/iPadOS.
- It embeds a Java Virtual Machine (via Caciocavallo), executes JavaApp code (LWJGL, Boardwalk fork), bridges into native Objective‑C/Swift UI, graphics and system APIs, and handles networking, authentication, mod installs, JIT hacks, and resource management.

##### Top‑Level Architectural Components
a. Java Layer (“JavaApp” directory)
- Java core launcher: version listing, asset management, game launch logic
- LWJGL + GLFW bindings for cross‑platform graphics/input
- Third‑party Java libraries: Caciocavallo VM adapter, Gson, utilities.
b. Native Layer (“Natives” directory)
- JNI/JNA agent (patchjna_agent): bootstrap Java VM on iOS, apply JIT bypass
- Graphics bridges: egl_bridge, GL4ES, Mesa, MoltenVK, MetalANGLE
- Input bridges: ControllerInput, KeyboardInput, GyroInput
- UIKit UI controllers: view controllers for profiles, download progress, settings, custom controls
- Installer modules: Fabric, Forge, Modpack APIs (CurseForge, Modrinth REST)
- Authentication: LocalAuthenticator, MicrosoftAuthenticator, JNI account binding
- File management: UnzipKit, NRFileManager abstractions
- Context bridges: ctxbridges for OpenGL/OSMesa interop
c. OS Frameworks & Resources
- iOS frameworks: UIKit, Foundation, Metal, CoreGraphics, CoreFoundation
- Bundled frameworks & dylibs under resources/Frameworks (libEGL, libGLESv2, MoltenVK, etc.)

##### Interactions & Data Flows
- On startup, Objective‑C main_hook → PatchJNAAgent initializes JVM (Caciocavallo) → loads Java classes from JavaApp.
- Java code invokes native graphics/input routines via JNI:
JavaApp → PojavClassLoader → native LWJGL/GLFW → egl_bridge → underlying Mesa/MetalANGLE → GPU.
- UI event flows: UIKit ViewControllers (Objective‑C) ↔ JavaApp via JNI bridge for sending input/state changes or receiving status callbacks.
- Networking: JSONUtils in Java calls Mojang/Microsoft/Modpack APIs over HTTP.
- Authentication: Native authenticator modules handle OAuth flows, store tokens, pass to Java.
- Resource downloads: JavaApp asset manager triggers native NSURLSession via AFNetworking or AltKit.
- JIT & Memory hacks: native dyld bypass + TrollStore/AltStore entitlements to enable JIT in Caciocavallo VM.

##### Architectural Patterns & Design Principles
- Layered Architecture: UI layer (UIKit) / Java logic layer / Native engine layer / OS framework layer
- MVC on UI side: each ViewController maps to a screen (profiles, settings, game surface)
- Adapter pattern: JNI/JNA agent adapts between Java world and iOS native world
- Plugin‑style extensibility for mod loaders (Fabric, Forge, Quilt)
- Separation of concerns:
- JavaApp: game logic, version management, download orchestration
- Natives: platform integration, UI glue, graphics abstraction

##### Elements
- Java Libraries (LWJGL, Caciocavallo, Gson)
- JNI/JNA Agent
- Native Modules (UI Controllers, Graphics Bridge, Input Bridge, Authenticator, Installer)
- OS Frameworks (Metal, UIKit, CoreFoundation)
- Bundled dylibs (MoltenVK, Mesa, gl4es)
- External Services (Mojang API, Microsoft OAuth, Modpack APIs)
- “JNI calls”, “Asset download HTTP”, “Render commands”, “Input events”

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Java Layer
    subgraph "Java Layer"
        direction TB
        JavaApp["JavaApp"]:::java
        VersionManager["VersionManager"]:::java
        AssetManager["AssetManager"]:::java
        LauncherCore["LauncherCore"]:::java
        LWJGL["LWJGL + GLFW"]:::java
        CAV["Caciocavallo"]:::java
        GSON["Gson"]:::java
    end

    %% Native Bridge
    subgraph "Native Bridge"
        direction TB
        MainHook["Objective-C main_hook"]:::native
        JNIHeader["jni.h"]:::native
        JavaLauncher["JavaLauncher"]:::native
        PatchJNAAgent["PatchJNAAgent"]:::native
    end

    %% Native Platform
    subgraph "Native Platform"
        direction TB
        subgraph "UI Controllers"
            direction TB
            ProfilesVC["AccountListViewController"]:::native
            ProgressVC["DownloadProgressViewController"]:::native
            MenuVC["LauncherMenuViewController"]:::native
            CustomControlsVC["CustomControlsViewController"]:::native
            PreferencesVC["LauncherPreferencesViewController"]:::native
        end
        subgraph "Graphics Bridge"
            direction TB
            EGLBridge["egl_bridge"]:::native
            GLBridge["gl_bridge"]:::native
            OSMBridge["osm_bridge"]:::native
        end
        subgraph "Input Bridge"
            direction TB
            ControllerInput["ControllerInput"]:::native
            KeyboardInput["KeyboardInput"]:::native
            GyroInput["GyroInput"]:::native
            InputV3["input_bridge_v3"]:::native
        end
        subgraph "Installer Modules"
            direction TB
            FabricInstallVC["FabricInstallViewController"]:::native
            ForgeInstallVC["ForgeInstallViewController"]:::native
            ModpackInstallVC["ModpackInstallViewController"]:::native
            CurseForgeAPI["CurseForgeAPI"]:::native
            ModrinthAPI["ModrinthAPI"]:::native
        end
        subgraph "Authentication"
            direction TB
            BaseAuth["BaseAuthenticator"]:::native
            LocalAuth["LocalAuthenticator"]:::native
            MSAuth["MicrosoftAuthenticator"]:::native
            MCJNI["MinecraftAccountJNI"]:::native
        end
        subgraph "File Management"
            direction TB
            NRFileMgr["NSFileManager+NRFileManager"]:::native
            UnzipKit["UnzipKit"]:::native
        end
    end

    %% OS Frameworks & Resources
    subgraph "OS Frameworks & Resources"
        direction TB
        UIKit["UIKit"]:::framework
        Foundation["Foundation"]:::framework
        Metal["Metal"]:::framework
        CoreGraphics["CoreGraphics"]:::framework
        CoreFoundation["CoreFoundation"]:::framework
        Frameworks["Bundled Frameworks & dylibs"]:::framework
        Localization["Localization & Storyboards"]:::framework
    end

    %% External Services
    subgraph "External Services"
        direction TB
        MojangAPI["Mojang API"]:::external
        MicrosoftOAuth["Microsoft OAuth"]:::external
        CurseForgeExt["CurseForge REST API"]:::external
        ModrinthExt["Modrinth REST API"]:::external
    end

    %% Interactions
    MainHook -->|"init JVM"| PatchJNAAgent
    PatchJNAAgent -->|"loads classes"| JavaApp

    JavaApp -->|"uses"| VersionManager
    JavaApp -->|"uses"| AssetManager
    JavaApp -->|"uses"| LauncherCore
    JavaApp -->|"uses"| LWJGL
    JavaApp -->|"uses"| CAV
    JavaApp -->|"uses"| GSON

    JavaApp -->|"JNI calls"| EGLBridge
    EGLBridge -->|"draw calls"| Metal
    EGLBridge -->|"draw calls"| CoreGraphics

    JavaApp -->|"Asset HTTP"| MojangAPI
    JavaApp -->|"Auth HTTP"| MicrosoftOAuth
    JavaApp -->|"Modpack HTTP"| CurseForgeExt
    JavaApp -->|"Modpack HTTP"| ModrinthExt

    ProfilesVC <-->|"input/status callbacks"| JavaApp
    ControllerInput <-->|"input events"| JavaApp
    KeyboardInput <-->|"input events"| JavaApp
    GyroInput <-->|"input events"| JavaApp

    BaseAuth -->|"auth plugins"| JavaApp
    FabricInstallVC -->|"install plugins"| JavaApp

    NRFileMgr -->|"file ops"| JavaApp
    UnzipKit -->|"unzip ops"| JavaApp

    %% Bridge wiring
    MainHook --> JNIHeader
    JNIHeader --> JavaLauncher
    JavaLauncher --> PatchJNAAgent

    JavaApp -->|"graphics init"| GLBridge
    JavaApp -->|"context init"| OSMBridge

    %% Click Events
    click JavaApp "https://github.com/npcx42/pojavlauncher_ios_crack/tree/main/JavaApp/"
    click VersionManager "https://github.com/npcx42/pojavlauncher_ios_crack/tree/main/JavaApp/src/launcher/net/kdt/pojavlaunch/"
    click AssetManager "https://github.com/npcx42/pojavlauncher_ios_crack/tree/main/JavaApp/src/launcher/net/kdt/pojavlaunch/"
    click LauncherCore "https://github.com/npcx42/pojavlauncher_ios_crack/tree/main/JavaApp/src/launcher/net/kdt/pojavlaunch/"
    click LWJGL "https://github.com/npcx42/pojavlauncher_ios_crack/tree/main/JavaApp/src/lwjgl/org/lwjgl/glfw/"
    click CAV "https://github.com/npcx42/pojavlauncher_ios_crack/tree/main/JavaApp/libs/caciocavallo/"
    click PatchJNAAgent "https://github.com/npcx42/pojavlauncher_ios_crack/blob/main/JavaApp/src/patchjna_agent/net/kdt/patchjna/PatchJNAAgent.java"
    click MainHook "https://github.com/npcx42/pojavlauncher_ios_crack/blob/main/Natives/main_hook.m"
    click JNIHeader "https://github.com/npcx42/pojavlauncher_ios_crack/blob/main/Natives/jni.h"
    click JavaLauncher "https://github.com/npcx42/pojavlauncher_ios_crack/blob/main/Natives/JavaLauncher.m"
    click EGLBridge "https://github.com/npcx42/pojavlauncher_ios_crack/blob/main/Natives/egl_bridge.m"
    click GLBridge "https://github.com/npcx42/pojavlauncher_ios_crack/blob/main/Natives/ctxbridges/gl_bridge.m"
    click OSMBridge "https://github.com/npcx42/pojavlauncher_ios_crack/blob/main/Natives/ctxbridges/osm_bridge.m"
    click ControllerInput "https://github.com/npcx42/pojavlauncher_ios_crack/blob/main/Natives/input/ControllerInput.m"
    click KeyboardInput "https://github.com/npcx42/pojavlauncher_ios_crack/blob/main/Natives/input/KeyboardInput.m"
    click GyroInput "https://github.com/npcx42/pojavlauncher_ios_crack/blob/main/Natives/input/GyroInput.m"
    click InputV3 "https://github.com/npcx42/pojavlauncher_ios_crack/blob/main/Natives/input_bridge_v3.m"
    click ProfilesVC "https://github.com/npcx42/pojavlauncher_ios_crack/blob/main/Natives/AccountListViewController.m"
    click ProgressVC "https://github.com/npcx42/pojavlauncher_ios_crack/blob/main/Natives/DownloadProgressViewController.m"
    click MenuVC "https://github.com/npcx42/pojavlauncher_ios_crack/blob/main/Natives/LauncherMenuViewController.m"
    click CustomControlsVC "https://github.com/npcx42/pojavlauncher_ios_crack/blob/main/Natives/CustomControlsViewController.m"
    click PreferencesVC "https://github.com/npcx42/pojavlauncher_ios_crack/blob/main/Natives/LauncherPreferencesViewController.m"
    click FabricInstallVC "https://github.com/npcx42/pojavlauncher_ios_crack/blob/main/Natives/installer/FabricInstallViewController.m"
    click ForgeInstallVC "https://github.com/npcx42/pojavlauncher_ios_crack/blob/main/Natives/installer/ForgeInstallViewController.m"
    click ModpackInstallVC "https://github.com/npcx42/pojavlauncher_ios_crack/blob/main/Natives/installer/ModpackInstallViewController.m"
    click CurseForgeAPI "https://github.com/npcx42/pojavlauncher_ios_crack/blob/main/Natives/installer/modpack/CurseForgeAPI.m"
    click ModrinthAPI "https://github.com/npcx42/pojavlauncher_ios_crack/blob/main/Natives/installer/modpack/ModrinthAPI.m"
    click BaseAuth "https://github.com/npcx42/pojavlauncher_ios_crack/blob/main/Natives/authenticator/BaseAuthenticator.m"
    click LocalAuth "https://github.com/npcx42/pojavlauncher_ios_crack/blob/main/Natives/authenticator/LocalAuthenticator.m"
    click MSAuth "https://github.com/npcx42/pojavlauncher_ios_crack/blob/main/Natives/authenticator/MicrosoftAuthenticator.m"
    click MCJNI "https://github.com/npcx42/pojavlauncher_ios_crack/blob/main/Natives/authenticator/MinecraftAccountJNI.m"
    click NRFileMgr "https://github.com/npcx42/pojavlauncher_ios_crack/blob/main/Natives/external/NRFileManager/NSFileManager+NRFileManager.m"
    click UnzipKit "https://github.com/npcx42/pojavlauncher_ios_crack/tree/main/Natives/external/UnzipKit/"
    click Frameworks "https://github.com/npcx42/pojavlauncher_ios_crack/tree/main/Natives/resources/Frameworks/"
    click Localization "https://github.com/npcx42/pojavlauncher_ios_crack/tree/main/Natives/resources/"

    %% Styles
    classDef java fill:#cce5ff,stroke:#2a66c4,color:#000
    classDef native fill:#d4edda,stroke:#155724,color:#000
    classDef framework fill:#f8f9fa,stroke:#6c757d,color:#000
    classDef external fill:#fff3cd,stroke:#856404,color:#000
```
