feat: improved debuff control and prepared games

[jooakar]

Summary

• Next Round Panel: new side panel to prepare the next round before launching — select puzzle, configure initial debuffs (applied to all players on launch), and build a minigame debuff pool (available debuffs for audience challenges, currently not sent to the backend)
• Active Debuffs Panel: real-time view of all currently active debuffs per player with live countdown timers; supports clearing individual debuffs, all debuffs for one player, all debuffs globally, or a single debuff type across all players
• "All players" option added to the debuff selector for bulk administration
• Infinite duration: dragging the duration slider to the max shows ∞ and sends duration=0, which the backend treats as ~1 year; displayed as ∞ in both player and admin views
• Debuffs cleared on puzzle switch: switching puzzles (manually or via Launch Round) clears all active debuffs for all players
• Backend clear_debuff command and launch_round command added
• Debuff updates now broadcast to all admins regardless of spectate selection

fixes #13, fixes #14

[Copilot]

Pull request overview

Adds new admin UX and backend support for round preparation and debuff management (apply to all, clear active debuffs, and “infinite” duration handling), plus ensures debuffs are reset on puzzle switches.

Changes:

• Extend admin protocol with launch_round and clear_debuff, and implement corresponding backend handlers.
• Add new admin panels: “Active Debuffs” (view/clear) and “Prepare Next Round” (select puzzle + initial debuffs).
• Update debuff UI to support “All players” targeting and an ∞ duration display/sentinel.

Reviewed changes

Copilot reviewed 8 out of 9 changed files in this pull request and generated 7 comments.

Show a summary per file

File	Description
frontend/src/player/DebuffSelector.tsx	Add “All players” option and encode ∞ duration via duration=0.
frontend/src/player/DebuffQueue.tsx	Display ∞ for long durations.
frontend/src/admin/SpectatorController.ts	Treat empty debuff lists as a clear signal for spectators.
frontend/src/admin/NextRoundPanel.tsx	New UI to select next puzzle and configure initial debuffs for round launch.
frontend/src/admin/adminState.ts	Add new admin command types and PreparedDebuff type.
frontend/src/admin/Admin.tsx	Integrate new admin panels into the dashboard layout.
frontend/src/admin/ActiveDebuffsPanel.tsx	New UI to view active debuffs per player and issue clear commands.
frontend/package-lock.json	Lockfile regeneration changes.
backend/main.py	Implement infinite-duration sentinel, clear-debuff command, launch-round command, spectator debuff broadcasting, and debuff resets on puzzle switch.

Files not reviewed (1)

• frontend/package-lock.json: Language not supported

Comments suppressed due to low confidence (2)

frontend/src/player/DebuffQueue.tsx:12

• formatDuration returns "∞" for any debuff with > 1 hour remaining. Debuff durations can legitimately exceed an hour (e.g. repeated stacking in administer_debuff accumulates duration), so this will mislabel long-but-finite debuffs as infinite. Consider detecting infinity via a much higher threshold aligned with the server sentinel (e.g. ~1 year), or having the server explicitly mark infinite debuffs.

function formatDuration(ms: number): string {
  if (ms > 3_600_000) return "∞";
  const total = Math.max(0, Math.ceil(ms / 1000));
  const m = Math.floor(total / 60);
  const s = total % 60;
  return `${m}:${s.toString().padStart(2, "0")}`;

backend/main.py:756

• Broadcasting spectate_debuffs to all admins (even when they are not spectating a player) means controllers can accumulate incremental debuff updates. When an admin later starts spectating a player, the server also sends a full debuff snapshot (debuffs_json) for that player, and the client-side updateDebuffs logic merges rather than replaces—this can lead to duplicate debuff entries. To avoid this, consider clearing before sending snapshot debuffs (send an empty debuffs message first) or introducing a distinct "replace debuffs" message type for snapshots.

        data = json.dumps(converted)
        for admin in self.admins.values():
            if converted["type"] in ("spectate_state", "spectate_debuffs") or admin.is_spectating(player_name):
                try:
                    # TODO: use queue tasks like with players
                    asyncio.create_task(admin.ws.send(data, True))
                except Exception:

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.