---
name: "xpay-quakelive-preview-map-plan"
description: "Render a fast top-down geometric SVG preview of a planned map spec WITHOUT generating a BSP file.  Use this as part of a planning workflow:
1. Construct or refine a MapSpec JSON
2. Call preview_map_plan to show the user a visual layout
3. Iterate on the spec based on feedback
4. Call generate_map once the user approves

The preview draws each room as a coloured rectangle labelled with its id and dimensions (width × depth × height in Quake units), corridors as grey bands connecting room centres, and items as colour-coded dots identical to the generate_map_minimap legend.

Returns the SVG path / upload URL plus a spec echo so the caller can confirm what was interpreted."
version: "1.0.0"
price: "$0.02/call"
provider: "Mcps"
---

# Preview Map Plan

Render a fast top-down geometric SVG preview of a planned map spec WITHOUT generating a BSP file.  Use this as part of a planning workflow:
1. Construct or refine a MapSpec JSON
2. Call preview_map_plan to show the user a visual layout
3. Iterate on the spec based on feedback
4. Call generate_map once the user approves

The preview draws each room as a coloured rectangle labelled with its id and dimensions (width × depth × height in Quake units), corridors as grey bands connecting room centres, and items as colour-coded dots identical to the generate_map_minimap legend.

Returns the SVG path / upload URL plus a spec echo so the caller can confirm what was interpreted.

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

## When to Use

Use this tool when you need to render a fast top-down geometric svg preview of a planned map spec without generating a bsp file.  use this as part of a planning workflow:
1. construct or refine a mapspec json
2. call preview_map_plan to show the user a visual layout
3. iterate on the spec based on feedback
4. call generate_map once the user approves

the preview draws each room as a coloured rectangle labelled with its id and dimensions (width × depth × height in quake units), corridors as grey bands connecting room centres, and items as colour-coded dots identical to the generate_map_minimap legend.

returns the svg path / upload url plus a spec echo so the caller can confirm what was interpreted.. 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/preview_map_plan")`
2. **`xpay_run`** — Execute: `xpay_run("quakelive/preview_map_plan", { ...inputs })`

## Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `output_path` | string,null | No | Output SVG file path. Relative paths resolve against DEMO_PATH. Auto-generated from the map name if omitted. |
| `spec` | object | Yes | JSON object describing the planned map (same schema as generate_map's spec field). Rooms, corridors, and items are rendered geometrically as a top-down SVG without generating a BSP file. |

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