# herbrine8403/amethyst-ios-myremastered architecture

> Architecture diagram of the GitHub repository herbrine8403/amethyst-ios-myremastered, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/herbrine8403/amethyst-ios-myremastered
- Repository: https://github.com/herbrine8403/amethyst-ios-myremastered

## Overview

Air is an iOS/iPadOS launcher for Minecraft: Java Edition. The main user workflow is to select an account and game configuration, manage or download game content, then start Minecraft using a selected JVM and rendering backend. The README also documents modpack import, news, multiplayer, TouchController, and an in-development AI integration. The tree identifies likely implementation areas, but source excerpts do not show their call wiring; edges below therefore reflect documented capabilities and relationships, not inspected runtime calls.

Main entry points: [`Natives/LauncherRootViewController.h`](https://github.com/herbrine8403/amethyst-ios-myremastered/blob/main/Natives/LauncherRootViewController.h) (Launcher UI), [`Natives/LauncherPreferences.h`](https://github.com/herbrine8403/amethyst-ios-myremastered/blob/main/Natives/LauncherPreferences.h) (Preferences), [`Natives/AccountLoginViewController.h`](https://github.com/herbrine8403/amethyst-ios-myremastered/blob/main/Natives/AccountLoginViewController.h) (Accounts), [`Natives/JavaLauncher.h`](https://github.com/herbrine8403/amethyst-ios-myremastered/blob/main/Natives/JavaLauncher.h) (Java launcher)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Launcher experience"]
  node_launcher_ui["Launcher UI"]
  node_profiles[("Profiles<br/>[PLProfiles.h]")]
  node_preferences[("Preferences")]
  node_accounts["Accounts"]
  node_auth["Authentication"]
end

subgraph group_content["Game content"]
  node_downloads["Download manager"]
  node_versions["Game versions"]
  node_mods["Mods"]
  node_modpacks["Modpack import"]
  node_resources["Packs and assets"]
end

subgraph group_game["Game runtime"]
  node_java_launcher["Java launcher<br/>[JavaLauncher.h]"]
  node_jvm["JVM and game setup<br/>[PojavLauncher.java]"]
  node_renderer["Renderer selection"]
  node_game_surface["Game surface<br/>[GameSurfaceView.h]"]
  node_touch["Touch controls"]
end

subgraph group_services["Connected features"]
  node_news["News feed"]
  node_multiplayer["Multiplayer"]
  node_ai["AI integration"]
end

node_user(("Player"))
node_content_sources(("Content sources"))

node_user -->|"uses"| node_launcher_ui
node_launcher_ui -->|"manages accounts"| node_accounts
node_launcher_ui -.->|"selects profiles"| node_profiles
node_launcher_ui -->|"configures"| node_preferences
node_launcher_ui -.->|"manages versions"| node_versions
node_launcher_ui -->|"starts downloads"| node_downloads
node_accounts -->|"supports sign-in"| node_auth
node_launcher_ui -->|"manages mods"| node_mods
node_launcher_ui -->|"imports ZIPs"| node_modpacks
node_launcher_ui -->|"manages packs"| node_resources
node_content_sources -->|"provides content"| node_downloads
node_launcher_ui -.->|"starts game"| node_java_launcher
node_java_launcher -.->|"launches JVM"| node_jvm
node_preferences -->|"configures renderer"| node_renderer
node_jvm -.->|"runs Minecraft"| node_game_surface
node_game_surface -->|"supports touch input"| node_touch
node_launcher_ui -->|"shows news"| node_news
node_launcher_ui -.->|"opens multiplayer"| node_multiplayer
node_launcher_ui -->|"offers AI features"| node_ai

click node_launcher_ui "https://github.com/herbrine8403/amethyst-ios-myremastered/blob/main/Natives/LauncherRootViewController.h"
click node_profiles "https://github.com/herbrine8403/amethyst-ios-myremastered/blob/main/Natives/PLProfiles.h"
click node_preferences "https://github.com/herbrine8403/amethyst-ios-myremastered/blob/main/Natives/LauncherPreferences.h"
click node_accounts "https://github.com/herbrine8403/amethyst-ios-myremastered/blob/main/Natives/AccountLoginViewController.h"
click node_auth "https://github.com/herbrine8403/amethyst-ios-myremastered/tree/main/Natives/authenticator"
click node_downloads "https://github.com/herbrine8403/amethyst-ios-myremastered/blob/main/Natives/DownloadTaskManager.h"
click node_versions "https://github.com/herbrine8403/amethyst-ios-myremastered/blob/main/Natives/VersionManagerViewController.h"
click node_mods "https://github.com/herbrine8403/amethyst-ios-myremastered/blob/main/Natives/ModsManagerViewController.h"
click node_modpacks "https://github.com/herbrine8403/amethyst-ios-myremastered/blob/main/Natives/ModpackImportService.h"
click node_resources "https://github.com/herbrine8403/amethyst-ios-myremastered/blob/main/Natives/ResourcePacksManagerViewController.h"
click node_java_launcher "https://github.com/herbrine8403/amethyst-ios-myremastered/blob/main/Natives/JavaLauncher.h"
click node_jvm "https://github.com/herbrine8403/amethyst-ios-myremastered/blob/main/JavaApp/src/launcher/net/kdt/pojavlaunch/PojavLauncher.java"
click node_renderer "https://github.com/herbrine8403/amethyst-ios-myremastered/blob/main/Natives/SurfaceViewController.h"
click node_game_surface "https://github.com/herbrine8403/amethyst-ios-myremastered/blob/main/Natives/GameSurfaceView.h"
click node_touch "https://github.com/herbrine8403/amethyst-ios-myremastered/blob/main/Natives/TouchControllerBridge.h"
click node_news "https://github.com/herbrine8403/amethyst-ios-myremastered/blob/main/Natives/MinecraftNewsService.h"
click node_multiplayer "https://github.com/herbrine8403/amethyst-ios-myremastered/blob/main/Natives/MultiplayerManager.h"
click node_ai "https://github.com/herbrine8403/amethyst-ios-myremastered/tree/main/Natives/AI"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_launcher_ui,node_profiles,node_preferences,node_accounts,node_auth toneBlue
class node_downloads,node_versions,node_mods,node_modpacks,node_resources toneAmber
class node_java_launcher,node_jvm,node_renderer,node_game_surface,node_touch toneMint
class node_news,node_multiplayer,node_ai toneRose
class node_user,node_content_sources toneIndigo
```

## Components

### Launcher experience

- [Launcher UI](https://github.com/herbrine8403/amethyst-ios-myremastered/blob/main/Natives/LauncherRootViewController.h): `Natives/LauncherRootViewController.h`
- [Profiles](https://github.com/herbrine8403/amethyst-ios-myremastered/blob/main/Natives/PLProfiles.h): `Natives/PLProfiles.h`
- [Preferences](https://github.com/herbrine8403/amethyst-ios-myremastered/blob/main/Natives/LauncherPreferences.h): `Natives/LauncherPreferences.h`
- [Accounts](https://github.com/herbrine8403/amethyst-ios-myremastered/blob/main/Natives/AccountLoginViewController.h): `Natives/AccountLoginViewController.h`
- [Authentication](https://github.com/herbrine8403/amethyst-ios-myremastered/tree/main/Natives/authenticator): `Natives/authenticator`

### Game content

- [Download manager](https://github.com/herbrine8403/amethyst-ios-myremastered/blob/main/Natives/DownloadTaskManager.h): `Natives/DownloadTaskManager.h`
- [Game versions](https://github.com/herbrine8403/amethyst-ios-myremastered/blob/main/Natives/VersionManagerViewController.h): `Natives/VersionManagerViewController.h`
- [Mods](https://github.com/herbrine8403/amethyst-ios-myremastered/blob/main/Natives/ModsManagerViewController.h): `Natives/ModsManagerViewController.h`
- [Modpack import](https://github.com/herbrine8403/amethyst-ios-myremastered/blob/main/Natives/ModpackImportService.h): `Natives/ModpackImportService.h`
- [Packs and assets](https://github.com/herbrine8403/amethyst-ios-myremastered/blob/main/Natives/ResourcePacksManagerViewController.h): `Natives/ResourcePacksManagerViewController.h`

### Game runtime

- [Java launcher](https://github.com/herbrine8403/amethyst-ios-myremastered/blob/main/Natives/JavaLauncher.h): `Natives/JavaLauncher.h`
- [JVM and game setup](https://github.com/herbrine8403/amethyst-ios-myremastered/blob/main/JavaApp/src/launcher/net/kdt/pojavlaunch/PojavLauncher.java): `JavaApp/src/launcher/net/kdt/pojavlaunch/PojavLauncher.java`
- [Renderer selection](https://github.com/herbrine8403/amethyst-ios-myremastered/blob/main/Natives/SurfaceViewController.h): `Natives/SurfaceViewController.h`
- [Game surface](https://github.com/herbrine8403/amethyst-ios-myremastered/blob/main/Natives/GameSurfaceView.h): `Natives/GameSurfaceView.h`
- [Touch controls](https://github.com/herbrine8403/amethyst-ios-myremastered/blob/main/Natives/TouchControllerBridge.h): `Natives/TouchControllerBridge.h`

### Connected features

- [News feed](https://github.com/herbrine8403/amethyst-ios-myremastered/blob/main/Natives/MinecraftNewsService.h): `Natives/MinecraftNewsService.h`
- [Multiplayer](https://github.com/herbrine8403/amethyst-ios-myremastered/blob/main/Natives/MultiplayerManager.h): `Natives/MultiplayerManager.h`
- [AI integration](https://github.com/herbrine8403/amethyst-ios-myremastered/tree/main/Natives/AI): `Natives/AI`

### Other components

- **Player**
- **Content sources**

## Connections

- Player → Launcher UI: uses (evidence: `README.md`)
- Launcher UI → Accounts: manages accounts (evidence: `README.md`)
- Launcher UI → Profiles: selects profiles
- Launcher UI → Preferences: configures (evidence: `README.md`)
- Launcher UI → Game versions: manages versions
- Launcher UI → Download manager: starts downloads (evidence: `README.md`)
- Accounts → Authentication: supports sign-in (evidence: `README.md`)
- Launcher UI → Mods: manages mods (evidence: `README.md`)
- Launcher UI → Modpack import: imports ZIPs (evidence: `README.md`)
- Launcher UI → Packs and assets: manages packs (evidence: `README.md`)
- Content sources → Download manager: provides content (evidence: `README.md`)
- Launcher UI → Java launcher: starts game
- Java launcher → JVM and game setup: launches JVM
- Preferences → Renderer selection: configures renderer (evidence: `README.md`)
- JVM and game setup → Game surface: runs Minecraft
- Game surface → Touch controls: supports touch input (evidence: `README.md`)
- Launcher UI → News feed: shows news (evidence: `README.md`)
- Launcher UI → Multiplayer: opens multiplayer
- Launcher UI → AI integration: offers AI features (evidence: `README.md`)
