Release Healer Man 0.1.43

src/game/BossTestingBridge.tsx

@@ -0,0 +1,27 @@
+import { useEffect } from "react";
+import { useCombatStore } from "./combatStore";
+import { useGameStore } from "./store";
+
+export function bossTestIsDefeated(): boolean {
+  const test = useGameStore.getState().bossTest;
+  const mobs = useCombatStore.getState().mobs;
+  return Boolean(test?.runtimeIds.length && test.runtimeIds.every((id) => mobs[id]?.dead));
+}
+
+export function BossTestingBridge() {
+  useEffect(() => {
+    let defeated = false;
+    const observe = () => {
+      const next = bossTestIsDefeated();
+      if (next && !defeated) useGameStore.getState().openOverlay("boss-test-review");
+      defeated = next;
+    };
+    const unsubscribeCombat = useCombatStore.subscribe(observe);
+    const unsubscribeGame = useGameStore.subscribe((state, previous) => {
+      if (state.encounterResetRevision !== previous.encounterResetRevision || state.bossTest !== previous.bossTest) defeated = false;
+    });
+    observe();
+    return () => { unsubscribeCombat(); unsubscribeGame(); };
+  }, []);
+  return null;
+}

src/game/CombatBridge.tsx

@@ -40,7 +40,7 @@ export function CombatBridge() {
 
   useEffect(() => {
     if (!character) return;
-    useCombatStore.getState().initializeCharacter({ ...character, role: activeRole });
+    useCombatStore.getState().initializeCharacter({ ...character, bossCards: useShellStore.getState().bossCards, role: activeRole });
     useCombatStore.getState().synchronizeActors();
     if (gameMode === "manastorm") {
       activateManastormActiveSpellLoadout(
@@ -66,12 +66,14 @@ export function CombatBridge() {
   useEffect(() => {
     if (!character) return;
     const characterId = character.id;
+    const ownerId = useShellStore.getState().session?.ownerId;
     const unsubscribe = useCombatStore.subscribe((state, previousState) => {
       // Save APIs intentionally target the active character. Avoid persisting a
       // final combat notification during the render-to-effect-cleanup window
       // after Character Select has already replaced the active character.
       const shell = useShellStore.getState();
-      if (shell.activeCharacter?.id !== characterId) return;
+      if (shell.activeCharacter?.id !== characterId || shell.session?.ownerId !== ownerId) return;
+      if (useGameStore.getState().bossTest) return;
 
       // Persisted collections are replaced immutably by combat actions. A
       // reference/primitive comparison therefore detects the same changes as
@@ -101,7 +103,7 @@ export function CombatBridge() {
         shell.saveActiveInventory(state.inventory);
       }
       if (state.bossCards !== previousState.bossCards) {
-        shell.saveActiveBossCards(state.bossCards);
+        shell.saveAccountBossCards(state.bossCards);
       }
       if (state.equipment !== previousState.equipment) {
         shell.saveActiveEquipment(state.equipment);

src/game/OnlineSessionBridge.tsx

@@ -246,6 +246,7 @@ function applyRelayEvent(
 }
 
 export function OnlineSessionBridge() {
+  const bossTest = useGameStore((state) => state.bossTest);
   const session = useShellStore((state) => state.session);
   const activeActivity = useOnlineGroupStore((state) => state.activeActivity);
   const group = useOnlineGroupStore((state) => state.snapshot.group);
@@ -256,7 +257,7 @@ export function OnlineSessionBridge() {
   const applyingRef = useRef(false);
 
   useEffect(() => {
-    if (!session?.accessToken || !activeActivity || !group) {
+    if (bossTest || !session?.accessToken || !activeActivity || !group) {
       configureOnlineSessionRuntime({ active: false, authority: true, localAccountId: null });
       reset();
       return undefined;
@@ -362,7 +363,7 @@ export function OnlineSessionBridge() {
       configureOnlineSessionRuntime({ active: false, authority: true, localAccountId: null });
       reset();
     };
-  }, [accept, activeActivity?.id, fail, group?.id, group?.leaderAccountId, reset, session?.accessToken, session?.ownerId]);
+  }, [accept, activeActivity?.id, bossTest, fail, group?.id, group?.leaderAccountId, reset, session?.accessToken, session?.ownerId]);
 
   return null;
 }

src/game/bossCards.ts

@@ -49,6 +49,35 @@ export function normalizeBossCardCollection(value: unknown): BossCardCollection
   return { counts, lastClaims };
 }
 
+/** Sum independent legacy character logs; max reconciles copies of the same account log. */
+export function mergeBossCardCollections(collections: readonly unknown[], mode: "sum" | "max" = "max"): BossCardCollection {
+  const counts: Record<string, BossCardCounts> = Object.create(null);
+  const lastClaims: Record<string, string> = Object.create(null);
+  for (const value of collections) {
+    const collection = normalizeBossCardCollection(value);
+    for (const [bossKey, entry] of Object.entries(collection.counts)) {
+      const merged = counts[bossKey] ??= {};
+      for (const rarity of BOSS_CARD_RARITIES) {
+        const count = entry[rarity];
+        if (count === undefined) continue;
+        merged[rarity] = mode === "sum"
+          ? Math.min(Number.MAX_SAFE_INTEGER, (merged[rarity] ?? 0) + count)
+          : Math.max(merged[rarity] ?? 0, count);
+      }
+    }
+    for (const [spawnId, claim] of Object.entries(collection.lastClaims)) {
+      const previous = lastClaims[spawnId];
+      if (!previous) { lastClaims[spawnId] = claim; continue; }
+      if (/^\d+:/.test(previous) && /^\d+:/.test(claim)) {
+        const [previousTime, previousRevision] = previous.split(":").map(Number);
+        const [time, revision] = claim.split(":").map(Number);
+        if (time > previousTime || (time === previousTime && revision > previousRevision)) lastClaims[spawnId] = claim;
+      } else if (claim > previous) lastClaims[spawnId] = claim;
+    }
+  }
+  return { counts, lastClaims };
+}
+
 /** Independent bonus rolls; Normal is always awarded, including with all three bonuses. */
 export function rollBossCards(random: () => number = Math.random): readonly BossCardRarity[] {
   return BOSS_CARD_RARITIES.filter((rarity) => {

src/game/bossTesting.test.ts

@@ -0,0 +1,82 @@
+import { afterEach, describe, expect, it } from "vitest";
+import { buildBossTestingCatalog, BOSS_TESTING_CATALOG, createBossTestingRoom, randomTestingBoss } from "./bossTesting";
+import { clearBossTestingDungeons, DUNGEON_DEFINITIONS, registerBossTestingDungeon, requireDungeonDefinition } from "./dungeonRegistry";
+import { activateDungeonSession, restartActiveDungeonSession } from "./dungeonSession";
+import { useGameStore } from "./store";
+import { useCombatStore } from "./combatStore";
+import { bossTestIsDefeated } from "./BossTestingBridge";
+import type { DungeonDefinition } from "./dungeonTypes";
+
+afterEach(() => {
+  useGameStore.getState().activateDungeon("wailing-caverns");
+  clearBossTestingDungeons();
+});
+
+describe("Boss Testing", () => {
+  const boss = BOSS_TESTING_CATALOG.find((entry) => entry.dungeonId === "wailing-caverns" && entry.name === "Lady Anacondra")!;
+  const source = requireDungeonDefinition(boss.dungeonId);
+
+  it("includes unready and event-only bosses and isolates catalog changes from shipped content", () => {
+    const blocked: DungeonDefinition = { ...source, availability: "blocked", staticSpawns: [], roamingPacks: [],
+      encounterSpawnGroups: [{ id: "event", spawns: [boss.spawn] }], entities: { [boss.entityId]: source.entities[boss.entityId] } };
+    expect(buildBossTestingCatalog([blocked])).toHaveLength(1);
+    const count = DUNGEON_DEFINITIONS.length;
+    const room = createBossTestingRoom(source, boss);
+    registerBossTestingDungeon(room.definition, source.id);
+    expect(requireDungeonDefinition(source.id)).toBe(source);
+    expect(DUNGEON_DEFINITIONS).toHaveLength(count);
+    expect(room.definition.staticSpawns).toHaveLength(1);
+    expect(room.definition.roamingPacks).toEqual([]);
+    expect(room.definition.entities[boss.entityId].combat).toEqual(source.entities[boss.entityId].combat);
+    expect(room.definition.staticSpawns[0].position).toEqual(boss.spawn.position);
+    expect(room.definition.assets).toEqual({ visual: [], collision: [] });
+  });
+
+  it("preserves boss phases and scripted summons without spawning unrelated dungeon packs", () => {
+    const fixture: DungeonDefinition = { ...source, encounters: [
+      { id: "boss-mechanics", dungeonId: source.id, initialPhase: "idle", rules: [{ id: "adds", trigger: { kind: "entity-health", entityId: boss.spawn.id, atOrBelowPercent: 50 },
+        actions: [{ id: "summon", kind: "activate-spawn-group", spawnGroupId: "boss-adds" }, { id: "loot", kind: "grant-loot", lootTableId: "test" }] }] },
+      { id: "other-boss", dungeonId: source.id, initialPhase: "idle", rules: [{ id: "other", trigger: { kind: "entity-engaged", entityId: "unrelated" }, actions: [] }] },
+    ], encounterSpawnGroups: [{ id: "boss-adds", spawns: [{ ...boss.spawn, id: "add", entityId: boss.entityId }] }, { id: "trash", spawns: [] }] };
+    const room = createBossTestingRoom(fixture, boss);
+    expect(room.definition.encounters?.map((entry) => entry.id)).toEqual([`${room.definition.id}:boss-mechanics`]);
+    expect(room.definition.encounters?.[0].dungeonId).toBe(room.definition.id);
+    expect(room.definition.encounters?.[0].rules[0].actions).toEqual([{ id: "summon", kind: "activate-spawn-group", spawnGroupId: "boss-adds" }]);
+    expect(room.definition.encounterSpawnGroups?.map((entry) => entry.id)).toEqual(["boss-adds"]);
+    expect(room.definition.staticSpawns).toHaveLength(1);
+  });
+
+  it("starts an unready boss room, survives scene retries, and retains testing mode when restarted", () => {
+    const room = createBossTestingRoom(source, boss);
+    registerBossTestingDungeon(room.definition, source.id);
+    expect(activateDungeonSession(room.definition.id)).toBe(false);
+    expect(activateDungeonSession(room.definition.id, undefined, { gmTestMode: true, bossTest: room.session })).toBe(true);
+    expect(restartActiveDungeonSession()).toBe(true);
+    useGameStore.getState().resetAtEntrance();
+    expect(useGameStore.getState()).toMatchObject({ gmTestMode: true, bossTest: room.session, overlay: null });
+  });
+
+  it("recognizes actual boss deaths and awards no progression or collectible rewards", () => {
+    const room = createBossTestingRoom(source, boss);
+    registerBossTestingDungeon(room.definition, source.id);
+    useGameStore.getState().activateDungeon(room.definition.id, undefined, { bossTest: room.session, gmTestMode: true });
+    useCombatStore.getState().initializeCharacter({ classId: "mage", level: 20 });
+    expect(bossTestIsDefeated()).toBe(false);
+    useCombatStore.getState().registerMob(boss.spawn.id, { name: boss.name, boss: true, maxHealth: 10, xpReward: 500, hasLoot: true, lootSourceId: boss.entityId });
+    const xp = useCombatStore.getState().xp;
+    useCombatStore.getState().damageMob(boss.spawn.id, 100000, Date.now());
+    expect(bossTestIsDefeated()).toBe(true);
+    const combat = useCombatStore.getState();
+    expect(combat.xp).toBe(xp);
+    expect(combat.mobs[boss.spawn.id]).toMatchObject({ hasLoot: false, pendingLoot: [] });
+    expect(combat.mobs[boss.spawn.id].bossCardDrop).toBeFalsy();
+  });
+
+  it("draws a boss only from the selected filters and handles empty queues", () => {
+    expect(randomTestingBoss([], () => 0.5)).toBeNull();
+    const candidates = BOSS_TESTING_CATALOG.slice(0, 2);
+    expect(randomTestingBoss(candidates, () => 0)).toBe(candidates[0]);
+    expect(randomTestingBoss(candidates, () => 1)).toBe(candidates[1]);
+    expect(randomTestingBoss(candidates, () => Number.NaN)).toBe(candidates[0]);
+  });
+});

src/game/bossTesting.ts

@@ -0,0 +1,123 @@
+import { DUNGEON_DEFINITIONS } from "./dungeonRegistry";
+import type { DungeonDefinition, Vector3Tuple } from "./dungeonTypes";
+import type { StaticMobSpawnDefinition } from "./mobPopulation";
+import type { BossTestSession } from "./store";
+
+export interface TestableBoss {
+  readonly key: string;
+  readonly name: string;
+  readonly dungeonId: string;
+  readonly dungeonTitle: string;
+  readonly entityId: string;
+  readonly category: "wow" | "rom";
+  readonly spawn: StaticMobSpawnDefinition;
+}
+
+export function buildBossTestingCatalog(definitions: readonly DungeonDefinition[]): readonly TestableBoss[] {
+  return definitions.flatMap((dungeon) => Object.values(dungeon.entities).flatMap((entity): TestableBoss[] => {
+    if (entity.kind !== "boss") return [];
+    const spawn = dungeon.staticSpawns.find((candidate) => candidate.entityId === entity.id)
+      ?? dungeon.encounterSpawnGroups?.flatMap((group) => group.spawns).find((candidate) => candidate.entityId === entity.id);
+    const objective = dungeon.bosses.find((boss) => boss.id === spawn?.id || boss.name === entity.name);
+    const pack = dungeon.roamingPacks.find((candidate) => candidate.members.some((member) => member.entityId === entity.id));
+    const member = pack?.members.find((candidate) => candidate.entityId === entity.id);
+    const position = spawn?.position ?? objective?.position ?? pack?.waypoints[0];
+    if (!position) return [];
+    return [{
+      key: `${dungeon.id}/${entity.id}`, name: entity.name, dungeonId: dungeon.id,
+      dungeonTitle: dungeon.title, entityId: entity.id,
+      category: dungeon.expansion === "runewaker" ? "rom" : "wow",
+      spawn: { ...spawn, id: spawn?.id ?? (pack && member ? `${pack.id}:${member.id}` : objective?.id ?? entity.id),
+        entityId: entity.id, position, spawnChance: 1 },
+    }];
+  })).sort((a, b) => a.name.localeCompare(b.name) || a.dungeonTitle.localeCompare(b.dungeonTitle));
+}
+
+export const BOSS_TESTING_CATALOG = buildBossTestingCatalog(DUNGEON_DEFINITIONS);
+
+export function randomTestingBoss(bosses: readonly TestableBoss[], random: () => number = Math.random): TestableBoss | null {
+  if (!bosses.length) return null;
+  const draw = random();
+  const index = Math.floor((Number.isFinite(draw) ? Math.max(0, Math.min(0.999999999, draw)) : 0) * bosses.length);
+  return bosses[index];
+}
+
+function references(value: unknown, ids: ReadonlySet<string>): boolean {
+  if (typeof value === "string") return ids.has(value);
+  if (Array.isArray(value)) return value.some((entry) => references(entry, ids));
+  return Boolean(value && typeof value === "object" && Object.values(value).some((entry) => references(entry, ids)));
+}
+
+function remapEncounterReferences<T>(value: T, ids: ReadonlyMap<string, string>): T {
+  if (typeof value === "string") return (ids.get(value) ?? value) as T;
+  if (Array.isArray(value)) return value.map((entry) => remapEncounterReferences(entry, ids)) as T;
+  if (value && typeof value === "object") return Object.fromEntries(Object.entries(value)
+    .map(([key, entry]) => [key, remapEncounterReferences(entry, ids)])) as T;
+  return value;
+}
+
+/** Keep original mechanic coordinates and spawn IDs while replacing the environment with a clear floor. */
+export function createBossTestingRoom(source: DungeonDefinition, boss: TestableBoss): {
+  readonly definition: DungeonDefinition;
+  readonly session: BossTestSession;
+} {
+  const entity = source.entities[boss.entityId];
+  if (source.id !== boss.dungeonId || entity?.kind !== "boss") throw new Error("That boss is unavailable.");
+  const id = `boss-testing:${source.id}:${boss.entityId}`;
+  const ids = new Set([boss.entityId, boss.spawn.id]);
+  const sourceEncounters = (source.encounters ?? []).filter((encounter) =>
+    references(encounter.rules.map((rule) => rule.trigger), ids)
+    || references(entity.combat, new Set([encounter.id]))
+  );
+  const encounterIds = new Map(sourceEncounters.map((encounter) => [encounter.id, `${id}:${encounter.id}`]));
+  const encounters = sourceEncounters.map((encounter) => {
+    const isolated = remapEncounterReferences(encounter, encounterIds);
+    return { ...isolated, id: encounterIds.get(encounter.id)!, dungeonId: id,
+      rules: isolated.rules.map((rule) => ({ ...rule, actions: rule.actions.filter((action) =>
+        action.kind !== "grant-loot" && action.kind !== "set-checkpoint"
+      ) })),
+    };
+  });
+  const groups = (source.encounterSpawnGroups ?? []).filter((group) => references(encounters, new Set([group.id])));
+  const objects = source.serverGameObjects.filter((object) => references(encounters, new Set([object.id, object.interaction?.signalId ?? ""])));
+  const entityIds = new Set([boss.entityId, ...groups.flatMap((group) => group.spawns.map((spawn) => spawn.entityId))]);
+  // Summoned creature definitions are needed even though they are absent from the initial room.
+  for (const entityId of entityIds) {
+    for (const attack of source.entities[entityId]?.combat?.attacks ?? []) {
+      for (const effect of attack.effect ? [attack.effect] : []) {
+        if (effect.kind !== "summon") continue;
+        for (const candidate of Object.values(source.entities)) {
+          if (candidate.id === effect.entityId || candidate.combat?.serverEntry === effect.creatureEntry) entityIds.add(candidate.id);
+        }
+      }
+    }
+  }
+  const center = boss.spawn.position;
+  const radius = Math.max(40, ...groups.flatMap((group) => group.spawns.map((spawn) =>
+    Math.hypot(spawn.position[0] - center[0], spawn.position[2] - center[2]) + 8
+  )), ...objects.map((object) => Math.hypot(object.position[0] - center[0], object.position[2] - center[2]) + 8));
+  const spawnDistance = Math.max(14, (entity.combat?.aggroRange ?? 12) + 5);
+  const entrance: Vector3Tuple = [center[0], center[1], center[2] + Math.min(radius - 5, spawnDistance)];
+  const spawn = { ...boss.spawn, spawnMask: undefined, spawnChance: 1 };
+  const objective = { id: spawn.id, name: boss.name, position: center };
+  return {
+    session: { key: boss.key, name: boss.name, sourceDungeonId: source.id, entityId: boss.entityId, runtimeIds: [spawn.id] },
+    definition: {
+      ...source, id, title: `${boss.name} — Boss Testing`, availability: "available",
+      assets: { visual: [], collision: [] },
+      bounds: { min: [center[0] - radius, center[1] - 2, center[2] - radius], max: [center[0] + radius, center[1] + 24, center[2] + radius] },
+      entrance: { name: "Testing room", footPosition: entrance, yaw: Math.PI, forward: [0, 0, -1] },
+      areas: [{ id: "testing-room", name: "Boss Testing", center, radius: radius * 2 }],
+      entities: Object.fromEntries([...entityIds].filter((entityId) => source.entities[entityId])
+        .map((entityId) => [entityId, remapEncounterReferences(source.entities[entityId], encounterIds)])),
+      staticSpawns: [spawn], roamingPacks: [], bosses: [objective], objectiveOrder: [objective],
+      navigationLinks: [], traversalRamps: [], encounters, encounterSpawnGroups: groups, serverGameObjects: objects,
+      presentation: { ...source.presentation, location: "Boss Testing", summary: "An isolated room for testing boss mechanics.",
+        loadingMessage: `Preparing ${boss.name}…`, background: "#111923",
+        fog: { color: "#111923", near: radius, far: radius * 3 },
+        ambientLight: { color: "#ffffff", intensity: 1.2 },
+        hemisphereLight: { skyColor: "#c8ddf0", groundColor: "#444c57", intensity: 1.4 },
+        map: { width: 600, height: 600, padding: 20, contours: [] } },
+    },
+  };
+}

src/game/combatStore.ts

@@ -2631,15 +2631,16 @@ function damageMobInWork(
   const health = mob.health - applied;
   const killed = health <= 0;
   const canPlayWoundAnimation = !killed && now >= mob.nextWoundAnimationAt;
-  const canAward = killed && !mob.experienceGranted;
+  const testing = Boolean(useGameStore.getState().bossTest);
+  const canAward = killed && !mob.experienceGranted && !testing;
   const beforeLevel = work.progression.level;
-  const pendingLoot = killed && mob.lootSourceId
+  const pendingLoot = testing ? [] : killed && mob.lootSourceId
     ? rollBossLoot(mob.lootSourceId, beforeLevel, {
       now,
       bonusItemChance: mob.bonusLootChance,
     })
     : mob.pendingLoot;
-  const card = killed && mob.boss
+  const card = killed && mob.boss && !testing
     ? bossCardForSource(mob.lootSourceId ?? mob.id, useGameStore.getState().activeDungeonId, mob.name)
     : null;
   const bossCardDrop = card ? {
@@ -2648,7 +2649,7 @@ function damageMobInWork(
     claimId: `${now}:${mob.deathRevision + 1}:${mob.id}`,
     rarities: rollBossCards(),
   } satisfies BossCardDrop : mob.bossCardDrop;
-  const hasLoot = killed ? mob.hasLoot || pendingLoot.length > 0 || Boolean(bossCardDrop) : mob.hasLoot;
+  const hasLoot = testing ? false : killed ? mob.hasLoot || pendingLoot.length > 0 || Boolean(bossCardDrop) : mob.hasLoot;
   const xpAwarded = canAward ? grantMobExperience(classId, work, mob.xpReward) : 0;
   engageMobGroupInWork(work, id, now, source.actorId);
   const engagedMob = work.mobs[id] ?? mob;

src/game/dungeonRegistry.ts

@@ -199,8 +199,27 @@ export type DungeonId = string;
 
 export const DUNGEON_DEFINITIONS = Object.freeze(Object.values(DUNGEON_REGISTRY));
 
+// Test rooms are session-only definitions; the shipped dungeon catalog stays immutable.
+const bossTestingDefinitions = new Map<string, { definition: DungeonDefinition; sourceDungeonId: string }>();
+
+export function registerBossTestingDungeon(definition: DungeonDefinition, sourceDungeonId: string): void {
+  if (!definition.id.startsWith("boss-testing:") || !DUNGEON_REGISTRY[sourceDungeonId]) {
+    throw new Error("Invalid boss testing dungeon.");
+  }
+  bossTestingDefinitions.clear();
+  bossTestingDefinitions.set(definition.id, { definition, sourceDungeonId });
+}
+
+export function bossTestingSourceDungeonId(id: string): string | null {
+  return bossTestingDefinitions.get(id)?.sourceDungeonId ?? null;
+}
+
+export function clearBossTestingDungeons(): void {
+  bossTestingDefinitions.clear();
+}
+
 export function dungeonDefinitionById(id: string): DungeonDefinition | null {
-  return DUNGEON_REGISTRY[id] ?? null;
+  return bossTestingDefinitions.get(id)?.definition ?? DUNGEON_REGISTRY[id] ?? null;
 }
 
 export function requireDungeonDefinition(id: string): DungeonDefinition {

src/game/dungeonSession.ts

@@ -5,8 +5,8 @@ import { clearMobRuntimeRegistry } from "./mobRuntimeRegistry";
 import { clearPartyRuntimeRegistry } from "./partyRuntimeRegistry";
 import { resetPartyRuntimeClock } from "./partyRuntime";
 import { usePartyStore } from "./partyStore";
-import { useGameStore, type GameMode } from "./store";
-import { dungeonCanEnter, dungeonDefinitionById, type DungeonId } from "./dungeonRegistry";
+import { useGameStore, type BossTestSession, type GameMode } from "./store";
+import { bossTestingSourceDungeonId, dungeonCanEnter, dungeonDefinitionById, type DungeonId } from "./dungeonRegistry";
 import type { WorldSpawn } from "./dungeonTypes";
 import type { GmReviewTarget } from "./gmContentReview";
 import { shelvedDungeonSpawn } from "@shelvedDungeonSession";
@@ -27,6 +27,7 @@ export interface DungeonSessionOptions {
   readonly gameMode?: GameMode;
   readonly spawn?: WorldSpawn;
   readonly gmTestMode?: boolean;
+  readonly bossTest?: BossTestSession | null;
   readonly gmReviewTarget?: GmReviewTarget | null;
   /** Used by in-game encounter transitions so character progression and inventory survive. */
   readonly preserveCharacter?: boolean;
@@ -47,7 +48,10 @@ export function activateDungeonSession(
   options: DungeonSessionOptions = {},
 ): boolean {
   const definition = dungeonDefinitionById(dungeonId);
-  if (!definition || !dungeonCanEnter(dungeonId) || !dungeonContentIsUsable(dungeonId)) {
+  const testingSource = bossTestingSourceDungeonId(dungeonId);
+  const testing = Boolean(testingSource && options.gmTestMode && options.bossTest?.sourceDungeonId === testingSource);
+  if (!definition || (!testing && !dungeonCanEnter(dungeonId))
+    || !dungeonContentIsUsable(testing ? testingSource! : dungeonId)) {
     return false;
   }
   if ((difficultyId !== undefined && !definition.difficultyVariants.some((variant) => variant.id === difficultyId))
@@ -107,6 +111,7 @@ export function activateDungeonSession(
     gameMode: options.gameMode,
     spawn: shelvedDungeonSpawn(dungeonId, options.spawn),
     gmTestMode: options.gmTestMode,
+    bossTest: options.bossTest,
     gmReviewTarget: options.gmReviewTarget,
     bossDifficulty,
   });
@@ -128,6 +133,7 @@ export function restartActiveDungeonSession(): boolean {
     gameMode: game.gameMode,
     spawn: game.activeSpawn,
     gmTestMode: game.gmTestMode,
+    bossTest: game.bossTest,
     gmReviewTarget: game.activeGmReviewTarget,
     preserveCharacter: true,
     bossDifficulty: game.activeBossDifficulty,

src/game/store.ts

@@ -9,7 +9,15 @@ import { validBossDifficulty } from "./dungeonDifficulty";
 export type AssetStatus = "checking" | "loading" | "ready" | "proxy" | "error";
 export type InputMode = "keyboard" | "gamepad";
 export type GameMode = "dungeon" | "manastorm";
-export type GameOverlay = "pause" | "report-issue" | "party" | "inventory" | "boss-cards" | "map" | "boss-guide" | "spellbook" | "talents" | "bindings" | "options" | "ui-layout" | "keybinds" | "gm" | "dungeon-results" | null;
+export type GameOverlay = "pause" | "boss-test-review" | "report-issue" | "party" | "inventory" | "boss-cards" | "map" | "boss-guide" | "spellbook" | "talents" | "bindings" | "options" | "ui-layout" | "keybinds" | "gm" | "dungeon-results" | null;
+
+export interface BossTestSession {
+  readonly key: string;
+  readonly name: string;
+  readonly sourceDungeonId: string;
+  readonly entityId: string;
+  readonly runtimeIds: readonly string[];
+}
 
 interface PlayerSnapshot {
   position: Vector3Tuple;
@@ -24,6 +32,7 @@ export interface GameState {
   activeBossDifficulty: number;
   gameMode: GameMode;
   gmTestMode: boolean;
+  bossTest: BossTestSession | null;
   activeGmReviewTarget: GmReviewTarget | null;
   activeSpawn: WorldSpawn;
   sessionRevision: number;
@@ -55,6 +64,7 @@ export interface GameState {
       readonly gameMode?: GameMode;
       readonly spawn?: WorldSpawn;
       readonly gmTestMode?: boolean;
+      readonly bossTest?: BossTestSession | null;
       readonly gmReviewTarget?: GmReviewTarget | null;
       readonly bossDifficulty?: number;
     },
@@ -88,6 +98,7 @@ export const useGameStore = create<GameState>((set) => ({
   activeBossDifficulty: 1,
   gameMode: "dungeon",
   gmTestMode: false,
+  bossTest: null,
   activeGmReviewTarget: null,
   activeSpawn: { footPosition: entrance.footPosition, yaw: entrance.yaw },
   sessionRevision: 0,
@@ -125,6 +136,7 @@ export const useGameStore = create<GameState>((set) => ({
       activeBossDifficulty: validBossDifficulty(options?.bossDifficulty) ? options.bossDifficulty : 1,
       gameMode: options?.gameMode ?? "dungeon",
       gmTestMode: options?.gmTestMode ?? false,
+      bossTest: options?.bossTest ?? null,
       activeGmReviewTarget: options?.gmReviewTarget ?? null,
       activeSpawn,
       sessionRevision: state.sessionRevision + 1,
@@ -279,7 +291,7 @@ export const useGameStore = create<GameState>((set) => ({
     const activeSpawn = { footPosition: activeEntrance.footPosition, yaw: activeEntrance.yaw };
     return {
       gameMode: "dungeon",
-      gmTestMode: false,
+      gmTestMode: Boolean(state.bossTest),
       activeGmReviewTarget: null,
       activeSpawn,
       overlay: null,

src/game/uiLayout.test.ts

@@ -2,9 +2,30 @@ import { describe, expect, it } from "vitest";
 import {
   actionKeyForEvent, assignDesktopAbility, bindDesktopSlot, defaultUiLayout, desktopSlotForKey,
   exportUiPreferences, importUiPreferences, normalizeActionKey, normalizeUiPreferences, resetDesktopAbilities, resolveDpsMeterDisplay,
+  HUD_ELEMENTS, resolveHudScreen,
 } from "./uiLayout";
 
 describe("personal UI layouts", () => {
+  it("assigns every element one display, saves routing, and keeps single-display widgets available", () => {
+    const preferences = normalizeUiPreferences(null);
+    const layout = preferences.current.mobile;
+    expect(resolveHudScreen("party", layout, true)).toBe("top");
+    for (const id of ["actions", "player", "cast", "experience"] as const) expect(resolveHudScreen(id, layout, true)).toBe("bottom");
+    for (const id of Object.keys(HUD_ELEMENTS) as (keyof typeof HUD_ELEMENTS)[]) {
+      layout.elements[id].screen = "bottom";
+      expect(resolveHudScreen(id, layout, true)).toBe("bottom");
+      expect(resolveHudScreen(id, layout, false)).toBe("top");
+      if (id === "dps") {
+        expect(resolveDpsMeterDisplay(layout, false)).toBe("main");
+        expect(resolveDpsMeterDisplay(layout, true)).toBe("companion");
+      }
+      layout.elements[id].screen = "top";
+      expect(resolveHudScreen(id, layout, true)).toBe("top");
+      layout.elements[id].screen = "hidden";
+      expect(resolveHudScreen(id, layout, true)).toBe("hidden");
+    }
+    expect(importUiPreferences(exportUiPreferences(preferences))).toEqual(preferences);
+  });
   it("saves and clears abilities on inactive WoW bars without changing keys, templates, or mobile controls", () => {
     const ui = normalizeUiPreferences(null);
     ui.slots.pc[0] = { name: "Original", layout: ui.current.pc };

src/game/uiLayout.ts

@@ -6,7 +6,7 @@ export const UI_DEVICES: readonly UiDevice[] = ["mobile", "pc"];
 export const BAR_COLUMNS = [1, 2, 3, 4, 6, 12] as const;
 export const HUD_ELEMENTS = {
   party: "Party frames", summons: "Pet and summon frames", minimap: "Minimap",
-  player: "Player status", timeline: "Encounter timeline", target: "Enemy target",
+  player: "Buffs and debuffs", timeline: "Encounter timeline", target: "Enemy target",
   friendly: "Friendly target", threat: "Threat meter", dps: "DPS meter", cast: "Cast bar",
   hints: "Control hints", actions: "Controller action bar", experience: "Experience bar",
   reticle: "Crosshair", loot: "Loot notifications", interaction: "Interaction prompt",
@@ -16,8 +16,10 @@ export const HUD_ELEMENTS = {
   "bar-4": "Action bar 4", "bar-5": "Action bar 5",
 } as const;
 export type HudElementId = keyof typeof HUD_ELEMENTS;
+export type HudScreen = "auto" | "top" | "bottom" | "hidden";
 export interface HudElementLayout {
   visible: boolean;
+  screen?: HudScreen;
   position: NormalizedHudPosition | null;
   width: number | null;
 }
@@ -87,6 +89,7 @@ export function normalizeUiLayout(value: unknown): UiLayout {
     const element = record(elements[id]);
     defaults.elements[id] = {
       visible: element.visible !== false,
+      ...(["auto", "top", "bottom", "hidden"].includes(String(element.screen)) ? { screen: element.screen as HudScreen } : {}),
       position: element.position ? normalizeHudPosition(element.position, { x: 0.5, y: 0.5 }) : null,
       width: typeof element.width === "number" ? bounded(element.width, 200, 20, 2000) : null,
     };
@@ -114,8 +117,21 @@ export function normalizeUiLayout(value: unknown): UiLayout {
 }
 
 export function resolveDpsMeterDisplay(layout: UiLayout, dualScreen: boolean): "main" | "companion" {
+  const screen = layout.elements.dps.screen;
+  if (screen === "top" || screen === "bottom") return !dualScreen || screen === "top" ? "main" : "companion";
   return layout.dpsMeterDisplay === "auto" ? dualScreen ? "companion" : "main" : layout.dpsMeterDisplay;
 }
+/** One owner per widget; single-display layouts keep all visible widgets available. */
+export function resolveHudScreen(id: HudElementId, layout: UiLayout, dualScreen: boolean): "top" | "bottom" | "hidden" {
+  const element = layout.elements[id];
+  if (!element.visible || element.screen === "hidden") return "hidden";
+  if (!dualScreen) return "top";
+  if (element.screen === "top" || element.screen === "bottom") return element.screen;
+  if (id === "dps") return resolveDpsMeterDisplay(layout, true) === "main" ? "top" : "bottom";
+  if (["player", "actions", "cast", "experience", "bar-1", "bar-2", "bar-3", "bar-4", "bar-5"].includes(id)) return "bottom";
+  if (id === "hints") return "hidden";
+  return "top";
+}
 export function normalizeUiPreferences(value: unknown): UiPreferences {
   const source = record(value);
   const current = record(source.current);
@@ -174,7 +190,7 @@ export function importUiPreferences(text: string): UiPreferences {
       if (id === "dps" && record(layout.elements)[id] === undefined) continue;
       const element = record(record(layout.elements)[id]);
       const position = record(element.position);
-      if (typeof element.visible !== "boolean" || (element.position !== null && [position.x, position.y].some((v) => typeof v !== "number" || !Number.isFinite(v) || v < 0 || v > 1))
+      if ((element.screen !== undefined && !["auto", "top", "bottom", "hidden"].includes(String(element.screen))) || typeof element.visible !== "boolean" || (element.position !== null && [position.x, position.y].some((v) => typeof v !== "number" || !Number.isFinite(v) || v < 0 || v > 1))
         || (element.width !== null && (typeof element.width !== "number" || !Number.isFinite(element.width) || element.width < 20 || element.width > 2000))) throw new Error("Invalid HUD position or visibility.");
     }
     const keys = new Set<string>();

src/game/uiLayoutStore.ts

@@ -6,7 +6,8 @@ import { normalizeUiPreferences, type UiDevice, type UiLayout, type UiPreference
 import { publishInputPreferences } from "../input/keybindRuntime";
 
 export function currentUiDevice(): UiDevice {
-  return Capacitor.isNativePlatform() || (typeof navigator !== "undefined" && /Android|iPhone|iPad|iPod/i.test(navigator.userAgent))
+  return (typeof window !== "undefined" && /(?:[?&]layout=(?:thor-preview|dual)|[?&]display=(?:top|bottom))\b/.test(window.location.search))
+    || Capacitor.isNativePlatform() || (typeof navigator !== "undefined" && /Android|iPhone|iPad|iPod/i.test(navigator.userAgent))
     || (typeof window !== "undefined" && window.matchMedia?.("(pointer: coarse)").matches && window.innerWidth < 1100)
     ? "mobile" : "pc";
 }