| layout | title |
|---|---|
page |
Customizing Player Names, Countries, and Colleges |
One of the game attributes you can customize is called "playerBioInfo". This lets you specify how biographical information is generated for players, specifically their names, countries, and colleges.
By default, Basketball GM includes a pretty large library of all of those, and picks them in proportion so that random leagues feel realistic. But if you want to simulate a different type of league, such as in a different country, then the defaults are no good.
Specify custom names like this:
{
"gameAttributes": [
{
"key": "playerBioInfo",
"value": {
"countries": {
"USA": {
"first": {
"George": 1,
"John": 10,
"Thomas": 2
},
"last": {
"Washington": 1,
"Adams": 5,
"Jefferson": 1
}
},
"Canada": {
"first": {
"Bob": 3,
"Aaron": 1,
"Chad": 1
},
"last": {
"Smith": 1,
"Jones": 5,
"Anderson": 4
}
}
}
}
}
]
}
You can't specify names without specifying countries. If you don't care about having multiple countries, you can put all the names in one country.
Within each country, there is a "first" object containing first names and a "last" object containing last names. The number next to each name is its relative frequency. So looking at the first names in the USA:
"George": 1,
"John": 10,
"Thomas": 2
That means George will be selected 8% of the time (1/13), John will be selected 77% of the time (10/13), and Thomas will be selected 15% of the time (2/13).
If you don't care about all that and just want all the names to be selected with equal probabilities, set their relative frequencies to the same number, like:
"George": 5,
"John": 5,
"Thomas": 5
It can be any number - as long as it's the same number, then George, John, and Thomas will all be selected with equal probability.
Okay, that explains the probability of selecting different names within a single country. But what about the probability of generating players from different countries?
The easiest way to set that is to look in the "Country Frequencies" section below, which explains how to manually set the frequencies of players from different countries. If you don't do that, and just use a league file like shown above with only the "countries" property set inside "playerBioInfo", then it bases the relative frequencies of countries off of the sum of the relative frequencies of first names. In this case, it's 1+10+2=13 for the USA and 3+1+1=5 for Canada, so it will be 72% (13/18 Americans and 28% (5/18) Canadians.
But again, you're probably better of manually specifying the frequency of players from each country:
The "frequencies" field lets you specify which countries players are drawn from, and what probability is associated with each country. The default setting is currently:
{
"gameAttributes": [
{
"key": "playerBioInfo",
"value": {
"frequencies": {
"Angola": 8,
"Argentina": 71,
"Australia": 174,
"Austria": 15,
"Bahamas": 48,
"Belarus": 12,
"Belgium": 44,
"Benin": 5,
"Bosnia and Herzegovina": 140,
"Brazil": 82,
"Bulgaria": 29,
"Cameroon": 69,
"Canada": 392,
"Cape Verde": 5,
"Central African Republic": 9,
"Chad": 5,
"China": 30,
"Colombia": 15,
"Congo": 34,
"Croatia": 216,
"Czech Republic": 34,
"Denmark": 21,
"Dominican Republic": 33,
"Egypt": 15,
"England": 112,
"Estonia": 14,
"Finland": 34,
"France": 294,
"French Guiana": 7,
"Gabon": 5,
"Georgia": 20,
"Germany": 181,
"Ghana": 10,
"Greece": 214,
"Guadeloupe": 13,
"Guinea": 11,
"Haiti": 12,
"Hungary": 22,
"Iceland": 10,
"Iran": 6,
"Ireland": 7,
"Israel": 50,
"Italy": 228,
"Ivory Coast": 26,
"Jamaica": 28,
"Japan": 7,
"Kazakhstan": 7,
"Kenya": 5,
"Kosovo": 13,
"Latvia": 69,
"Liberia": 4,
"Lithuania": 195,
"Mali": 20,
"Mexico": 17,
"Moldova": 4,
"Montenegro": 85,
"Morocco": 5,
"Netherlands": 49,
"New Zealand": 24,
"Nigeria": 136,
"North Macedonia": 28,
"Norway": 6,
"Panama": 17,
"Poland": 69,
"Portugal": 12,
"Puerto Rico": 58,
"Romania": 22,
"Russia": 116,
"Scotland": 6,
"Senegal": 113,
"Serbia": 341,
"Slovakia": 22,
"Slovenia": 105,
"South Africa": 9,
"South Korea": 5,
"South Sudan": 7,
"Spain": 251,
"Sudan": 24,
"Sweden": 47,
"Switzerland": 15,
"Trinidad and Tobago": 11,
"Turkey": 110,
"USA": 23461,
"Ukraine": 48,
"Uruguay": 7,
"Venezuela": 13,
"Virgin Islands": 10
}
}
}
]
}
Like with "countries" above, those numbers are relative frequencies. So when you see:
"USA": 23461,
"Ukraine": 48,
That means the USA is (23461 / 48) or approximately 500x more likely to be chosen as a country of origin than Ukraine.
You can change the relative frequencies to whatever you want. Setting one to 0 is the same as just deleting that country from the list, which means that country will never be selected.
To rename or add a new country, you will also need to specify names for that country in the "countries" object, as described in the "Player Names" section above. If you do that, then your "frequencies" can include both the countries you manually specified in "countries" and the built-in countries. If you specify a country in "countries" that is a built-in country, that will override the built-in list of names for that country.
So to go back to that first example from the "Player Names" section, here it is with 80% of the players coming from the USA, 10% from Canada, and 10% from Mexico. USA and Canada will use the custom names specified in "countries", and Mexico will use the default built-in names.
{
"gameAttributes": [
{
"key": "playerBioInfo",
"value": {
"countries": {
"USA": {
"first": {
"George": 1,
"John": 10,
"Thomas": 2
},
"last": {
"Washington": 1,
"Adams": 5,
"Jefferson": 1
}
},
"Canada": {
"first": {
"Bob": 3,
"Aaron": 1,
"Chad": 1
},
"last": {
"Smith": 1,
"Jones": 5,
"Anderson": 4
}
}
},
"frequencies": {
"USA": 8,
"Canada": 1,
"Mexico": 1
}
}
}
]
}
By default, Basketball GM uses a realistic set of colleges, and assigns players to those colleges with realistic frequencies. Players from the USA and Canada have a 98% chance of going to college, and players from other countries have only a 2% chance.
But you can override all of that.
There are three different college settings:
- "colleges": a list of colleges for players from a certain country
- "fractionSkipCollege": the percentage of players from a certain country who skip college
- "default colleges": like "colleges" but applies to any country where "colleges" has not been manually set
- "default fractionSkipCollege": like "fractionSkipCollege" but applies to any country where "fractionSkipCollege" has not been manually set
First I'll show "default colleges" and "default fractionSkipCollege":
{
"gameAttributes": [
{
"key": "playerBioInfo",
"value": {
"default": {
"colleges": {
"Harvard": 2,
"Yale": 1
},
"fractionSkipCollege": 0.4
}
}
}
]
}
That will result in Harvard and Yale being the only colleges in the game. The numbers are relative frequencies, same as described above for names and countries. So 2/3 of colleges will be Harvard and 1/3 will be Yale.
"default fractionSkipCollege" is a little trickier. By default it is 0.02. Above I changed it to 0.4. But still, that only applies to countries besides Canada and the US, because the built-in info for those countries includes a "fractionSkipCollege" override of 0.98. If you want to change that, you'll have to specify a "fractionSkipCollege" value for those countries.
You can use "default colleges" and "default fractionSkipCollege" either together or alone. Whatever you want. If you leave one out, the built-in default will be used.
The "colleges" setting is very similar. The only difference is that it applies to an individual country. And the "fractionSkipCollege" feature is pretty straightforward to apply to an individual country. Example:
{
"gameAttributes": [
{
"key": "playerBioInfo",
"value": {
"countries": {
"USA": {
"first": {
"George": 1,
"John": 10,
"Thomas": 2
},
"last": {
"Washington": 1,
"Adams": 5,
"Jefferson": 1
},
"colleges": {
"Harvard": 2,
"Yale": 1
}
},
"Canada": {
"first": {
"Bob": 3,
"Aaron": 1,
"Chad": 1
},
"last": {
"Smith": 1,
"Jones": 5,
"Anderson": 4
},
"fractionSkipCollege": 0.5
}
},
"default": {
"colleges": {
"Stanford": 1,
"UCLA": 1
}
}
}
}
]
}
In the above example, all American college players will be from Harvard or Yale, and only 2% of them will skip college. Canada has no "colleges" set, so players will be drawn from the schools in "defaultColleges", but 50% of them will have no college.
You can mix and match these college settings as you please. They're all optional. For instance, if you left out "defaultColleges" in the previous example, then Canadian players' colleges would be drawn from the built-in default list of colleges.
Here's another example, where "colleges" is set for a country without overriding the built-in names:
{
"gameAttributes": [
{
"key": "playerBioInfo",
"value": {
"countries": {
"USA": {
"colleges": {
"Harvard": 2,
"Yale": 1
}
}
},
"frequencies": {
"USA": 1,
"Canada": 1
}
}
}
]
}