v4.2.1: plain-language game copy and a balance fetch on login

The lobby and every game screen now speak to a player, not an operator: each game has one how-to sentence, and the table headers, limits, RTP, paytable and server-timing notes are gone. The account and balance are fetched whenever a session signs in, including stored-credential auto-login, so the header is filled before the lobby appears.

16 files changed, 51 insertions, 223 deletions

diff --git a/Cargo.toml b/Cargo.toml
index 23188da..179cb39 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -3,7 +3,7 @@ members = ["gui"]
 
 [package]
 name = "zagan-bet"
-version = "4.2.0"
+version = "4.2.1"
 edition = "2024"
 license = "GPL-3.0-or-later"
 
diff --git a/docs/GUI-PLAN.md b/docs/GUI-PLAN.md
index 4279626..89cf495 100644
--- a/docs/GUI-PLAN.md
+++ b/docs/GUI-PLAN.md
@@ -130,6 +130,9 @@ they show the same layout with the real session and the pinned action bars.
 - Sidebars pin their action block below the content, so SPIN, CLEAR, DEAL and
   START never move as the bet slip or a hand grows. The embedded fonts have no
   suit or arrow glyphs, so suits are shapes and navigation uses plain words.
+- The lobby and the game screens speak plain language: one how-to sentence per
+  game, no RTP, table limits, deck rules or server-timing jargon. The account
+  and balance are fetched as soon as a session signs in.
 - The header balance is held at the staked amount while the reels or wheel
   turn, then jumps to the settled value: the GUI never reveals a payout before
   the animation does. Refused spins cancel the animation and show the error.
@@ -152,8 +155,8 @@ Measured on Linux at 1080p with llvmpipe software GL:
 | --- | --- |
 | Linux binary | 8.3 MB |
 | Windows x86_64 binary | 6.8 MB |
-| Cold start to window | 61 ms |
-| Idle RSS | 131 MB |
+| Cold start to window | 72 ms |
+| Idle RSS | 130 MB |
 | Idle CPU | 0% |
 
 **Gate:** the screenshot set is ready for review. Remaining for the gate:
diff --git a/docs/TESTING.md b/docs/TESTING.md
index 817cb3d..613cd08 100644
--- a/docs/TESTING.md
+++ b/docs/TESTING.md
@@ -126,8 +126,9 @@ terminal client; a saved login from one signs in the other.
 2. First contact: the fingerprint modal appears before any credentials. Cancel
    leaves the connect screen; Trust continues to the login screen.
 3. Register, then log in with "Remember this login". The lobby shows the host,
-   ping, account, balance and the four games; quit and reconnect: the stored
-   login signs in without asking.
+   ping, account, balance and the four games; the balance fills in immediately
+   without entering a game. Quit and reconnect: the stored login signs in
+   without asking.
 4. Each game: place a bet or deal, play a round, and confirm the balance and the
    header update. Slots shows reels and win lines; roulette spins the wheel and
    reports the payout; blackjack draws suits and settles; crash draws a smooth
