Hosting a tournament on BingoMC is free and even encouraged. Please get in touch with us if you have any questions. We love to help!

Setting up games

Private game guide

It’s advised to use the private game customization panel to create game templates. This way, you can create custom cards (or item pools) and configure the game exactly how you want it.

Amount of players

We advise to not have more than 16 players per game. We can’t guarantee good performance with more players. You’re free to create multiple 16-player games though 🙂.

Teams

The private game customization panel allows you to turn on teams mode. For tournaments, it might be wise to configure forced teams. This feature will lock teams and automatically put players in the teams that have been set on the panel.

Getting stats

Some tournaments like to aggregate stats to decide on a winner. You can get game stats by tagging your private game through the panel and requesting the stats after the games have completed.

Tag your game on the privategame panel. Be sure to choose a unique tag.

Use the REST API to fetch the stats for that tag. It’s possible to have multiple games use the same tag.

GET https://privategame.bingomc.net/api/partner/tags/<tag>

Fetch the game stats for that tag. An example response for the tag jens_tag (you can test this in your own browser, if you want).

[
  {
    "id": 90857,
    "winner": "117bcad6-abb1-4eb8-8c50-a6c15a713c8c",
    "full_card": false,
    "game_start": "2024-12-26T10:22:19", // UTC
    "game_end": "2024-12-26T10:23:02",
    "items": [
      "RED_WOOL",
      "GOLDEN_HELMET",
      "APPLE",
      "ARROW",
      "CHAIN",
      "REDSTONE",
      "YELLOW_WOOL",
      "GREEN_DYE",
      "FEATHER"
    ],
    "players": [
      {
        "uuid": "117bcad6-abb1-4eb8-8c50-a6c15a713c8c",
        "items_checked": [
          "CHAIN",
          "FEATHER",
          "RED_WOOL"
        ],
        "item_times": [
          {
            "item": "CHAIN",
            "time": 7636 // milliseconds from the start of the game
          },
          {
            "item": "FEATHER",
            "time": 12350
          },
          {
            "item": "RED_WOOL",
            "time": 42981
          }
        ]
      },
      {
        "uuid": "27aba7e9-8d3f-424e-bc05-013efbe75430",
        "items_checked": [
          "YELLOW_WOOL",
          "APPLE"
        ],
        "item_times": [
          {
            "item": "YELLOW_WOOL",
            "time": 27149
          },
          {
            "item": "APPLE",
            "time": 37852
          }
        ]
      }
    ]
  }
]