In the interest of better handling of how data is loaded and whatnot, the Witomod branch is now patched to change how names (for name generation for NPCs and players) is loaded:
The names are now loaded from the unified file
[tt]data/raw/names.json[/tt]
The fundamental format is, as the name implies, JSON.
The file consists of an array of objects, like so:
[
{ "name" : "Aaliyah", "gender" : "female", "usage" : "given" },
{ "name" : "Aaron", "gender" : "male", "usage" : "given" },
{ "name" : "Abigail", "gender" : "female", "usage" : "given" },
{ "name" : "Adam", "gender" : "male", "usage" : "given" },
{ "name" : "Adams", "gender" : "unisex", "usage" : "family" },
/* … */
]
(The file is currently sorted, so if contributing, try to keep it that way.)
The fields used are as follows:
[ul][li][tt]name[/tt] is the name itself[/li]
[li][tt]gender[/tt] is the gender availability of the name, and can be [tt]male[/tt], [tt]female[/tt], or [tt]unisex[/tt][/li]
[li][tt]usage[/tt] is the usage class of the name, and can be [tt]given[/tt], [tt]family[/tt], or [tt]universal[/tt][/li][/ul]
Note that the fields are cross-checked when generating a new name, meaning that having male/female-only family names works as expected, e.g.:
{ "name" : "Petrov", "gender" : "male", "usage" : "family" },
{ "name" : "Petrova", "gender" : "female", "usage" : "family" },
The above, if inserted into the name file, will avail “Petrov” to male NPCs only, and “Petrova” to female NPCs only.
Also, again, in the interest of future merging and so forth; please endeavour to keep the file sorted! It lets multiple people work on it with greater ease!