Heatmaps

Heatmaps can be created using any marker data sent from your experience that has the position argument filled, such as player joins, player leaves, or custom markers.

Creating a HeatmapCopy Anchor Link

Generating the heatmap visualizationCopy Anchor Link

To create a heatmap, you first need to generate the heatmap visualization through the Gamebeast plugin in Roblox Studio.

To do this, open the Gamebeast plugin in Roblox Studio and navigate to the "Heatmap" tab. To edit, create, or delete a heatmap visualization, you'll need to provide an API key, which can be created through the dashboard.

Heatmap generation controlsCopy Anchor Link

After entering your API key, you can create a new heatmap visualization by clicking the "Create Heatmap" button, or modify an existing heatmap by selecting it from list. You can also delete a heatmap visualization by selecting it from the list and clicking the trash icon.

The menu for creating or editing a heatmap visualization contains the following options:

---

NameCopy Anchor Link

The name of the heatmap visualization. The name can be used to identify the heatmap in the Gamebeast dashboard.

---

Edit PointsCopy Anchor Link

These buttons allow you to quickly edit the points that make up the rendered region of the heatmap in the workspace.

Clicking "A" or "B" will automatically select and move your camera to the point A or B, respectively, allowing you to edit the points.

Clicking the square button will automatically set point A and B to the bounds of what you have selected in the workspace.

---

ImageCopy Anchor Link

The image preview of the heatmap visualization. This is generated from the points you edit.

By pressing the "Render Image" button, the heatmap will be rendered and the image will be updated. This process may take a 10-20 seconds, depending on the size of the area you are rendering and the performance of your device.

---

DescriptionCopy Anchor Link

A brief description of the heatmap visualization. This can be used to provide context for the heatmap to collaborators, such as what area it represents.

---

Creating a heatmap in the Gamebeast dashboardCopy Anchor Link

Similarly to how you can make other visualizations in the Query Builder, heatmaps are utilized through the Gamebeast dashboard. To create a heatmap, navigate to the Boards page in the Gamebeast dashboard. Here, you can create a new board or add to an existing board.

When creating or editing a query, select the "Heatmap" tab on the top right, and select a map. This will allow you to visualize your data as a heatmap.

Heatmaps and heatmap queriesCopy Anchor Link

The two steps above create two different things:

• A heatmap is the map: the region between points A and B, its resolution, and the rendered image. The Studio plugin creates it, and you can rename, re-describe, preview, or delete it on the Heatmaps tab of the Data page. Deleting a heatmap breaks every query that uses it.
• A heatmap query is a chart that counts one marker's positions on a heatmap, over a time range and with optional filters. You build it in the Query Builder and save it to a board like any other query. Many queries can use the same heatmap.

Ask the assistant or an AI agentCopy Anchor Link

The Gamebeast assistant and agents connected over MCP can work with heatmaps:

• Build a heatmap query from a question, such as "where do new players die on Arena?", and explain where the hotspots are.
• Run, save, and edit heatmap queries on your boards. Saving and editing need the same permissions as in the Query Builder, and in the assistant each change waits for your approval.
• Look at a heatmap's image, so they can describe hotspots by place rather than by coordinates.

They can't create or change the heatmaps themselves. Those always come from the Studio plugin.