- BoardShapeGenerator: add MakeDecagonal() for 7-10 players (10-armed radial, 11x11 arena, 21x21 total); AutoShape now routes 7-10 to Decagonal - CustomLobby: add TeamAssignmentsJson (seat -> team override map) - GameMessages: add ReassignTeamRequest/Response, LobbyTeamAssignmentChangedPush, SeatTeams field on JoinCustomLobbyResponse - GameReassignTeamHandler: new game.custom.reassign_team handler (host-only); pushes team_reassigned to all participants including additional players - EF migration: AddTeamAssignmentsToLobby (applied to pg-forge-01) - Client CustomLobby.gd: seat_teams state, reassign_team() action, push handler - lobby_room_screen.gd: _rebuild_team_controls() renders host-only [<] Tx [>] cycle buttons per seat in team modes; _team_label() reads seat_teams overrides - OVERALL.md: add Considerations for Later (fog of war, asymmetric teams, ranked ELO) Generated with [Claude Code](https://claude.ai/code) via [Happy](https://happy.engineering) Co-Authored-By: Claude <noreply@anthropic.com> Co-Authored-By: Happy <yesreply@happy.engineering>
7.4 KiB
TODO
-
SOR: Design and implement version tagging/release flow (move away from
:latest; use SemVer + Gitea Action for tagged image builds/promotions). -
Custom Games backlog:
- Admin: Custom lobby oversight — admin page listing active/recent custom lobbies, with ability to cancel a lobby or kick a player.
- 3+ player support — MinPlayers/MaxPlayers are currently UI-only stubs; engine is strictly 2-player. Multi-player requires engine rewrite.
- Lobby chat — in-lobby text chat between host and guest before game start.
- Friend/direct invite — invite specific player by name/ID to a lobby, bypassing browser.
- Public preset sharing — presets are currently owner-scoped; public browsable presets deferred.
- Replay system — recording and replay of completed games (related to spectating infrastructure).
- Vote "concede" option — add third option to preset-load vote to concede/exit lobby if vote stalls.
- Lobby update while waiting — host rule changes after guest joins (without preset vote); requires push + guest acknowledgement flow in Full state.
-
Platform/engine backlog (not only Custom Games):
- Board templates —
BoardTemplateIdOverrideexists in schema as nullable Guid, but noBoardTemplateentity, no admin template management UI, and no engine logic to apply templates. Wire-up deferred until template format is designed. - Admin: BoardTemplate editor — full CRUD page for named board templates (tile layout, size, special tiles); blocked on defining template storage format.
- Hex tile shape —
TileShapeenum stub (Square/Hex) can be stored, but engine, client renderer, and pathfinding are square-only. Hex remains UI-disabled.
- Board templates —
-
Product/UI/Platform backlog:
- UI/UX OAuth config update (Google first).
- Boot logo change.
- App icon change.
- Refactor each scene: split UI building out of
.gdinto node-based scene structure for easier UI changes. - Game website.
- Tutorial in game + how-to guide on website.
- Legal docs: TOS, Privacy Policy, EULA, Cookie Policy, plus any additional required docs (track in
Shared/legal.md).
-
Account management:
- Fix mailbox.
- Link OAuth to existing account.
- Reset password flow.
- Full account metrics for leaderboard (including ranking).
-
Spending panel:
- Uncensor toggle (censored by default).
- Full tracker on USD / Origin Points spent and what it was spent on.
- Download spending report.
-
Spending controls panel:
- Set monthly spending cap (money and/or Origin Points).
- Cap is lock-enforced once set.
- Cap can only be changed once per month.
- Warning prompts required before setting/changing cap.
- Show next eligible cap-change date/time.
-
Legal links panel:
- TOS, EULA, and other required legal docs links.
-
Bazaar / economy:
- Player marketplace:
- Search/browse listed cards.
- Listing details: card identity (definition + variant), seller, price (Origin Points), listed-at timestamp, listing status.
- Actions: buy listing, cancel own listing, create listing from owned inventory.
- Filters/sort: card name/type/rarity/affinity, min/max price, newest, price asc, price desc.
- Buy Origin Points (USD purchase flow).
- Payment method display + confirmation modal.
- Show SKU pricing/details in USD and Origin Points (where applicable).
- Sacrifice / disenchant:
- Select cards from owned inventory.
- Preview Origin Points return before confirm.
- Explicit irreversible warning.
- Confirm flow: remove/flag cards from inventory and credit Origin Points.
- Ledger/history (player view):
- Transaction timeline for marketplace buys/sells, store purchases, sacrifices, refunds/reversals.
- Receipt details with transaction id.
- Player marketplace:
-
Audit / chain-of-custody requirements (critical):
- Immutable ledger entry for every economy event including:
transactionId,eventType,accountId(s), asset refs (cardInstanceId,skuId, etc.), balance before/after, timestamp, and request correlation (requestId). - Full custody trail per card instance: minted/acquired → listed → sold/transferred → sacrificed/destroyed.
- USD purchases store payment provider reference id(s) and receipt linkage.
- Admin/internal investigation queries for suspicious activity patterns.
- Immutable ledger entry for every economy event including:
-
Fraud / abuse signals (planned):
- Repeated rapid buy/sell loops between same accounts.
- Outlier pricing patterns.
- High-frequency sacrifices after suspicious acquisitions.
- Chargeback/refund correlation with asset transfers.
- Multi-account linkage risk indicators.
-
Collection:
- Add cosmetics.
- Enable toggle to apply cosmetics to cards/decks.
- Cosmetics panel UI:
- Category selector (back/trim/art/model).
- Preview pane.
- Owned/locked state indicators.
- Equip/apply controls.
-
Custom Games additions:
- Filter controls (open slots, format/rules tags, region, friends-only).
- Rules detail tooltip/panel on hover/focus with full ruleset display.
-
Leaderboard:
- Track additional properties for a richer leaderboard.
-
Login / register:
- OAuth buttons for login/register.
- Forgot password flow.
- Register: add TOS/Privacy acceptance.
-
Ranked:
- Ranked game viewer: enable spectate for ranked games.
- Anti-rematch / pairing controls:
- Avoid same-opponent rematch within last 2 completed ranked games when alternatives exist.
- Soft rule only; allow bypass at high queue times.
-
Settings:
- Add message support / bug report entry.
-
Gameplay:
- Full timing windows and reaction timing.
- Mulligan rules.
-
Networking/privacy hardening:
- Delta identity decoupling: replace client-visible
accountIdusage in game wire payloads with session-scopedplayerRefidentifiers. - Server identity map: maintain authoritative
sessionId + playerRef -> accountIdmapping with strict invariants on join/reconnect/resume. - Logging/telemetry split: keep internal accountId linkage in server logs only; expose
playerRef(and display name) in client-visible/debug payloads.
- Delta identity decoupling: replace client-visible
Considerations for Later
These features are intentionally deferred — they require significant design work or depend on other foundational systems not yet in place.
-
Fog of War: Restrict each player's board visibility to tiles/units within a defined sight range. Requires a server-side visibility model (per-player tile sets), partial state serialisation in game messages, and client-side fog overlay rendering. Non-trivial for multiplayer without leaking hidden state.
-
Asymmetric team sizes: Allow lobbies where teams have different player counts (e.g. 3v1, 2v1v1). Currently
teamCountdivides seats evenly. Requires a seat-to-team mapping override, balancing rules, matchmaking weight adjustments, and UI to expose the configuration. -
Ranked multiplayer ELO: Extend the ranked system to support multi-player ELO/MMR — rating deltas when 3+ players participate in one match, handling partial concessions, and per-format rating tracks (2v2, FFA, etc.). Requires consensus on the scoring algorithm and anti-manipulation rules before implementation.