Hypixel · JSON Structure

Hypixel Public Api Game Structure

Information about a specific game. When a field is not present you should fallback to the provided default if there is one, required fields will always exist.

Type: object Properties: 6 Required: 3
Games And ComicsGamingMinecraftPlayer StatsLeaderboardsSkyBlockPublic APIs

Game is a JSON Structure definition published by Hypixel, describing 6 properties, of which 3 are required. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

id name databaseName modeNames retired legacy

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/hypixel/refs/heads/main/json-structure/hypixel-public-api-game-structure.json",
  "name": "Game",
  "description": "Information about a specific game. When a field is not present you should fallback to the provided default if there is one, required fields will always exist.",
  "type": "object",
  "properties": {
    "id": {
      "type": "int32",
      "description": "The backend ID of the game.",
      "example": 1
    },
    "name": {
      "type": "string",
      "description": "The display name of the game.",
      "example": "Bed Wars"
    },
    "databaseName": {
      "type": "string",
      "description": "The key used for database storage, such as for stats.",
      "example": "Bedwars"
    },
    "modeNames": {
      "type": "object",
      "description": "A map of mode key to display name",
      "example": {
        "solo_normal": "Solo",
        "team_normal": "Doubles"
      }
    },
    "retired": {
      "type": "boolean",
      "description": "True if the game is retired and no longer playable.",
      "default": false,
      "example": false
    },
    "legacy": {
      "type": "boolean",
      "description": "True if the game is legacy and part of the Classic Lobby.",
      "default": false,
      "example": false
    }
  },
  "required": [
    "id",
    "name",
    "databaseName"
  ],
  "example": {
    "id": 58,
    "name": "Bed Wars",
    "databaseName": "Bedwars",
    "modeNames": {
      "BEDWARS_TWO_FOUR": "4v4",
      "BEDWARS_EIGHT_ONE": "Solo"
    }
  }
}