Skip to main content

Fake Player Dataset

1. Overview​

After finishing the ruleset script, it's important to ensure the rules are appropriate for the data features of players who use matchmaking. If the restrictions are too strict, it may cost too much time on finding matchmaking result. Also if the restrictions are too loose, while it will be quick to complete matchmaking, mixing experienced and novice players may reduce the fun of play.

PGOS provides a tool to verify a ruleset with Fake Player Dataset, which is a dataset of multiple fake player records. Fake player dataset can be generated by specified required parameters, exported in csv format, and imported from csv file.

After completing this tutorial, you will be able to do the following things:

  • Configure the ticket & player attribute generator, to create fake player Dataset.
  • Import a fake player dataset from csv file.

2. Generate Fake Player Dataset​

On the fake player dataset creating page, two params are required: name and ticket scale. A ticket contains one or more players, which is the basic unit in tracking matchmaking process.

2.1 Configure Ticket Generator​

A ticket contains one player in a solo battle, or multiple players in a group battle.

According to the verification scenario, you can adjust the multi-player ticket proportion by giving a weight to each count of players in ticket option. Weights are set to balance the ratio of different player count tickets, which are NOT absolute number of these tickets.

Caution

If the count of players in ticket exceeds the maxPlayers of a team, the ticket will time out in matchmaking test.

image-20220425163905736

For example:

  • To generate all solo tickets, refer the configuration below

image-20220425165647056

  • To generate all four-player-group tickets, refer the configuration below

image-20220425165751175

2.2 Configure Player Attribute Generator​

Two types of player attributes' generation are supported:

  • Number: supports normal distribution and continuous uniform distribution
    • For normal distribution, expectation and stddev are required to create normal distribution formula, left border and right border are required to limit the range of the distribution to an interval.
    • For uniform distribution, max value and min value are required, and the value will be generated continuously uniformed.
  • String: supports generating string enums with weight
    • For each string enum, specify its weight.

There are two ways of adding the needed player attributes:

  • Add Attribute manually by specifying name, type and distribution params.
  • Quick Import from Ruleset, with name and type already set, just need to Edit its distribution params.

For example, a generator with two player attributes: mmr and map can be refered below:

image-20220425163917132

3. Import Fake Player Dataset​

The fake player dataset can be exported and edited in third-party software like Excel, then after some tweaks it can be re-imported.

Specify a name and upload a csv file to import fake player Dataset.

4. CSV Schema​

The first two columns are predefined: player_id and ticket_id, followed by the player attributes, each as a separate column.

Each row represents a player. If a ticket contains multiple players, they will be adjacent and share the same ticket_id.

player_id,ticket_id,mmr,map
player-1,ticket-1,1913.747060,Camp TriggerFish
player-2,ticket-2,1719.388103,MakoMart
player-3,ticket-3,2043.800709,MakoMart
player-4,ticket-4,1867.210120,Skipper Pavillion
player-5,ticket-5,2098.715281,MakoMart
player-6,ticket-6,1965.570910,MakoMart
player-7,ticket-7,1854.361248,Walleye Warehouse
player-8,ticket-8,2133.395360,Skipper Pavillion
player-9,ticket-9,2243.999153,Camp TriggerFish
player-10,ticket-10,2447.937448,Skipper Pavillion
player-11,ticket-11,1970.489577,Skipper Pavillion
player-12,ticket-12,2281.356048,Skipper Pavillion
player-13,ticket-13,2324.447528,Camp TriggerFish
player-14,ticket-13,1496.947738,MakoMart
player-15,ticket-14,2001.347293,MakoMart
player-16,ticket-15,1836.978725,MakoMart
player-17,ticket-16,1944.119746,MakoMart
player-18,ticket-17,1927.298857,Walleye Warehouse
player-19,ticket-18,1923.013664,Skipper Pavillion
player-20,ticket-19,2223.021340,MakoMart
player-21,ticket-20,2022.514713,Camp TriggerFish
player-22,ticket-21,2295.492495,MakoMart
player-23,ticket-22,1854.318577,Camp TriggerFish
player-24,ticket-23,2086.412562,Camp TriggerFish
player-25,ticket-24,1777.203517,Walleye Warehouse
player-26,ticket-25,2107.402592,MakoMart
player-27,ticket-25,2306.995124,Skipper Pavillion
player-28,ticket-25,2245.593568,MakoMart
player-29,ticket-25,1798.676145,MakoMart
player-30,ticket-25,1848.814784,Skipper Pavillion
...