From 4fcf33370735ff26a1586cdf5453fed4ab314d85 Mon Sep 17 00:00:00 2001
From: Hikari <hikari@nhcarrigan.com>
Date: Thu, 19 Mar 2026 12:21:51 -0700
Subject: [PATCH] feat: document upgrade stacking behaviour as multiplicative
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Adds an inline note to the upgrade panel and updates the About
panel's Upgrades entry to explicitly state that multipliers stack
multiplicatively (two ×2 upgrades give ×4, not ×3).

Closes #60
---
 apps/web/src/components/game/aboutPanel.tsx   | 5 ++++-
 apps/web/src/components/game/upgradePanel.tsx | 4 ++++
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/apps/web/src/components/game/aboutPanel.tsx b/apps/web/src/components/game/aboutPanel.tsx
index 12785d1..8b63dfb 100644
--- a/apps/web/src/components/game/aboutPanel.tsx
+++ b/apps/web/src/components/game/aboutPanel.tsx
@@ -31,7 +31,10 @@ const howToPlay = [
     body:
       "Purchase upgrades to multiply the gold and essence output of specific"
       + " adventurer tiers, or boost your whole guild. Upgrades are permanent"
-      + " for the current run and compound with each other.",
+      + " for the current run and stack multiplicatively — two ×2 upgrades"
+      + " targeting the same adventurer combine to give ×4, not ×3. Global"
+      + " upgrades multiply on top of adventurer-specific ones, so stacking"
+      + " both types compounds the effect significantly.",
     title: "🔧 Upgrades",
   },
   {
diff --git a/apps/web/src/components/game/upgradePanel.tsx b/apps/web/src/components/game/upgradePanel.tsx
index 03e4bf9..19a9117 100644
--- a/apps/web/src/components/game/upgradePanel.tsx
+++ b/apps/web/src/components/game/upgradePanel.tsx
@@ -261,6 +261,10 @@ const UpgradePanel = (): JSX.Element => {
         {upgrades.length}
         {" purchased"}
       </p>
+      <p className="upgrade-stacking-note">
+        {"💡 Upgrade multipliers stack multiplicatively — two ×2 upgrades"
+          + " combine to give ×4, not ×3."}
+      </p>
       {upgrades.length === 0
         ? <p className="empty-state">
           {"No upgrades available yet — keep adventuring!"}