Each role belongs to one or more role categories. These categories (also known as tags or cats) are populated via the get_role_metadata event and define general mechanics for the role. Role categories only apply for the player's main role. Secondary roles are not considered when determining behavior based on categories. Categories are always in Title Case to distinguish them from role names (which are always lowercase).
There are four main categories. Each role must belong to exactly one of these categories. These categories are used to determine overall team affiliation and how the role wins at the end of the game.
- The role is a member of wolfteam and wins with the wolves. The mystic learns how many players belong to Wolfteam each night and the augur sees these roles as red.
- The role is a member of the village and wins with them. The augur sees these roles as blue.
- The role does not belong to wolfteam or the village (they may be completely independent, or they may be a member of a tertiary team such as monsters). Roles which belong to this category are responsible for determining their own win/loss status as part of the player_win event. The augur sees these roles as grey.
- The player does not know that they are this role, and are instead told that they are either villager or cultist (depending on the game mode's HIDDEN_ROLE setting). They win alongside that role (so they win with the village if they are told they are villager, and win with wolves if they are told they are cultist). The augur sees these roles as their team affiliation (blue if village, red if wolfteam).
Roles may additionally belong to zero or more of the following categories. These categories detail general behavior for that type of role, and may be modified on a per-role basis. For example, werekitten is always missed by the gunner instead of dying when shot.
- Roles with this category are seen as wolf by the seer and oracle, even if they are Safe or Innocent.
- Examples: mad scientist, succubus
- Roles with this category are always seen as villager by the seer and oracle, even if they are Wolf. These roles additionally cannot be gunner or cursed villager.
- Examples: werekitten, priest, fool, jester
- Roles with this category are capable of killing other players during the game. Roles which kill on death only (rather than kill proactively) should not belong to this category (for example, mad scientist and vengeful ghost). Wolf roles without this category are not able to use the !kill command.
- Examples: wolf, hunter, dullahan, gunner, sharpshooter
- Roles with this category are able to act every night. Roles which can only act once per game or are not able to act every night should not be in this category (for example, hunter, turncoat, or matchmaker). They are observed by the werecrow as not being in bed.
- Examples: wolf, harlot, shaman, vigilante
- Roles with this category are always seen as their actual role by the seer instead of just villager or wolf. If a role is both Safe and Innocent, Safe takes precedence. However, Cursed takes precedence over Safe. The wolf mystic is given the number of Safes each night.
- Examples: harlot, hunter, shaman
- Roles that actively learn information about players, roles, or categories. Roles whose primary purpose is not to gain information, but the information comes as a secondary effect should not belong to this category (for example, harlot). They are observed by the sorcerer as having access to additional information.
- Examples: werecrow, sorcerer, seer, detective, prophet, investigator
- Roles which have passive information about players, roles, or categories. Passive information may not be up-to-date and does not require any action on the player's part in order to obtain. Roles whose primary purpose is not to gain information, but the information comes as a secondary effect should not belong to this category (for example, warlock knowing who is cursed).
- Examples: minion, mystic, wolf mystic
- Team Switcher
- Roles with this category can possibly change their team affiliation during the course of the game.
- Examples: amnesiac, turncoat, lycan, wild child
- Win Stealer
- Roles with this category can win at the exclusion of everyone else (including village/wolves). Roles with this category should always be in the Neutral category as well. These roles are safe kill targets for the vigilante and the wolf mystic is given the number of Win Stealers each night.
- Examples: monster, fool, succubus, piper, demoniac
- This category indicates that the role is a wolf. Roles with this category should always be in the Wolfteam category as well. A Wolf role is seen as wolf by the seer and oracle, always dies if shot by the gunner, is a safe kill target for the vigilante, and kills visiting harlots. The minion is given the list of Wolf players at the beginning of the game. The village must kill every Wolf role in order to win the game.
- Examples: wolf, wolf cub, wolf shaman, werecrow
- This category indicates that the role has access to wolfchat, depending on the RESTRICT_WOLFCHAT setting. Roles with this category should always be in the Wolfteam category as well. For wolves to win, the number of players with wolfchat access must equal or exceed the number of players without.
- Examples: wolf, werecrow, sorcerer, hag, warlock, traitor