# anthony-hyo/aqw-mobile architecture

> Architecture diagram of the GitHub repository anthony-hyo/aqw-mobile, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/anthony-hyo/aqw-mobile
- Repository: https://github.com/anthony-hyo/aqw-mobile

## Overview

AQW Pocket is a native AIR client for AdventureQuest Worlds, accompanied by a server for quest translations and global chat. The user-facing path is launching the client to play, with mobile controls and configurable UI; the README also documents update notifications and desktop Discord Rich Presence. The Rust patcher prepares patched game files for the loader. Server routes provide translation lookup/generation, while WebSocket chat validates and broadcasts messages. Client internals are largely unsampled, so those capabilities and links rely on README statements; server links use shown registrations and imports.

Main entry points: [`server/src/ws/message.ts`](https://github.com/anthony-hyo/aqw-mobile/blob/master/server/src/ws/message.ts) (Validate and broadcast), [`server/src/index.ts`](https://github.com/anthony-hyo/aqw-mobile/blob/master/server/src/index.ts) (HTTP and WS entry), [`loader/src/Pocket.as`](https://github.com/anthony-hyo/aqw-mobile/blob/master/loader/src/Pocket.as) (AIR loader), [`server/src/http/quests/quest-all.ts`](https://github.com/anthony-hyo/aqw-mobile/blob/master/server/src/http/quests/quest-all.ts) (Generate translations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_patching["Game patching"]
  node_patcher["SWF patcher<br/>[patcher.rs]"]
  node_patchutil["Patch utilities<br/>[util.rs]"]
  node_gamefiles["Patched game files"]
end

subgraph group_client["AQW client"]
  node_airloader["AIR loader<br/>[Pocket.as]"]
  node_gamecore["Game client<br/>[Core.as]"]
  node_mobilecontrols["Mobile controls"]
  node_layout["UI layout"]
  node_updates["Update notifications<br/>[UpdateLoad.as]"]
  node_discordpresence["Discord presence"]
end

subgraph group_server["Translation and chat service"]
  node_serverentry["HTTP and WS entry<br/>[index.ts]"]
  node_questall["Generate translations<br/>[quest-all.ts]"]
  node_questone["Single quest lookup<br/>[questOne.ts]"]
  node_questmany["Multiple quest lookup<br/>[questMany.ts]"]
  node_questdb[("Quest database<br/>[database.ts]")]
  node_languageconfig["Supported languages<br/>[languages.ts]"]
  node_translationmodel["Translation records"]
  node_questmodel["Quest records<br/>[quest.model.ts]"]
  node_chatservice["Chat WebSocket<br/>[chat.ts]"]
  node_chatopen["Chat session open<br/>[open.ts]"]
  node_chatmessage["Validate and broadcast<br/>[message.ts]"]
  node_chatclose["Chat session close<br/>[close.ts]"]
  node_chathelper["Chat helpers<br/>[helper.ts]"]
  node_chatstate["Session state"]
  node_history["Recent messages<br/>[history.ts]"]
  node_entrymodel["Chat entry<br/>[entry.model.ts]"]
end

node_developer(("Build operator"))
node_player(("Player"))
node_github["GitHub releases"]
node_discord["Discord"]
node_translator["Google Translate"]
node_webhook["Discord webhook"]

node_developer -->|"runs patching"| node_patcher
node_patcher -->|"uses helpers"| node_patchutil
node_patcher -->|"writes patched SWF"| node_gamefiles
node_player -->|"launches"| node_airloader
node_airloader -->|"loads patched game"| node_gamefiles
node_airloader -->|"initializes"| node_gamecore
node_player -->|"uses controls"| node_mobilecontrols
node_player -->|"configures UI"| node_layout
node_updates -->|"checks releases"| node_github
node_airloader -->|"shows notifications"| node_updates
node_airloader -.->|"enables desktop presence"| node_discordpresence
node_discordpresence -.->|"reports presence"| node_discord
node_serverentry -->|"routes requests"| node_questall
node_serverentry -->|"routes requests"| node_questone
node_serverentry -->|"routes requests"| node_questmany
node_questall -->|"reads and writes"| node_questdb
node_questall -->|"iterates languages"| node_languageconfig
node_questall -->|"translates quests"| node_translator
node_questall -->|"uses quest records"| node_questmodel
node_questone -->|"queries translations"| node_questdb
node_questone -->|"checks languages"| node_languageconfig
node_questone -->|"returns translation"| node_translationmodel
node_questmany -->|"queries translations"| node_questdb
node_questmany -->|"checks languages"| node_languageconfig
node_questmany -->|"returns translations"| node_translationmodel
node_translationmodel -->|"extends quest"| node_questmodel
node_serverentry -->|"registers WebSocket"| node_chatservice
node_chatservice -->|"dispatches open"| node_chatopen
node_chatservice -->|"dispatches messages"| node_chatmessage
node_chatservice -->|"dispatches close"| node_chatclose
node_serverentry -->|"upgrades connections"| node_chathelper
node_chatopen -->|"initializes session"| node_chatstate
node_chatmessage -->|"uses session"| node_chatstate
node_chatclose -->|"uses session"| node_chatstate
node_chatmessage -->|"cleans messages"| node_chathelper
node_chatmessage -->|"stores recent messages"| node_history
node_chatmessage -->|"creates entries"| node_entrymodel
node_chatmessage -.->|"forwards messages"| node_webhook

click node_patcher "https://github.com/anthony-hyo/aqw-mobile/blob/master/src/patcher.rs"
click node_patchutil "https://github.com/anthony-hyo/aqw-mobile/blob/master/src/util.rs"
click node_airloader "https://github.com/anthony-hyo/aqw-mobile/blob/master/loader/src/Pocket.as"
click node_gamecore "https://github.com/anthony-hyo/aqw-mobile/blob/master/loader/src/game/Core.as"
click node_mobilecontrols "https://github.com/anthony-hyo/aqw-mobile/tree/master/loader/src/ui/input"
click node_layout "https://github.com/anthony-hyo/aqw-mobile/blob/master/loader/src/controller/LayoutController.as"
click node_updates "https://github.com/anthony-hyo/aqw-mobile/blob/master/loader/src/load/handlers/UpdateLoad.as"
click node_discordpresence "https://github.com/anthony-hyo/aqw-mobile/blob/master/loader/src/discord/DiscordRichPresence.as"
click node_serverentry "https://github.com/anthony-hyo/aqw-mobile/blob/master/server/src/index.ts"
click node_questall "https://github.com/anthony-hyo/aqw-mobile/blob/master/server/src/http/quests/quest-all.ts"
click node_questone "https://github.com/anthony-hyo/aqw-mobile/blob/master/server/src/http/quests/questOne.ts"
click node_questmany "https://github.com/anthony-hyo/aqw-mobile/blob/master/server/src/http/quests/questMany.ts"
click node_questdb "https://github.com/anthony-hyo/aqw-mobile/blob/master/server/src/consts/database.ts"
click node_languageconfig "https://github.com/anthony-hyo/aqw-mobile/blob/master/server/src/consts/languages.ts"
click node_translationmodel "https://github.com/anthony-hyo/aqw-mobile/blob/master/server/src/models/quest-translation.model.ts"
click node_questmodel "https://github.com/anthony-hyo/aqw-mobile/blob/master/server/src/models/quest.model.ts"
click node_chatservice "https://github.com/anthony-hyo/aqw-mobile/blob/master/server/src/chat.ts"
click node_chatopen "https://github.com/anthony-hyo/aqw-mobile/blob/master/server/src/ws/open.ts"
click node_chatmessage "https://github.com/anthony-hyo/aqw-mobile/blob/master/server/src/ws/message.ts"
click node_chatclose "https://github.com/anthony-hyo/aqw-mobile/blob/master/server/src/ws/close.ts"
click node_chathelper "https://github.com/anthony-hyo/aqw-mobile/blob/master/server/src/util/helper.ts"
click node_chatstate "https://github.com/anthony-hyo/aqw-mobile/blob/master/server/src/models/chat-session.model.ts"
click node_history "https://github.com/anthony-hyo/aqw-mobile/blob/master/server/src/consts/history.ts"
click node_entrymodel "https://github.com/anthony-hyo/aqw-mobile/blob/master/server/src/models/entry.model.ts"

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_patcher,node_patchutil,node_gamefiles toneBlue
class node_airloader,node_gamecore,node_mobilecontrols,node_layout,node_updates,node_discordpresence toneAmber
class node_serverentry,node_questall,node_questone,node_questmany,node_questdb,node_languageconfig,node_translationmodel,node_questmodel,node_chatservice,node_chatopen,node_chatmessage,node_chatclose,node_chathelper,node_chatstate,node_history,node_entrymodel,node_webhook toneMint
class node_developer,node_player,node_github,node_discord,node_translator toneIndigo
```

## Components

### Game patching

- [SWF patcher](https://github.com/anthony-hyo/aqw-mobile/blob/master/src/patcher.rs): `src/patcher.rs`
- [Patch utilities](https://github.com/anthony-hyo/aqw-mobile/blob/master/src/util.rs): `src/util.rs`
- **Patched game files**

### AQW client

- [AIR loader](https://github.com/anthony-hyo/aqw-mobile/blob/master/loader/src/Pocket.as): `loader/src/Pocket.as`
- [Game client](https://github.com/anthony-hyo/aqw-mobile/blob/master/loader/src/game/Core.as): `loader/src/game/Core.as`
- [Mobile controls](https://github.com/anthony-hyo/aqw-mobile/tree/master/loader/src/ui/input): `loader/src/ui/input`
- [UI layout](https://github.com/anthony-hyo/aqw-mobile/blob/master/loader/src/controller/LayoutController.as): `loader/src/controller/LayoutController.as`
- [Update notifications](https://github.com/anthony-hyo/aqw-mobile/blob/master/loader/src/load/handlers/UpdateLoad.as): `loader/src/load/handlers/UpdateLoad.as`
- [Discord presence](https://github.com/anthony-hyo/aqw-mobile/blob/master/loader/src/discord/DiscordRichPresence.as): `loader/src/discord/DiscordRichPresence.as`

### Translation and chat service

- [HTTP and WS entry](https://github.com/anthony-hyo/aqw-mobile/blob/master/server/src/index.ts): `server/src/index.ts`
- [Generate translations](https://github.com/anthony-hyo/aqw-mobile/blob/master/server/src/http/quests/quest-all.ts): `server/src/http/quests/quest-all.ts`
- [Single quest lookup](https://github.com/anthony-hyo/aqw-mobile/blob/master/server/src/http/quests/questOne.ts): `server/src/http/quests/questOne.ts`
- [Multiple quest lookup](https://github.com/anthony-hyo/aqw-mobile/blob/master/server/src/http/quests/questMany.ts): `server/src/http/quests/questMany.ts`
- [Quest database](https://github.com/anthony-hyo/aqw-mobile/blob/master/server/src/consts/database.ts): `server/src/consts/database.ts`
- [Supported languages](https://github.com/anthony-hyo/aqw-mobile/blob/master/server/src/consts/languages.ts): `server/src/consts/languages.ts`
- [Translation records](https://github.com/anthony-hyo/aqw-mobile/blob/master/server/src/models/quest-translation.model.ts): `server/src/models/quest-translation.model.ts`
- [Quest records](https://github.com/anthony-hyo/aqw-mobile/blob/master/server/src/models/quest.model.ts): `server/src/models/quest.model.ts`
- [Chat WebSocket](https://github.com/anthony-hyo/aqw-mobile/blob/master/server/src/chat.ts): `server/src/chat.ts`
- [Chat session open](https://github.com/anthony-hyo/aqw-mobile/blob/master/server/src/ws/open.ts): `server/src/ws/open.ts`
- [Validate and broadcast](https://github.com/anthony-hyo/aqw-mobile/blob/master/server/src/ws/message.ts): `server/src/ws/message.ts`
- [Chat session close](https://github.com/anthony-hyo/aqw-mobile/blob/master/server/src/ws/close.ts): `server/src/ws/close.ts`
- [Chat helpers](https://github.com/anthony-hyo/aqw-mobile/blob/master/server/src/util/helper.ts): `server/src/util/helper.ts`
- [Session state](https://github.com/anthony-hyo/aqw-mobile/blob/master/server/src/models/chat-session.model.ts): `server/src/models/chat-session.model.ts`
- [Recent messages](https://github.com/anthony-hyo/aqw-mobile/blob/master/server/src/consts/history.ts): `server/src/consts/history.ts`
- [Chat entry](https://github.com/anthony-hyo/aqw-mobile/blob/master/server/src/models/entry.model.ts): `server/src/models/entry.model.ts`

### Other components

- **Build operator**
- **Player**
- **GitHub releases**
- **Discord**
- **Google Translate**
- **Discord webhook**

## Connections

- Build operator → SWF patcher: runs patching
- SWF patcher → Patch utilities: uses helpers (evidence: `src/patcher.rs`)
- SWF patcher → Patched game files: writes patched SWF (evidence: `src/patcher.rs`)
- Player → AIR loader: launches (evidence: `README.md`)
- AIR loader → Patched game files: loads patched game (evidence: `README.md`)
- AIR loader → Game client: initializes (evidence: `README.md`)
- Player → Mobile controls: uses controls (evidence: `README.md`)
- Player → UI layout: configures UI (evidence: `README.md`)
- Update notifications → GitHub releases: checks releases (evidence: `README.md`)
- AIR loader → Update notifications: shows notifications (evidence: `README.md`)
- AIR loader → Discord presence: enables desktop presence (evidence: `README.md`)
- Discord presence → Discord: reports presence (evidence: `README.md`)
- HTTP and WS entry → Generate translations: routes requests (evidence: `server/src/index.ts`)
- HTTP and WS entry → Single quest lookup: routes requests (evidence: `server/src/index.ts`)
- HTTP and WS entry → Multiple quest lookup: routes requests (evidence: `server/src/index.ts`)
- Generate translations → Quest database: reads and writes (evidence: `server/src/http/quests/quest-all.ts`)
- Generate translations → Supported languages: iterates languages (evidence: `server/src/http/quests/quest-all.ts`)
- Generate translations → Google Translate: translates quests (evidence: `server/src/http/quests/quest-all.ts`)
- Generate translations → Quest records: uses quest records (evidence: `server/src/http/quests/quest-all.ts`)
- Single quest lookup → Quest database: queries translations (evidence: `server/src/http/quests/questOne.ts`)
- Single quest lookup → Supported languages: checks languages (evidence: `server/src/http/quests/questOne.ts`)
- Single quest lookup → Translation records: returns translation (evidence: `server/src/http/quests/questOne.ts`)
- Multiple quest lookup → Quest database: queries translations (evidence: `server/src/http/quests/questMany.ts`)
- Multiple quest lookup → Supported languages: checks languages (evidence: `server/src/http/quests/questMany.ts`)
- Multiple quest lookup → Translation records: returns translations (evidence: `server/src/http/quests/questMany.ts`)
- Translation records → Quest records: extends quest (evidence: `server/src/models/quest-translation.model.ts`)
- HTTP and WS entry → Chat WebSocket: registers WebSocket (evidence: `server/src/index.ts`)
- Chat WebSocket → Chat session open: dispatches open (evidence: `server/src/chat.ts`)
- Chat WebSocket → Validate and broadcast: dispatches messages (evidence: `server/src/chat.ts`)
- Chat WebSocket → Chat session close: dispatches close (evidence: `server/src/chat.ts`)
- HTTP and WS entry → Chat helpers: upgrades connections (evidence: `server/src/index.ts`)
- Chat session open → Session state: initializes session (evidence: `server/src/ws/open.ts`)
- Validate and broadcast → Session state: uses session (evidence: `server/src/ws/message.ts`)
- Chat session close → Session state: uses session (evidence: `server/src/ws/close.ts`)
- Validate and broadcast → Chat helpers: cleans messages (evidence: `server/src/ws/message.ts`)
- Validate and broadcast → Recent messages: stores recent messages (evidence: `server/src/ws/message.ts`)
- Validate and broadcast → Chat entry: creates entries (evidence: `server/src/ws/message.ts`)
- Validate and broadcast → Discord webhook: forwards messages (evidence: `server/src/ws/message.ts`)
