Basketball GM supports custom roster files that define the players to be used in a new league.

Getting a custom roster file

There are two sources of roster files:

1. Download: If someone has made a custom roster file and put it up online, you can download it and use it. However, since this feature is new, probably nobody has done this yet.
2. Export: From within any league, you can export the rosters from any season (current or past) by clicking "Export Rosters" at the bottom of the league menu on the left.

It is also easy to edit these roster files however you want, as is described below.

Using a custom roster file

When you are creating a new league, change the rosters from "Random Players" to "Upload Custom Rosters". Then, select your desired roster file.

Editing a custom roster file

A custom roster file is simply a JSON file containing a list of players. You can add/remove/edit any part of it.

The easiest way to do this would probably be to look at the structure of an exported roster file and base your new file off that. Since the exported files are compressed into a single line of text, you should first run it through a JSON prettifier like this.

Many fields in the exported roster files are optional if you're making your own rosters. The only required ones are shown below. Any other fields you see in an exported or custom roster file are purely optional.

{
  "players": [
    {
      "name": "Andrew Phillips",
      "tid": 0,
      "ratings": [
        {
          "hgt": 20,
          "stre": 0,
          "spd": 85,
          "jmp": 50,
          "endu": 55,
          "ins": 68,
          "dnk": 45,
          "ft": 57,
          "fg": 64,
          "tp": 16,
          "blk": 49,
          "stl": 37,
          "drb": 75,
          "pss": 76,
          "reb": 39,
          "pot": 49
        }
      ]
    },
    {
      "name": "Heriberto Braman",
      "tid": 0,
      "ratings": [
        {
          "hgt": 27,
          "stre": 34,
          "spd": 85,
          "jmp": 55,
          "endu": 25,
          "ins": 46,
          "dnk": 42,
          "ft": 42,
          "fg": 54,
          "tp": 72,
          "blk": 48,
          "stl": 40,
          "drb": 72,
          "pss": 75,
          "reb": 44,
          "pot": 52
        }
      ]
    }
  ]
}

A list of things you should know when making a roster file:

• tid is the team ID number, ranging from 0 to 29 in alphabetical order. -1 is for free agents.

• In the example above, there are only two players defined. If your file doesn't include at least 5 players on every team, then bad things will happen when you try to use it.
• You can view definitions of all the rating abbreviations within any league by going to the player ratings page and hovering your mouse over each column header.