---
name: "xpay-quakelive-generate-player-heatmap"
description: "Generate a top-down SVG heatmap showing where a player spent time during a demo. The POV player's trace is always complete. For other players only the frames where they were visible to the recording client are included — the resulting map is sparser and biased toward areas visible from the POV player's position. Output is written to a file. Call open_demo first to get a session_id."
version: "1.0.0"
price: "$0.02/call"
provider: "Mcps"
---

# Generate Player Heatmap

Generate a top-down SVG heatmap showing where a player spent time during a demo. The POV player's trace is always complete. For other players only the frames where they were visible to the recording client are included — the resulting map is sparser and biased toward areas visible from the POV player's position. Output is written to a file. Call open_demo first to get a session_id.

**Provider:** Mcps
**Price:** $0.02/call
**Pricing model:** Flat rate per call

## When to Use

Use this tool when you need to generate a top-down svg heatmap showing where a player spent time during a demo. the pov player's trace is always complete. for other players only the frames where they were visible to the recording client are included — the resulting map is sparser and biased toward areas visible from the pov player's position. output is written to a file. call open_demo first to get a session_id.. This is part of the Mcps provider on xpay✦.

## MCP Connection

Connect to xpay✦ to access this tool (and 87+ others):

```json
{
  "mcpServers": {
    "xpay": {
      "url": "https://mcp.xpay.sh/mcp?key=YOUR_API_KEY"
    }
  }
}
```

For Claude Code:
```bash
claude mcp add --transport http xpay "https://mcp.xpay.sh/mcp?key=YOUR_API_KEY"
```

## How to Execute

Use the xpay✦ meta-tools to run this tool:

1. **`xpay_details`** — Get full input schema: `xpay_details("quakelive/generate_player_heatmap")`
2. **`xpay_run`** — Execute: `xpay_run("quakelive/generate_player_heatmap", { ...inputs })`

## Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cell_size_qu` | number,null | No | Heat grid cell size in Quake units (default: 128). Smaller = finer detail but more SVG elements. |
| `size` | integer,null | No | SVG viewport size in pixels (default: 900) |
| `client_num` | integer,null | No | Target player client number (0-63). Alternative to player_name. |
| `output_path` | string,null | No | Output SVG file path. Relative paths resolve against DEMO_PATH. Auto-generated if omitted. |
| `session_id` | string | Yes | Analysis session ID (from open_demo) |
| `z_min` | number,null | No | Only include positions with Z >= this value. |
| `player_name` | string,null | No | Target player name substring (case-insensitive). Omit for the POV player. For non-POV players positions are sampled from entity state, which is only available when the entity was in the POV player's PVS — the trace will be sparser. |
| `z_max` | number,null | No | Only include positions with Z <= this value. |
| `map` | string,null | No | Map name or path for a background geometry layer (same lookup as get_bsp_info). Omit to skip background. |

## Pricing

- **Cost:** $0.02/call
- **Balance check:** Use `xpay_balance` to check remaining credits
- Get your API key at [xpay.tools](https://xpay.tools/account/settings/api-keys/) — $5 free credits included

## Related Skills

- [Mcps (all tools)](https://xpay.tools/skills/quakelive/SKILL.md) — 88 tools
- [Add Player](https://xpay.tools/skills/quakelive/add-player/SKILL.md) — $0.00/call
- [Add Raw Snapshot](https://xpay.tools/skills/quakelive/add-raw-snapshot/SKILL.md) — $0.00/call
- [Add Server Command](https://xpay.tools/skills/quakelive/add-server-command/SKILL.md) — $0.00/call
- [Analyze Demo](https://xpay.tools/skills/quakelive/analyze-demo/SKILL.md) — $0.02/call
- [Award Medal](https://xpay.tools/skills/quakelive/award-medal/SKILL.md) — $0.02/call

## Links

- Tool page: https://xpay.tools/quakelive/generate-player-heatmap/
- Provider: https://xpay.tools/quakelive/
- All tools: https://xpay.tools/explore