diff --git a/docs/screenshots/gui-blackjack-1080p.png b/docs/screenshots/gui-blackjack-1080p.png
index b0fcc19..361f987 100644
--- a/docs/screenshots/gui-blackjack-1080p.png
+++ b/docs/screenshots/gui-blackjack-1080p.png
diff --git a/docs/screenshots/gui-crash-1080p.png b/docs/screenshots/gui-crash-1080p.png
index 245a3a1..da72f1f 100644
--- a/docs/screenshots/gui-crash-1080p.png
+++ b/docs/screenshots/gui-crash-1080p.png
diff --git a/docs/screenshots/gui-lobby-1080p.png b/docs/screenshots/gui-lobby-1080p.png
index a258967..8bfe8c8 100644
--- a/docs/screenshots/gui-lobby-1080p.png
+++ b/docs/screenshots/gui-lobby-1080p.png
diff --git a/docs/screenshots/gui-roulette-1080p.png b/docs/screenshots/gui-roulette-1080p.png
index 1d7af3d..703ea57 100644
--- a/docs/screenshots/gui-roulette-1080p.png
+++ b/docs/screenshots/gui-roulette-1080p.png
diff --git a/docs/screenshots/gui-roulette-result-1080p.png b/docs/screenshots/gui-roulette-result-1080p.png
index fe4c9cd..c1ffa63 100644
--- a/docs/screenshots/gui-roulette-result-1080p.png
+++ b/docs/screenshots/gui-roulette-result-1080p.png
diff --git a/docs/screenshots/gui-slots-1080p.png b/docs/screenshots/gui-slots-1080p.png
index 9d79321..0982114 100644
--- a/docs/screenshots/gui-slots-1080p.png
+++ b/docs/screenshots/gui-slots-1080p.png
diff --git a/gui/Cargo.toml b/gui/Cargo.toml
index d3d9c36..5418794 100644
--- a/gui/Cargo.toml
+++ b/gui/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "zagan-bet-gui"
-version = "4.2.0"
+version = "4.2.1"
 edition = "2024"
 license = "GPL-3.0-or-later"
 description = "Desktop frontend for zagan-bet"
