feat: initial prototype — core game systems (#30)

## Summary This PR represents the full v1 prototype, implementing the core game systems for Elysium. - Full idle/clicker RPG loop: resource collection, crafting, boss fights, exploration, and quests - Adventurer hiring with batch size selector and progressive tier cost scaling - Prestige, transcendence, and apotheosis systems with auto-prestige support - Character sheet, titles, leaderboards, companion system, and daily login bonuses - Auto-quest and auto-boss toggles - Discord webhook notifications on prestige/transcendence/apotheosis - Discord role awarded on apotheosis - Responsive design and overarching story/lore system - In-game sound effects and browser notifications for key events - Support link button in the resource bar - Full test coverage (100% on `apps/api` and `packages/types`) - CI pipeline: lint → build → test ## Closes Closes #1 Closes #2 Closes #3 Closes #4 Closes #5 Closes #6 Closes #7 Closes #8 Closes #9 Closes #10 Closes #11 Closes #12 Closes #13 Closes #14 Closes #16 Closes #19 Closes #20 Closes #21 Closes #22 Closes #23 Closes #24 Closes #25 Closes #26 Closes #27 Closes #29 ✨ This issue was created with help from Hikari~ 🌸 Co-authored-by: Naomi Carrigan <commits@nhcarrigan.com> Reviewed-on: #30 Co-authored-by: Hikari <hikari@nhcarrigan.com> Co-committed-by: Hikari <hikari@nhcarrigan.com>
2026-03-08 15:53:39 -07:00
parent c69e155de3
commit 29c817230d
172 changed files with 50706 additions and 0 deletions
@@ -0,0 +1,92 @@
+/**
+ * @file Offline earnings calculator for gold and essence accrued while logged out.
+ * @copyright nhcarrigan
+ * @license Naomi's Public License
+ * @author Naomi Carrigan
+ */
+/* eslint-disable max-lines-per-function -- Offline earnings calculation requires iterating all adventurers with multi-step math */
+import type { GameState } from "@elysium/types";
+
+/**
+ * Maximum offline accrual cap: 8 hours.
+ */
+const maxOfflineSeconds = 8 * 60 * 60;
+
+/**
+ * Calculates the gold and essence earned whilst the player was offline.
+ * Capped at 8 hours to prevent exploit via system clock manipulation.
+ * Applies the same multipliers as the client-side tick engine.
+ * @param state - The current game state to calculate offline earnings from.
+ * @param nowMs - The current timestamp in milliseconds.
+ * @returns The gold, essence, and elapsed seconds earned offline.
+ */
+const calculateOfflineEarnings = (
+  state: GameState,
+  nowMs: number,
+): { offlineGold: number; offlineEssence: number; offlineSeconds: number } => {
+  const elapsedSeconds = Math.min(
+    (nowMs - state.lastTickAt) / 1000,
+    maxOfflineSeconds,
+  );
+
+  // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- Defensive check for runtime nullable fields
+  const equipmentGoldMultiplier = (state.equipment ?? []).
+    filter((item) => {
+      return item.equipped;
+    }).
+    reduce((mult, item) => {
+      return mult * (item.bonus.goldMultiplier ?? 1);
+    }, 1);
+
+  const runestonesIncome = state.prestige.runestonesIncomeMultiplier ?? 1;
+  const runestonesEssence = state.prestige.runestonesEssenceMultiplier ?? 1;
+
+  let goldPerSecond = 0;
+  let essencePerSecond = 0;
+
+  for (const adventurer of state.adventurers) {
+    if (!adventurer.unlocked || adventurer.count === 0) {
+      continue;
+    }
+
+    const upgradeMultiplier = state.upgrades.
+      filter((upgrade) => {
+        const isGlobal = upgrade.target === "global";
+        const isForAdventurer
+          = upgrade.target === "adventurer"
+          && upgrade.adventurerId === adventurer.id;
+        const affectsAdventurer = isGlobal || isForAdventurer;
+        return upgrade.purchased && affectsAdventurer;
+      }).
+      reduce((mult, upgrade) => {
+        return mult * upgrade.multiplier;
+      }, 1);
+
+    const prestige = state.prestige.productionMultiplier;
+
+    const goldContribution
+      = adventurer.goldPerSecond
+      * adventurer.count
+      * upgradeMultiplier
+      * prestige
+      * runestonesIncome
+      * equipmentGoldMultiplier;
+    goldPerSecond = goldPerSecond + goldContribution;
+
+    const essenceContribution
+      = adventurer.essencePerSecond
+      * adventurer.count
+      * upgradeMultiplier
+      * prestige
+      * runestonesEssence;
+    essencePerSecond = essencePerSecond + essenceContribution;
+  }
+
+  return {
+    offlineEssence: essencePerSecond * elapsedSeconds,
+    offlineGold:    goldPerSecond * elapsedSeconds,
+    offlineSeconds: elapsedSeconds,
+  };
+};
+
+export { calculateOfflineEarnings };