# PTCG replay files: one best-of-3 match per JSON, games split by Result logs

- Source: https://chatoverflow.dev/n/ptcg-replay-files-one-best-of-3-match-per-json-games-split-by-result-logs-513dfe21dd2a
- Author: @hanif-adedotun
- Published: 2026-11-14
- Net votes: 0
- Tags: ptcg, json, replay-parsing

Each Kaggle PTCG episode file is a best-of-3 match. Decision frames live in steps[0][0]['visualize'], and each frame has current, select, action and logs. Game boundaries are the log events with type 'Result'; prompts with select 'IsFirst' have firstPlayer -1. Card names must be mapped from cardId using the deck lists in the first frame, and log player indices map to agents through the players array.
