Describe Map
describe_mapAnalyse a BSP map (from a pk3 or direct .bsp file) and return a JSON MapSpec that describes its geometry and entities. What is extracted: • worldspawn settings: sky, gravity, ambient, music, name • All game entities verbatim (weapons, spawns, flags, teleporters, …) • Rooms: detected by pairing floor surfaces (normal ≈ +Z) with ceiling surfaces (normal ≈ −Z) that share the same XY footprint. Each matched pair becomes one RoomSpec with mins/maxs, floor_texture, ceil_texture, and wall_texture. The returned spec can be fed directly to generate_map to produce a geometrically similar BSP (roundtrip is lossless for simple axis-aligned maps; complex maps are approximated as rectangular rooms). Typical workflow: 1. describe_map("cpma1") → inspect / tweak the spec JSON 2. generate_map(spec) → new .bsp that resembles cpma1 3. Use new .bsp in demos
When to Use
Use this tool when you need to analyse a bsp map (from a pk3 or direct .bsp file) and return a json mapspec that describes its geometry and entities.
what is extracted: • worldspawn settings: sky, gravity, ambient, music, name • all game entities verbatim (weapons, spawns, flags, teleporters, …) • rooms: detected by pairing floor surfaces (normal ≈ +z) with ceiling surfaces (normal ≈ −z) that share the same xy footprint. each matched pair becomes one roomspec with mins/maxs, floor_texture, ceil_texture, and wall_texture.
the returned spec can be fed directly to generate_map to produce a geometrically similar bsp (roundtrip is lossless for simple axis-aligned maps; complex maps are approximated as rectangular rooms).
typical workflow:
- describe_map("cpma1") → inspect / tweak the spec json
- generate_map(spec) → new .bsp that resembles cpma1
- use new .bsp in demos. This is part of the Mcps provider on xpay✦.
MCP Connection
Connect to xpay✦ to access this tool (and 87+ others):
{
"mcpServers": {
"xpay": {
"url": "https://mcp.xpay.sh/mcp?key=YOUR_API_KEY"
}
}
}
For Claude Code:
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:
xpay_details— Get full input schema:xpay_details("quakelive/describe_map")xpay_run— Execute:xpay_run("quakelive/describe_map", { ...inputs })
Input Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
map | string | Yes | Map name or path (same lookup rules as get_bsp_info). Can be a bare name like 'campgrounds', a name with extension 'campgrounds.bsp', or an absolute file path. Searched in MAP_DIR first, then inside pk3 archives under WOLFCAMQL_BASEPATH. |
Pricing
- Cost: $0.02/call
- Balance check: Use
xpay_balanceto check remaining credits - Get your API key at xpay.tools — $5 free credits included
Related Skills
- Mcps (all tools) — 88 tools
- Add Player — $0.00/call
- Add Raw Snapshot — $0.00/call
- Add Server Command — $0.00/call
- Analyze Demo — $0.02/call
- Award Medal — $0.02/call
Links
- Tool page: https://xpay.tools/quakelive/describe-map/
- Provider: https://xpay.tools/quakelive/
- All tools: https://xpay.tools/explore
How to Execute
Input Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
map | string | Yes | Map name or path (same lookup rules as get_bsp_info). Can be a bare name like 'campgrounds', a name with extension 'campgrounds.bsp', or an absolute file path. Searched in MAP_DIR first, then inside pk3 archives under WOLFCAMQL_BASEPATH. |
Install Skill
Pricing
Cost
$0.02/call
Model
Flat rate
Provider
Mcps