diff --git a/gui/src/app.rs b/gui/src/app.rs
index f0efd3e..af64e5e 100644
--- a/gui/src/app.rs
+++ b/gui/src/app.rs
@@ -49,6 +49,7 @@ pub struct ZaganApp {
     notices: VecDeque<Notice>,
     awaiting: Option<Instant>,
     need_info: bool,
+    was_logged_in: bool,
     pending_login: Option<(String, String)>,
     /// Displayed balance while a result animation runs: stake deducted, no
     /// winnings yet. The view already knows the outcome; the player must not.
@@ -62,7 +63,6 @@ struct Session {
     host: String,
     fingerprint: Option<String>,
     ping_ms: f32,
-    server_version: String,
     latest: String,
     url: String,
     user: Option<String>,
@@ -186,6 +186,7 @@ impl ZaganApp {
             notices: VecDeque::new(),
             awaiting: None,
             need_info: false,
+            was_logged_in: false,
             pending_login: None,
             balance_hold: None,
             balance: None,
@@ -348,7 +349,7 @@ impl ZaganApp {
                         reply,
                     });
                 }
-                Event::Connected(connected) => self.connected(ctx, connected),
+                Event::Connected(connected) => self.connected(connected),
                 Event::Failed {
                     addr,
                     failure,
@@ -376,7 +377,7 @@ impl ZaganApp {
         }
     }
 
-    fn connected(&mut self, ctx: &Context, connected: Connected) {
+    fn connected(&mut self, connected: Connected) {
         self.connect.pending = false;
         self.connect.error = None;
         self.core.set_connected(true);
@@ -393,19 +394,14 @@ impl ZaganApp {
             host: connected.addr,
             fingerprint: connected.fingerprint,
             ping_ms: connected.elapsed_ms,
-            server_version: connected.server_version,
             latest: connected.latest,
             url: connected.url,
             user: connected.user,
         });
 
-        self.need_info = self.session.as_ref().is_some_and(|s| s.user.is_some());
+        self.need_info = false;
+        self.was_logged_in = false;
         self.account = None;
-        if self.need_info {
-            let effects = self.core.command(Command::Info);
-            self.apply(ctx, effects);
-            self.need_info = false;
-        }
     }
 
     fn failed(&mut self, addr: String, failure: Failure, message: String) {
@@ -511,7 +507,6 @@ impl ZaganApp {
         let command = if registering {
             Command::Register { user, credential }
         } else {
-            self.need_info = true;
             if self.login.remember {
                 self.pending_login = Some((user.clone(), credential.clone()));
             }
@@ -522,19 +517,26 @@ impl ZaganApp {
     }
 
     fn tick(&mut self, ctx: &Context) {
-        // Request deadline, mirroring the terminal's socket timeout.
-        if self.need_info
-            && self
-                .session
-                .as_ref()
-                .is_some_and(|session| session.user.is_some())
-            && self.account.is_none()
-        {
+        // Fetch the account and balance once each time a session signs in.
+        let signed_in = self
+            .core
+            .view()
+            .as_ref()
+            .is_some_and(|view| matches!(view, View::Lobby(lobby) if lobby.user.is_some()));
+        if signed_in != self.was_logged_in {
+            self.was_logged_in = signed_in;
+            if signed_in {
+                self.need_info = true;
+            }
+        }
+        if self.need_info && signed_in {
             let effects = self.core.command(Command::Info);
             self.apply(ctx, effects);
             self.need_info = false;
         }
 
+        // Request deadline, mirroring the terminal's socket timeout.
+
         if let Some(sent) = self.awaiting {
             if sent.elapsed() > REQUEST_TIMEOUT {
                 self.awaiting = None;
@@ -1351,13 +1353,7 @@ fn lobby_screen(ui: &mut Ui, app: &mut ZaganApp, lobby: &LobbyView) {
             ui.add_space(theme::SPACE_2);
             ui.horizontal(|ui| {
                 if let Some(session) = &app.session {
-                    widgets::note(
-                        ui,
-                        &format!(
-                            "Signed in to {}  ·  server v{}",
-                            session.host, session.server_version
-                        ),
-                    );
+                    widgets::note(ui, &format!("Signed in to {}", session.host));
                 }
                 ui.with_layout(Layout::right_to_left(Align::Center), |ui| {
                     if widgets::ghost(ui, "Forget saved login") {
@@ -1396,15 +1392,9 @@ fn game_card(ui: &mut Ui, app: &mut ZaganApp, key: &str, name: &str) {
                     .font(theme::sans(22.0))
                     .color(theme::TEXT),
             );
-            ui.add_space(2.0);
-            widgets::note(ui, tagline(key));
             ui.add_space(theme::SPACE_1);
-            ui.label(
-                RichText::new(meta(key))
-                    .font(theme::mono(10.0))
-                    .color(theme::TEXT_FAINT),
-            );
-            ui.add_space(theme::SPACE_3);
+            widgets::note(ui, how_to(key));
+            ui.add_space(theme::SPACE_4);
             if widgets::primary(ui, "PLAY", true, 110.0, 36.0) {
                 let effects = app.core.command(Command::Play {
                     game: key.to_string(),
@@ -1415,22 +1405,13 @@ fn game_card(ui: &mut Ui, app: &mut ZaganApp, key: &str, name: &str) {
         });
 }
 
-fn tagline(game: &str) -> &'static str {
-    match game {
-        "slots" => "Five reels, five paylines, one lever.",
-        "roulette" => "The European wheel, thirty-seven pockets.",
-        "blackjack" => "Six decks, dealer stands on seventeen. Pays 3:2.",
-        "crash" => "The multiplier rises. Cash out before it busts.",
-        _ => "",
-    }
-}
-
-fn meta(game: &str) -> &'static str {
+/// One plain sentence: how to play, not the house's rules sheet.
+fn how_to(game: &str) -> &'static str {
     match game {
-        "slots" => "MIN 10 KR  ·  RTP 96%",
-        "roulette" => "MIN 10 KR  ·  SINGLE ZERO",
-        "blackjack" => "MIN 10 KR  ·  S17  ·  3:2",
-        "crash" => "MIN 10 KR  ·  1% EDGE",
+        "slots" => "Spin the reels. Three or more matching symbols from the left win.",
+        "roulette" => "Put chips on the table, then spin. Straight numbers pay the most.",
+        "blackjack" => "Get closer to 21 than the dealer without going over.",
+        "crash" => "Start the round, then cash out before the multiplier crashes.",
         _ => "",
     }
 }
diff --git a/gui/src/blackjack.rs b/gui/src/blackjack.rs
index d42f000..bbe96fa 100644
--- a/gui/src/blackjack.rs
+++ b/gui/src/blackjack.rs
@@ -70,11 +70,7 @@ fn sidebar(ui: &mut Ui, view: &BlackjackView) -> Option<Command> {
                             .font(theme::sans(22.0))
                             .color(theme::TEXT),
                     );
-                    ui.label(
-                        eframe::egui::RichText::new("6 decks  ·  dealer stands on 17  ·  3:2")
-                            .font(theme::sans(12.0))
-                            .color(theme::TEXT_DIM),
-                    );
+                    widgets::note(ui, "Get close to 21 without going over.");
 
                     ui.add_space(theme::SPACE_5);
                     ui.label(theme::label("Bet"));
@@ -104,12 +100,6 @@ fn sidebar(ui: &mut Ui, view: &BlackjackView) -> Option<Command> {
                         ui.add_space(theme::SPACE_3);
                         widgets::error(ui, error);
                     }
-
-                    ui.add_space(theme::SPACE_4);
-                    ui.separator();
-                    ui.add_space(theme::SPACE_2);
-                    widgets::note(ui, "Blackjack pays 3:2. The dealer stands on soft 17.");
-                    widgets::note(ui, "Double only on the first two cards.");
                 });
         },
     );
@@ -189,29 +179,7 @@ fn result_text(result: &str, winnings: u64) -> (String, Color32) {
 }
 
 fn board(ui: &mut Ui, view: &BlackjackView) {
-    ui.horizontal(|ui| {
-        ui.label(
-            eframe::egui::RichText::new("Table 01")
-                .font(theme::sans(15.0))
-                .color(theme::TEXT),
-        );
-        ui.label(
-            eframe::egui::RichText::new("Blackjack  ·  six decks")
-                .font(theme::sans(12.0))
-                .color(theme::TEXT_DIM),
-        );
-        ui.with_layout(
-            eframe::egui::Layout::right_to_left(eframe::egui::Align::Center),
-            |ui| {
-                ui.label(
-                    eframe::egui::RichText::new("3:2  ·  S17")
-                        .font(theme::mono(12.0))
-                        .color(theme::TEXT_FAINT),
-                );
-            },
-        );
-    });
-    ui.add_space(theme::SPACE_5);
+    ui.add_space(theme::SPACE_2);
 
     let Some(hand) = &view.hand else {
         centered_note(ui, "Place a bet and deal a hand.");
diff --git a/gui/src/crash.rs b/gui/src/crash.rs
index 14197ae..08113a8 100644
--- a/gui/src/crash.rs
+++ b/gui/src/crash.rs
@@ -119,11 +119,7 @@ fn sidebar(ui: &mut Ui, view: &CrashView, fx: &mut Fx) -> Option<Command> {
                             .font(theme::sans(22.0))
                             .color(theme::TEXT),
                     );
-                    ui.label(
-                        eframe::egui::RichText::new("Rise  ·  cash out  ·  don't bust")
-                            .font(theme::sans(12.0))
-                            .color(theme::TEXT_DIM),
-                    );
+                    widgets::note(ui, "Cash out before the multiplier crashes.");
 
                     ui.add_space(theme::SPACE_5);
                     ui.label(theme::label("Bet"));
@@ -152,14 +148,6 @@ fn sidebar(ui: &mut Ui, view: &CrashView, fx: &mut Fx) -> Option<Command> {
                         ui.add_space(theme::SPACE_3);
                         widgets::error(ui, error);
                     }
-
-                    ui.add_space(theme::SPACE_4);
-                    ui.separator();
-                    ui.add_space(theme::SPACE_2);
-                    widgets::note(
-                        ui,
-                        "The crash point is server-timed. The curve here is display only.",
-                    );
                 });
         },
     );
@@ -231,29 +219,7 @@ fn status(ui: &mut Ui, view: &CrashView) {
 }
 
 fn chart(ui: &mut Ui, view: &CrashView, fx: &Fx) {
-    ui.horizontal(|ui| {
-        ui.label(
-            eframe::egui::RichText::new("Table 01")
-                .font(theme::sans(15.0))
-                .color(theme::TEXT),
-        );
-        ui.label(
-            eframe::egui::RichText::new("Crash  ·  server-timed")
-                .font(theme::sans(12.0))
-                .color(theme::TEXT_DIM),
-        );
-        ui.with_layout(
-            eframe::egui::Layout::right_to_left(eframe::egui::Align::Center),
-            |ui| {
-                ui.label(
-                    eframe::egui::RichText::new("Cash out any time before the crash")
-                        .font(theme::mono(11.0))
-                        .color(theme::TEXT_FAINT),
-                );
-            },
-        );
-    });
-    ui.add_space(theme::SPACE_4);
+    ui.add_space(theme::SPACE_2);
 
     let available = ui.available_size();
     let size = vec2(available.x, (available.y - 70.0).max(260.0));
@@ -379,15 +345,6 @@ fn chart(ui: &mut Ui, view: &CrashView, fx: &Fx) {
             }
         }
     }
-
-    ui.add_space(theme::SPACE_4);
-    ui.label(
-        eframe::egui::RichText::new(
-            "The crash point is drawn from the server; the multiplier here is display only.",
-        )
-        .font(theme::sans(11.0))
-        .color(theme::TEXT_FAINT),
-    );
 }
 
 fn map_y(plot: Rect, multiplier: f64, max_multiplier: f64) -> f32 {
diff --git a/gui/src/net.rs b/gui/src/net.rs
index d2bc7e4..7cba604 100644
--- a/gui/src/net.rs
+++ b/gui/src/net.rs
@@ -46,7 +46,6 @@ pub struct Connected {
     pub user: Option<String>,
     pub auth_error: Option<String>,
     pub fingerprint: Option<String>,
-    pub server_version: String,
     pub latest: String,
     pub url: String,
     pub elapsed_ms: f32,
@@ -162,7 +161,6 @@ fn worker(
                             user: connected.user,
                             auth_error: connected.auth_error,
                             fingerprint,
-                            server_version: connected.server_version,
                             latest: connected.latest,
                             url: connected.url,
                             elapsed_ms: connected.elapsed.as_secs_f64() as f32 * 1000.0,
diff --git a/gui/src/roulette.rs b/gui/src/roulette.rs
index c791693..0100d1e 100644
--- a/gui/src/roulette.rs
+++ b/gui/src/roulette.rs
@@ -730,11 +730,7 @@ fn sidebar(
                             .font(theme::sans(22.0))
                             .color(theme::TEXT),
                     );
-                    ui.label(
-                        eframe::egui::RichText::new("European  ·  single zero")
-                            .font(theme::sans(12.0))
-                            .color(theme::TEXT_DIM),
-                    );
+                    super::widgets::note(ui, "Pick numbers or colours, then spin.");
 
                     ui.add_space(theme::SPACE_4);
                     let wheel_size = ui.available_width().min(210.0);
@@ -906,29 +902,7 @@ fn sidebar(
 fn board(ui: &mut Ui, view: &RouletteView, fx: &Fx) -> Option<zagan_bet::client::view::Command> {
     use zagan_bet::client::view::Command;
 
-    ui.horizontal(|ui| {
-        ui.label(
-            eframe::egui::RichText::new("Table 01")
-                .font(theme::sans(15.0))
-                .color(theme::TEXT),
-        );
-        ui.label(
-            eframe::egui::RichText::new("European  ·  single zero")
-                .font(theme::sans(12.0))
-                .color(theme::TEXT_DIM),
-        );
-        ui.with_layout(
-            eframe::egui::Layout::right_to_left(eframe::egui::Align::Center),
-            |ui| {
-                ui.label(
-                    eframe::egui::RichText::new("Limits 10 – 500 Kr")
-                        .font(theme::mono(12.0))
-                        .color(theme::TEXT_FAINT),
-                );
-            },
-        );
-    });
-    ui.add_space(theme::SPACE_4);
+    ui.add_space(theme::SPACE_2);
 
     let strip_height = 104.0;
     let available = ui.available_size();
@@ -968,11 +942,9 @@ fn board(ui: &mut Ui, view: &RouletteView, fx: &Fx) -> Option<zagan_bet::client:
     });
     ui.add_space(theme::SPACE_2);
     ui.label(
-        eframe::egui::RichText::new(
-            "Click to place  ·  right or middle click takes back  ·  C clears  ·  space spins",
-        )
-        .font(theme::sans(12.0))
-        .color(theme::TEXT_FAINT),
+        eframe::egui::RichText::new("Click to place a chip  ·  right-click to take one back")
+            .font(theme::sans(12.0))
+            .color(theme::TEXT_FAINT),
     );
     command
 }
diff --git a/gui/src/slots.rs b/gui/src/slots.rs
index 6574626..d2a288a 100644
--- a/gui/src/slots.rs
+++ b/gui/src/slots.rs
@@ -109,11 +109,7 @@ fn sidebar(ui: &mut Ui, view: &SlotsView, fx: &mut Fx) -> Option<Command> {
                             .font(theme::sans(22.0))
                             .color(theme::TEXT),
                     );
-                    ui.label(
-                        eframe::egui::RichText::new("5 reels  ·  5 paylines")
-                            .font(theme::sans(12.0))
-                            .color(theme::TEXT_DIM),
-                    );
+                    widgets::note(ui, "Match three or more symbols from the left.");
 
                     ui.add_space(theme::SPACE_5);
                     ui.label(theme::label("Bet"));
@@ -128,32 +124,6 @@ fn sidebar(ui: &mut Ui, view: &SlotsView, fx: &mut Fx) -> Option<Command> {
                         ui.add_space(theme::SPACE_3);
                         widgets::error(ui, error);
                     }
-
-                    ui.add_space(theme::SPACE_4);
-                    ui.separator();
-                    ui.add_space(theme::SPACE_3);
-                    ui.label(theme::label("Paytable"));
-                    ui.add_space(theme::SPACE_2);
-                    ui.label(
-                        eframe::egui::RichText::new("Pays bet × symbol × shape")
-                            .font(theme::sans(11.0))
-                            .color(theme::TEXT_FAINT),
-                    );
-                    ui.horizontal(|ui| {
-                        ui.spacing_mut().item_spacing.x = theme::SPACE_2;
-                        for (symbol, multiplier) in zagan_bet::slots::SYMBOL_MULTIPLIERS {
-                            ui.label(
-                                eframe::egui::RichText::new(format!("{symbol}{multiplier}"))
-                                    .font(theme::mono(12.0))
-                                    .color(symbol_color(symbol)),
-                            );
-                        }
-                    });
-                    ui.label(
-                        eframe::egui::RichText::new("3×1   4×3   5×14")
-                            .font(theme::mono(12.0))
-                            .color(theme::TEXT_DIM),
-                    );
                 });
         },
     );
@@ -240,29 +210,7 @@ fn status(ui: &mut Ui, view: &SlotsView, spinning: bool) {
 }
 
 fn board(ui: &mut Ui, view: &SlotsView, fx: &Fx) {
-    ui.horizontal(|ui| {
-        ui.label(
-            eframe::egui::RichText::new("Machine 01")
-                .font(theme::sans(15.0))
-                .color(theme::TEXT),
-        );
-        ui.label(
-            eframe::egui::RichText::new("5 reels  ·  5 paylines")
-                .font(theme::sans(12.0))
-                .color(theme::TEXT_DIM),
-        );
-        ui.with_layout(
-            eframe::egui::Layout::right_to_left(eframe::egui::Align::Center),
-            |ui| {
-                ui.label(
-                    eframe::egui::RichText::new("Bet 10 – 500 Kr")
-                        .font(theme::mono(12.0))
-                        .color(theme::TEXT_FAINT),
-                );
-            },
-        );
-    });
-    ui.add_space(theme::SPACE_5);
+    ui.add_space(theme::SPACE_2);
 
     let now = ui.input(|input| input.time);
     let spinning = fx.spinning(view, now);