Add a game

Walk through setup: pick a platform, name the game, install the integration and check the first event.

Updated September 15, 20262 min read

Setup runs right after sign-up. You can add more games later with New game on the games home.

1. Pick the platform

Choose Minecraft (Java, Bedrock or both) or Roblox (experiences and groups). The platform decides which integration you install and which fields come next.

2. Describe the game

FieldWhat to enter
Game nameUp to 64 characters. You can rename it later.
Address players connect toMinecraft only, for example play.example.net.
Experience IDRoblox only.
TimezoneUsed for daily charts, digests and quiet hours.
Icon and genresOptional. Up to 8 genres.

Saving creates your account, starts the 14-day Pro trial and generates the game's API key. Keys look like ag_live_ followed by 32 characters.

3. Connect data

This is the one required step.

  1. Install the integration for your platform:
  2. Put the API key in the config (Minecraft) or in Analyse.new (Roblox).
  3. Have someone join.

The setup page listens for the first event and flips to connected as soon as it arrives.

4. Optional steps

  • Connect your store so purchases show up next to players. See Stores.
  • Invite your team as Admin, Analyst or Creator, up to 20 invites at once. See Invites.
  • Pick a plan for when the trial ends. See Plans and trial.

Find the key later

Open the game, then Settings and Integration. The page shows:

  • the API key, with Copy, Rotate key and Check connection (only Owners and Admins see the full key),
  • the connection status: Connected, Quiet or Waiting for first event,
  • last event, events today (UTC), live installs, plugin or module version and players online.

Nothing arriving?

  • Minecraft: run /analyse status in the console. It shows the connection, the game and delivery counters, then checks the key. A missing key logs No api-key in config.yml.
  • Roblox: make sure HttpService is on and the script runs on the server, not in a LocalScript. Errors print with an [Analyse] prefix in the output.
  • Check that the key on the server matches the one under Settings, Integration. Rotating the key breaks existing installs until they get the new one.