cjson Format

*.cjson is a format for storing serialised data for Golden tournaments. At it's core it's basically a JSON data structure, however the separate extension is used to more easily differentiate between tournament files and other data files.

The cjson files are serialised using the serialise function found in here and can be deserialised using the deserialise function.

Structure

The cjson format has four top-level properties:

• meta Object
• players Array
• rounds Array
• cut Object

meta

The meta object stores the basic information about the tournament itself.

• name String - the name of the tournament
• host String - the host of the tournament (a store or another entity hosting the tournament)
• location String - location of the tournament
• rank String - this is one of the ["casual", "store", "cache", "regionals", "nationals", "worlds"], denoting the rank of the tournament.
• id String - this is the 'private' tournament ID used to save changes in the Monolith web services. Do not reveal this to third parties as they will be able to overwrite the tournament data on Monolith.
• shortid String - this is the 'public' tournament ID used to get changes from Monolith.

players

The players array stores the information on all players in the tournament.

• name String - the name of the player
• id String - the unique ID of the player
• points Number - the number of points the player acquired during Swiss rounds
• sos Number - the player's strength of schedule (see FFG Tournament Regulations section IV 7b)
• esos Number - the player's extended strength of schedule (see above)
• corpfaction String - the player's corporation faction, as per standard one of the ["Jinteki", "Haas-Bioroid", "Weyland Consortium", "NBN", "Neutral"]
• corpid String - the player's corporation identity, as per standard will be stored for instance as Argus Security: Protection Guaranteed.
• runnerfaction String - the player's runner faction, as per standard one of the ["Adam", "Sunny", "Apex", "Anarch", "Criminal", "Shaper", "Neutral"]
• runnerid String - the player's runner identity, stored the same way as t he corpid.
• opponents Array[String] - the array of player's opponents, after serialisation each string will be the opponent's id.
• bye Boolean - whether the player has already received a bye this tournament
• superbye Boolean - should the player receive an award bye in the first round of the tournament, this will get set to false after the first round.

rounds

The rounds array stores every round object in the tournament. Each round has a matches array as one of its properties which stores matches objects in the chosen round.

matches

The matches array exists in each round object to represent a match in the round.

• player1 String - the id of the first player in the match
• player2 String - the id of the second player in the match
• table Number - the table on which the match should happen
• score1 Number - the score for the first player in the match
• score2 Number - the score for the second player in the match
• scored Boolean - whether the match has already been scored

cut

This is not used yet.