People file/Version 3

This page describes the version 3 draft of the people.json format.

The people file is a JSON file with an object at its root. The object has two required pairs: one named  with the value , and one named   with an object as its value.

{    "people": { ...    },     "version": 3 }

The object
Each pair in this object represents a person. The pair's name contains 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 pairs in the object 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.
 * : 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.
 * : an object containing any of the following pairs, all optional:
 * : an array containing the Minecraft nicknames this person has used or is using on the server, sorted chronologically by most recent use. In addition to the current nickname, these may be previous nicknames of the current account, alt accounts, or nicknames used when the server was in offline mode. When Mojang enables nick changes and the person changes their nick, wurstminebot may automatically append to this value.
 * : the Minecraft universally unique identifier for the person, formatted as a string, including hyphens: . Wurstminebot may try to derive this value from the last value in the   field.
 * : 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. 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 array of OpenID identifiers with access to the person's account. If omitted, this is assumed to be empty.
 * : 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 chronologically sorted array of status change objects. Each status change object has the following pairs:
 * : the Wurstmineberg ID of the person who performed the status change, e.g. the person who invited this person, the op who executed the command, or the person who vetoed them. For a whitelisting event of a person who joined before the whitelist freeze, this is the person who introduced them to the server. This field is omitted when it is unknown who performed the status change.
 * : a string representing the date and time the status change happened. Formatted as an ISO 8601 date string in UTC. It may or may not include the time of day. The first  value in a person's status history determines the canonical sorting order for people. If it is missing, the person is sorted after everyone else, ASCIIbetically by Wurstmineberg ID.
 * , required when  is  : the reason the person was removed from the whitelist or prevented from being whitelisted. May be one of the following:
 * : the person was a guest and the event for which they were whitelisted as a guest is now over.
 * : the person is removed for inactivity, whether because the server ops have reason to believe that they won't be active anymore, or because some sort of activity period (one year on Wurstmineberg) has been exceeded.
 * : the person requested to be removed from the whitelist, or declined their invitation.
 * : the person is removed from the whitelist or prevented from being whitelisted by veto. On Wurstmineberg, this only applies to people who were invited after the freeze.
 * , required: a string specifying the person's status after the status change. May be one of the following:
 * : the person is removed from the whitelist for some.
 * : the person is a founding member of the server.
 * : the person is temporarily whitelisted outside the invitation process, for example for a minigame.
 * : the person is invited to the server but is not yet whitelisted (and may not even have accepted the invitation).
 * : the person is now whitelisted, but not a founding member of the server. Note that the people file makes no distinction between pre- and post-freeze. If this distinction is required, it must manually be checked whether the first  value in the person's status history is before or after 2013.
 * : an object containing any of the following pairs, all optional:
 * : a number containing the ID of the person's Twitter account. Unlike the @username, this is expected not to change, and the  field may be updated automatically using the value of this field.
 * : a string containing the person's current @username on Twitter, not including the  prefix.
 * : a string containing an  or   URL to a personal website.
 * : a string containing either the person's username on this wiki, including the  prefix, or the title (not display title) of their article if they don't have an account.
 * : a number containing the ID of the person's Twitter account. Unlike the @username, this is expected not to change, and the  field may be updated automatically using the value of this field.
 * : a string containing the person's current @username on Twitter, not including the  prefix.
 * : a string containing an  or   URL to a personal website.
 * : a string containing either the person's username on this wiki, including the  prefix, or the title (not display title) of their article if they don't have an account.