Add frontend screen system: ScreenId enum and 21 named functions

Map the MFC CDialog-based menu system from 65 decompiled call sites.
Add ScreenId enum with 18 screen IDs (main menu through lobby).
Name 21 frontend/lobby functions and 4 global variables in Ghidra.
Add 25 new addresses to address.rs (14 frontend + 7 lobby + 4 globals).
Document screen transition architecture in frontend-screens.md.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

crates/openwa-types/src/address.rs

@@ -163,18 +163,53 @@ pub mod va {
     pub const SHOW_CHAT_MESSAGE: u32 = 0x0052_ACB0;
     pub const ON_CHAT_INPUT: u32 = 0x0052_B730;
 
+    // === Frontend / menu screens ===
+
+    pub const FRONTEND_CHANGE_SCREEN: u32 = 0x0044_7A20;
+    pub const FRONTEND_FRAME_CONSTRUCTOR: u32 = 0x004E_CCA0;
+    pub const FRONTEND_DIALOG_CONSTRUCTOR: u32 = 0x0044_6BA0;
+    pub const FRONTEND_PALETTE_ANIMATION: u32 = 0x0042_2180;
+    pub const FRONTEND_LOAD_TRANSITION_PAL: u32 = 0x0044_7AA0;
+    pub const FRONTEND_PRE_TRANSITION_CLEANUP: u32 = 0x004E_4AE0;
+    pub const FRONTEND_ON_INITIAL_LOAD: u32 = 0x0042_9830;
+    pub const FRONTEND_LAUNCH_SINGLE_PLAYER: u32 = 0x0044_1D80;
+    pub const FRONTEND_ON_MULTIPLAYER: u32 = 0x0044_E850;
+    pub const FRONTEND_ON_NETWORK: u32 = 0x0044_EC10;
+    pub const FRONTEND_ON_MINIMIZE: u32 = 0x0048_6A10;
+    pub const FRONTEND_ON_OPTIONS_ACCEPT: u32 = 0x0048_DAB0;
+    pub const FRONTEND_ON_START_GAME: u32 = 0x004F_14A0;
+    pub const CDIALOG_DO_MODAL_CUSTOM: u32 = 0x0040_FD60;
+
     // === Lobby / network ===
 
     pub const LOBBY_HOST_COMMANDS: u32 = 0x004B_9B00;
     pub const LOBBY_CLIENT_COMMANDS: u32 = 0x004A_ABB0;
     pub const SEND_GAME_PACKET_WRAPPED: u32 = 0x0054_1130;
-    pub const FRONTEND_CHANGE_SCREEN: u32 = 0x0044_7A20;
+    pub const LOBBY_DISPLAY_MESSAGE: u32 = 0x0049_3CB0;
+    pub const LOBBY_SEND_GREENTEXT: u32 = 0x004A_A990;
+    pub const LOBBY_PRINT_USED_VERSION: u32 = 0x004B_7E20;
+    pub const LOBBY_ON_DISCONNECT: u32 = 0x004B_AE40;
+    pub const LOBBY_ON_GAME_END: u32 = 0x004B_AEC0;
+    pub const LOBBY_ON_MESSAGE: u32 = 0x004B_D400;
+    pub const LOBBY_DIALOG_CONSTRUCTOR: u32 = 0x004C_D9A0;
+    pub const NETWORK_IS_AVAILABLE: u32 = 0x004D_4920;
 
     // === Memory ===
 
     pub const WA_MALLOC_MEMSET: u32 = 0x0053_E910;
     pub const WA_FREE: u32 = 0x005D_0D2B;
 
+    // === Global variables (in .data) ===
+
+    /// Main frontend frame window (CWnd*)
+    pub const G_FRONTEND_FRAME: u32 = 0x006B_3908;
+    /// Main frontend HWND
+    pub const G_FRONTEND_HWND: u32 = 0x006B_390C;
+    /// Network mode (0=LAN, nonzero=WormNET)
+    pub const G_NETWORK_MODE: u32 = 0x007C_0D40;
+    /// Network sub-type selector
+    pub const G_NETWORK_SUBTYPE: u32 = 0x007C_0D68;
+
     // === Game context (DDGame struct offsets) ===
     // These are offsets from the DDGame base pointer, not absolute addresses.
     // DDGame pointer is obtained from hookConstructDDGameWrapper param.

crates/openwa-types/src/frontend.rs

@@ -0,0 +1,78 @@
+/// Frontend screen identifiers.
+///
+/// Used by FrontendChangeScreen (0x447A20) to transition between
+/// menu screens. The screen ID is passed to CDialog::EndDialog as
+/// the result code, then returned from DoModal to drive navigation.
+///
+/// The frontend uses MFC CDialog modal dialogs, not the CTask hierarchy.
+/// The main frame window is stored at global 0x6B3908.
+///
+/// Source: Ghidra decompilation of 65 call sites + wkJellyWorm Lobby.cpp
+#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
+#[repr(i32)]
+pub enum ScreenId {
+    /// Return to previous screen / cancel action
+    Cancel = 0,
+    /// Main menu screen
+    MainMenu = 10,
+    /// Local multiplayer setup
+    LocalMultiplayer = 11,
+    /// Window minimized / inactive state (checked via IsIconic)
+    Minimized = 15,
+    /// Initial game loading screen
+    InitialLoad = 16,
+    /// Single player game (Deathmatch)
+    SinglePlayer = 21,
+    /// Network options sub-screen
+    NetworkSubScreen = 26,
+    /// Start game path A (game setup, param+0x244 == 0)
+    StartGameA = 35,
+    /// Start game path B (game setup fallthrough)
+    StartGameB = 36,
+    /// Network setup path A (param+0x140 == 0)
+    NetworkSetupA = 37,
+    /// Network setup path B (fallthrough)
+    NetworkSetupB = 38,
+    /// Options accepted / theme saved (writes current.thm)
+    OptionsAccept = 39,
+    /// Network provider selection screen
+    NetworkSelection = 1700,
+    /// LAN game
+    Lan = 1702,
+    /// WormNET online lobby
+    WormNet = 1703,
+    /// Lobby as host
+    LobbyHost = 1704,
+    /// Lobby as client / join game
+    LobbyClient = 1706,
+    /// Lobby game start
+    LobbyGameStart = 1707,
+}
+
+impl TryFrom<i32> for ScreenId {
+    type Error = i32;
+
+    fn try_from(value: i32) -> Result<Self, Self::Error> {
+        match value {
+            0 => Ok(Self::Cancel),
+            10 => Ok(Self::MainMenu),
+            11 => Ok(Self::LocalMultiplayer),
+            15 => Ok(Self::Minimized),
+            16 => Ok(Self::InitialLoad),
+            21 => Ok(Self::SinglePlayer),
+            26 => Ok(Self::NetworkSubScreen),
+            35 => Ok(Self::StartGameA),
+            36 => Ok(Self::StartGameB),
+            37 => Ok(Self::NetworkSetupA),
+            38 => Ok(Self::NetworkSetupB),
+            39 => Ok(Self::OptionsAccept),
+            1700 => Ok(Self::NetworkSelection),
+            1702 => Ok(Self::Lan),
+            1703 => Ok(Self::WormNet),
+            1704 => Ok(Self::LobbyHost),
+            1706 => Ok(Self::LobbyClient),
+            1707 => Ok(Self::LobbyGameStart),
+            _ => Err(value),
+        }
+    }
+}

crates/openwa-types/src/lib.rs

@@ -10,4 +10,5 @@ pub mod ddgame_wrapper;
 pub mod landscape;
 pub mod dssound;
 pub mod opengl;
+pub mod frontend;
 pub mod address;

docs/re-notes/frontend-screens.md

@@ -0,0 +1,86 @@
+# Frontend Screen System
+
+## Architecture
+
+The frontend uses **MFC CDialog modal dialogs**, not the CTask class hierarchy.
+Screen transitions work through a centralized dispatcher:
+
+```
+FrontendFrame (global at 0x6B3908, constructed at 0x4ECCA0)
+  └── CDialog modal loop (CDialog__DoModal_Custom at 0x40FD60)
+       ├── Button handler calls FrontendChangeScreen(screen_id)
+       ├── FrontendChangeScreen calls CDialog::EndDialog(screen_id)
+       ├── DoModal returns screen_id to caller
+       └── Caller decides next dialog based on return value
+```
+
+## FrontendChangeScreen (0x447A20)
+
+Two modes based on `g_FrontendFrame` (0x6B3908):
+
+- **Normal** (g_FrontendFrame != 0): Disable window → palette transition
+  (0x422180) → call vtable method at +0x15C twice → re-enable window →
+  CDialog::EndDialog(screen_id)
+- **Init** (g_FrontendFrame == 0): Store screen_id at ESI+0x44, clear flag bit
+
+## Screen IDs
+
+| ID | Hex | Name | Context |
+|----|-----|------|---------|
+| 0 | 0x00 | Cancel | Return to previous / close dialog |
+| 10 | 0x0A | MainMenu | Main menu screen |
+| 11 | 0x0B | LocalMultiplayer | Local multiplayer setup |
+| 15 | 0x0F | Minimized | Window minimized (IsIconic check) |
+| 16 | 0x10 | InitialLoad | Initial game loading screen |
+| 21 | 0x15 | SinglePlayer | Single player / Deathmatch |
+| 26 | 0x1A | NetworkSubScreen | Network options sub-screen |
+| 35 | 0x23 | StartGameA | Start game (path A) |
+| 36 | 0x24 | StartGameB | Start game (path B) |
+| 37 | 0x25 | NetworkSetupA | Network setup (path A) |
+| 38 | 0x26 | NetworkSetupB | Network setup (path B) |
+| 39 | 0x27 | OptionsAccept | Options saved (writes current.thm) |
+| 1700 | 0x6A4 | NetworkSelection | Network provider selection |
+| 1702 | 0x6A6 | Lan | LAN game |
+| 1703 | 0x6A7 | WormNet | WormNET online lobby |
+| 1704 | 0x6A8 | LobbyHost | Hosting a game |
+| 1706 | 0x6AA | LobbyClient | Joining a game |
+| 1707 | 0x6AB | LobbyGameStart | Lobby → game start |
+
+Note: Some callers pass dynamic screen IDs. There may be additional IDs not
+discovered through static analysis.
+
+## Key Globals
+
+| Address | Name | Type | Description |
+|---------|------|------|-------------|
+| 0x6B3908 | g_FrontendFrame | CWnd* | Main application frame window |
+| 0x6B390C | g_FrontendHwnd | HWND | Main window handle |
+| 0x7C0D40 | g_NetworkMode | int | 0=LAN, nonzero=WormNET |
+| 0x7C0D68 | g_NetworkSubtype | int | Network sub-type selector |
+
+## Key Functions
+
+| Address | Name | Purpose |
+|---------|------|---------|
+| 0x40FD60 | CDialog__DoModal_Custom | Custom DoModal returning screen ID |
+| 0x422180 | Frontend__PaletteAnimation | Palette transition effect |
+| 0x429830 | Frontend__OnInitialLoad | Initial game load handler |
+| 0x441D80 | Frontend__LaunchSinglePlayer | Single player launch |
+| 0x446BA0 | FrontendDialog__Constructor | Dialog constructor |
+| 0x447A20 | FrontendChangeScreen | Central screen transition dispatcher |
+| 0x447AA0 | Frontend__LoadTransitionPalette | Load transition palette |
+| 0x44E850 | Frontend__OnMultiplayerButton | Multiplayer button handler |
+| 0x44EC10 | Frontend__OnNetworkButton | Network button handler |
+| 0x486A10 | Frontend__OnMinimize | Window minimize handler |
+| 0x48DAB0 | Frontend__OnOptionsAccept | Options accept handler |
+| 0x493CB0 | Lobby__DisplayMessage | Display lobby chat message |
+| 0x4AA990 | Lobby__SendGreentext | Send colored lobby text |
+| 0x4B7E20 | Lobby__PrintUsedVersion | Print version to lobby |
+| 0x4BAE40 | Lobby__OnDisconnect | Handle lobby disconnect |
+| 0x4BAEC0 | Lobby__OnGameEnd | Handle game end in lobby |
+| 0x4BD400 | Lobby__OnMessage | Handle lobby message |
+| 0x4CD9A0 | LobbyDialog__Constructor | Lobby dialog constructor |
+| 0x4D4920 | Network__IsAvailable | Check network availability |
+| 0x4E4AE0 | Frontend__PreTransitionCleanup | Pre-transition cleanup |
+| 0x4ECCA0 | FrontendFrame__Constructor | Frame window constructor |
+| 0x4F14A0 | Frontend__OnStartGameButton | Start game button handler |