Decktrace Atlas · current platform map

Project architecture

Atlas shows what Decktrace actually reuses across card games and what remains specific to OPTCG or Pokajan. It replaces the former OPTCG-only progress snapshot with a current technical map grounded in the checked-in implementations.

Platform architecture

System components

Take the visual tour
Explore the five system components
01

Execute

Each simulator implements its own game rules and legal actions.

Implementation
optcg_sim/ and pokajan_sim/ engines; packaged browser actors for each game
Supported conclusion
The OPTCG browser demo runs a trained policy in the simulator; the original-client bridge is tested separately
Current boundary

The OPTCG native bridge is an execution and disagreement canary. The browser actor is simulator-only.

02

Train

Each game owns its observations, rewards, and configuration while reusing the masked shared-action approach.

Implementation
rl/ for OPTCG; pokajan_rl/ for Pokajan; separate workspaces and checkpoint bundles
Supported conclusion
The latest OPTCG simulator champion is archive-safe; Pokajan retains its simulator champion
Current boundary

Training volume is execution evidence; OPTCG strength is scoped to the checked-in Imu mirror.

03

Compare

Matching starts and seat rotations reduce variation in policy comparisons.

Implementation
Two-seat paired openings for OPTCG; four-seat common-deal rotations for Pokajan
Supported conclusion
The latest OPTCG and Pokajan results used balanced simulator comparisons
Current boundary

Balanced sampling cannot compensate for an incorrect game rule.

04

Confirm

A challenger must remain better after uncertainty, validity, and regression checks.

Implementation
Fresh lower bounds, zero-tolerance invalid actions, timeouts, and archive opponents
Supported conclusion
Promotions occur automatically only after the declared game-specific gates clear
Current boundary

A simulator confirmation does not establish native or live-client strength.

05

Improve

Evidence decides whether to promote, retain, diagnose, or stop an idea before adding complexity.

Implementation
Retained champions, actor-visible diagnostics, bounded probes, and archive pressure
Supported conclusion
The latest champion cleared the simulator strength and archive gates; Pokajan retained v2 after five negative or inconclusive follow-ups
Current boundary

The OPTCG recommendation is simulator-scoped; native qualification and broader strength remain separate.

Game implementations

Game-specific implementations

OPTCG and Pokajan use different game states, action spaces, and evaluation metrics.

One Piece Card Game

OPTCG simulator

Fixed Imu mirror
Game engine
optcg_sim/ deterministic simulator
Agent and training
rl/ masked shared-action policy and capability operator
Comparison
Common openings with challenger and incumbent swapping two seats
Strength unit
Win rate and an uncertainty-adjusted lower win-rate bound
Additional runtime
Native bridge and client as execution/disagreement reference and later qualification smoke
Browser play
A separately versioned browser policy is available

Read the OPTCG result.

Pokajan

Pokajan simulator

v2 retained
Game engine
pokajan_sim/ deterministic four-player simulator
Agent and training
pokajan_rl/ masked shared-action policy and game-specific campaign module
Comparison
Common deals with the learner rotated through all four seats
Strength unit
Placement-weighted terminal coin settlement against the mean opponent
Additional runtime
No native control or live-client parity lane has been established
Browser play
Packaged Pyodide simulator actor, not a live-client implementation

Read the Pokajan result.

Evidence boundaries

Implementation and evaluation limits

The following limits apply to the implementation and its reported results.

Game-specific implementation

Rules and rewards

Both games use resumable training and automated comparisons. Each defines its own state, actions, reward, matchups, and evaluation metric.

Runtime

Browser simulator

The Play routes package the same simulator-side actors used by the project. Export checks compare browser and Python simulator behavior. Official-client parity requires separate testing.

Promotion also requires correct rules

Simulator validation

The trained policy passed simulator evaluation, comparisons with earlier policies, and browser-export checks. These checks do not establish qualification in the original client.

Historical Atlas

Historical OPTCG architecture

The former Atlas snapshot ends on July 22 and predates Pokajan. It is preserved for historical engineering context, not presented as current platform status.

Open the historical OPTCG snapshot.