People file

people.json is a file used in several places of our infrastructure, containing information about the people on the server.

Format
''Note: this section describes version 2 of the people.json format, as this verison is currently used on Wurstmineberg. For version 1, see this subpage, and for the version 3 draft, see this subpage.''

The people file is a JSON file with an object at its root. The object has a single pair named  with an array as its value.

{    "people": [ ...    ] }

Each value in this array is an object representing a person. People are sorted chronologically by invitation or whitelisting. Each person object has only a single required pair named, with a string value containing the person's Wurstmineberg ID. A Wurstmineberg ID consists of 2 to 16 ASCII lowercase letters and numbers. The first character must be a letter. All other pairs are optional:


 * : a string containing a characterization of the person. May contain the following HTML tags for formatting:
 * : an object containing three pairs named,   and  , each with an integer between 0 and 255 inclusive, representing the person's favorite color in RGB format. This color is used to color-code diagrams. The default favorite color is transparent.
 * : an object representing the person's favorite Minecraft item. The format is a JSON-encoded version of Minecraft's item format, although some tags may be ignored. We use this on the server for the item frame that labels the tunnel from the hub to your base. If unspecified, a dye item with the color of the base's tunnel is used as a placeholder.
 * : a string containing an e-mail address. If specified and a Gravatar is associated with the address, it will be used as the person's avatar on the website. Otherwise, the head from their Minecraft skin will be used.
 * : a string containing the Wurstmineberg ID of the person who invited this person, or  for founding members. If the pair is missing,   is assumed for founding members, otherwise the information is missing. For people who joined before the whitelist freeze, “invited” means the person who introduced this person to the server.
 * : an object containing any of the following pairs, all optional:
 * : an array of IRC nicknames used by the person. These should all be NickServ-protected, otherwise anyone may impersonate the person. The nicks are sorted by preference in decreasing order, with the person's main nick as the first value.
 * : a string representing the person's NickServ account. This is currently not used.
 * : a string representing the person's date of whitelisting. Formatted as an ISO 8601 date string (in UTC and without the time of day).
 * : the person's Minecraft nickname as a string. When Mojang enables nick changes and the person changes their nick, wurstminebot may override this value.
 * : the Minecraft universally unique identifier for the person. May be formatted as a string ( or  ) or a number . Wurstminebot may try to derive this value from the Minecraft nickname.
 * : an array containing Minecraft nicknames used previously on the server, sorted chronologically. These may be previous nicknames of the current account, alt accounts, or nicknames used when the server was in offline mode.
 * : a string containing the person's display name. This name will be used when there is no context-specific username (e.g. IRC or Minecraft) to use for the person. For example, the website and this wiki both use display names (although for the wiki, the list of display names is maintained manually in Player link). The display name defaults to the person's Wurstmineberg ID.
 * : an ASCIIbetically sorted array of additional names or nicknames the person is commonly called. Wurstminebot will recognize these in addition to the person's display name and context-specific username when chatsyncing.
 * : an object containing the options that are set for the person. Keys consist of ASCII lowercase letters and underscores. Values are boolean. For info on what individual options do, see the command's documentation.
 * : a string containing the person's username on reddit, not including the  prefix.
 * : a string specifying the person's whitelisting status. When not specified, the value is assumed to be . May be one of the following:
 * : the person was removed from the whitelist for inactivity or upon request.
 * : the person is a founding member of the server, and still whitelisted.
 * : the person was a founding member of the server, but was removed from the whitelist for inactivity or upon request. (Note that on Wurstmineberg, founding members are not removed for inactivity.)
 * : the person was a founding member of the server, but was removed from the whitelist by veto. The vetoing mechanism on Wurstmineberg does not allow for this to occur in our people.json.
 * : the person was invited to the server but is not yet whitelisted (and may not even have accepted the invitation).
 * : the person is not a founding member of the server, and still whitelisted.
 * : the person joined after the whitelist freeze, and is still whitelisted. This is mostly equivalent to.
 * : the person was removed from the whitelist or prevented from being whitelisted by veto. On Wurstmineberg, this only applies to people who were invited after the freeze.
 * : a string containing the person's @username on Twitter, not including the  prefix.
 * : a string containing an  or   URL to a personal website.
 * : a string containing the person's username on this wiki, not including the  prefix.
 * : the person was removed from the whitelist or prevented from being whitelisted by veto. On Wurstmineberg, this only applies to people who were invited after the freeze.
 * : a string containing the person's @username on Twitter, not including the  prefix.
 * : a string containing an  or   URL to a personal website.
 * : a string containing the person's username on this wiki, not including the  prefix.