---
name: "xpay-quakelive-extract-map-lights"
description: "Extract light sources from a BSP map. Returns lights from two sources: (1) entity lights — 'light' entities in the BSP entity lump with position, intensity, color, radius. (2) lightgrid-mined lights — inferred from the baked radiosity lightgrid by finding bright spots and clustering nearby samples. Useful for path tracing setup: pass extracted lights to the renderer's point light buffer. Parameters: include_lightgrid (default true), lightgrid_threshold (0-255, default 180), cluster_radius (Quake units, default 128)."
version: "1.0.0"
price: "$0.02/call"
provider: "Mcps"
---

# Extract Map Lights

Extract light sources from a BSP map. Returns lights from two sources: (1) entity lights — 'light' entities in the BSP entity lump with position, intensity, color, radius. (2) lightgrid-mined lights — inferred from the baked radiosity lightgrid by finding bright spots and clustering nearby samples. Useful for path tracing setup: pass extracted lights to the renderer's point light buffer. Parameters: include_lightgrid (default true), lightgrid_threshold (0-255, default 180), cluster_radius (Quake units, default 128).

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

## When to Use

Use this tool when you need to extract light sources from a bsp map. returns lights from two sources: (1) entity lights — 'light' entities in the bsp entity lump with position, intensity, color, radius. (2) lightgrid-mined lights — inferred from the baked radiosity lightgrid by finding bright spots and clustering nearby samples. useful for path tracing setup: pass extracted lights to the renderer's point light buffer. parameters: include_lightgrid (default true), lightgrid_threshold (0-255, default 180), cluster_radius (quake units, default 128).. 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/extract_map_lights")`
2. **`xpay_run`** — Execute: `xpay_run("quakelive/extract_map_lights", { ...inputs })`

## Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `include_lightgrid` | boolean,null | No | Also mine lightgrid for inferred lights (default: true) |
| `lightgrid_threshold` | integer,null | No | Lightgrid brightness threshold 0-255 (default: 180). Lower = more lights. |
| `cluster_radius` | number,null | No | Cluster radius in Quake units for grouping nearby lightgrid samples (default: 128) |
| `map` | string | Yes | BSP map (bare name, path, or pk3 lookup) |

## 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/extract-map-lights/
- Provider: https://xpay.tools/quakelive/
- All tools: https://xpay.tools/explore