[FYI] Replay Binary Format

[sat0ri]

Below is the binary layout of replay metadata such as player names, selected characters, winner side, date, etc. I hope this information will be useful to the community.

Hex offset, data type: explanation
00, 12 bytes: file format signature
0C, uint16: metadata size
1A, ----: metadata begin. If some offsets below are greater than this offset + metadata size, then the corresponding data is missing. To update the metadata, watch replay till the end using the latest game version.
1A, ----: recording date begin
1A, uint16: year
1C, uint8: month
1D, uint8: day
1E, uint8: hour
1F, uint8: minute
20, uint8: second
--, -----: recording date end
22, uint64: P1 Steam ID
2a, uint64: P2 Steam ID (for network matches only)
32, 32 bytes: P1 name (UTF-8)
52, 32 bytes: P2 name (UTF-8)
72, uint8: P1 character (1-25, SO KY MA MI AX PO CH ED BA FA TE JA AN JO VE DI SL IN ZA BR RO AB OS KL JU)
73, uint8: P2 character
74, uint8: value is 1 if extra options were modified, or EX/SP/GG characters were used, or KL/JU in the original AC, 0 otherwise
75, uint8: 1 = single, 2 = team
76, uint8: 0 = +R, 1 = AC
77, sint32: recording location timezone bias against GMT, in seconds
7B, uint8: P1 rounds won
7C, uint8: P2 rounds won
7D, uint8: bitmask, 1 = unfinished match, 2 = disconnect, 4 = desync
7E, uint8: ping
7F, uint32: match duration in frames
83, uint8: P1 score (explanation at the end)
84, uint8: P2 score
85, uint8: P1 rank
86, uint8: P2 rank
87, uint8: winner side, 1 = P1, 2 = P2, 3 = draw
--, -----: metadata end


Notes:

• Score calculation: after each round, player is given a score of 0-7 depending on their life lead. Overall score is the average with +3 added to the winning side.
  
• Replay files can be found in %USERPROFILE%\Documents\ARC SYSTEM WORKS\GGXXAC\Replays.
  
• You can launch replays directly from Windows' File Explorer or from a browser by associating game's executable with .ggr file extension.

[Mech]

yah

[Redug]

You guys rock - myself and surely many others are gonna be saved loads of time by this post.

[ThePolicelee]

Do you have a general format to use for the recorded inputs by any chance? I would like to research into creating a replay processing tool to create highlight reels or search matches for specific scenarios (if it's not incredibly difficult to do so). I.E. each frame, offset 00 bit 0 is Player 1's P input being pressed, bit 1 is K input, bit 2 is S input, etc.

[sat0ri]

Originally posted by ThePolicelee:

Do you have a general format to use for the recorded inputs by any chance? I would like to research into creating a replay processing tool to create highlight reels or search matches for specific scenarios (if it's not incredibly difficult to do so). I.E. each frame, offset 00 bit 0 is Player 1's P input being pressed, bit 1 is K input, bit 2 is S input, etc.

My apologies for not noticing this question. Input data is saved as a compressed chunk, so that wouldn't be as simple as reading a file, but not impossible. At this point I don't remember the specific structure of the compressed stream, but again, it shouldn't take too long to find out once it's decompressed (create a replay with each button pressed for a couple of seconds, etc).

[TEM]

リプレイファイルを集計するソフトを作っているのですが、2021年11月以前のリプレイファイルのメタデータがこの通りになっていないようです。
ざっと調べたところ 7C （P2 rounds won）まで互換性があるように思えますがそれで合っていますでしょうか？

I am making software to aggregate replay files, but it seems that the metadata of replay files before November 2021 is not as shown.
After a quick check, it seems that it is compatible up to 7C (P2 rounds won), but is that correct?

[sat0ri]

Originally posted by TEM:

リプレイファイルを集計するソフトを作っているのですが、2021年11月以前のリプレイファイルのメタデータがこの通りになっていないようです。
ざっと調べたところ 7C （P2 rounds won）まで互換性があるように思えますがそれで合っていますでしょうか？

I am making software to aggregate replay files, but it seems that the metadata of replay files before November 2021 is not as shown.
After a quick check, it seems that it is compatible up to 7C (P2 rounds won), but is that correct?

That is correct, properties after 'P2 rounds won' were added later. Watching an old replay till the end will add the missing properties.

[TEM]

この情報を元にアプリケーションを作りましたので報告します。

I created an application based on this information and would like to report it.

https://steamcommunity.com/app/348550/discussions/0/4365752664042371743/