# NPC Dialogue Template Selector

> NPC Dialogue Template Selector is a paid API for AI agents from gaming.halowerk.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-14).

Selects and fills a small declared dialogue template deterministically from seed, NPC name, intent, tone, and facts to produce a reproducible writing prompt for NPC speech.

## Facts

- Endpoint: POST https://gaming.halowerk.com/v1/npc-dialogue-gen
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/npc-dialogue-template-selector-d99ff2c4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TJ_TSxtp9W2FEEBIaDnuN

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability npc-dialogue-template-selector-d99ff2c4 -d '<json body>'
```

Example prompt: Generate a warm greeting dialogue prompt for my NPC named Elder Maren addressing the player Kael — use the seed 'village-intro-42', and include these facts: 'she has lived here 80 years' and 'the harvest was good this season'.

## When to prefer this

Choose this endpoint when you need deterministic, reproducible NPC dialogue prompts seeded for consistency across game sessions — particularly when you want to template-fill dialogue rather than invoke a full language model. Ideal for game pipelines that need lightweight, cheap, and predictable prompt scaffolding without lore verification or localization.

## Known failure modes

- Invalid or missing seed causes template selection failure
- Unsupported tone or intent enum value returns a validation error
- Facts array exceeding 20 items or individual fact exceeding 512 characters rejected
- Missing required fields (seed, npc_name, intent, tone, facts) returns 400 error
- Payment not provided or insufficient USDC results in 402 Payment Required

## How this service works

Selects and fills a small declared dialogue template using a caller-supplied seed, NPC name, intent, tone, and facts. It produces a reproducible writing prompt, not model-generated prose, lore verification, localization, or a complete conversation system.

## Output

A reproducible, filled dialogue writing prompt string derived from a declared template, seeded for determinism. The output is a prompt scaffold — not AI-generated prose — containing the NPC name, player name, tone-appropriate phrasing, and surfaced facts, suitable for use as input to a writing or narration step.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "seed": {
   "type": "string",
   "maxLength": 256,
   "minLength": 1,
   "description": "Stable seed used only for deterministic template selection."
  },
  "tone": {
   "enum": [
    "warm",
    "formal",
    "wary",
    "urgent",
    "dry"
   ],
   "type": "string"
  },
  "facts": {
   "type": "array",
   "items": {
    "type": "string",
    "maxLength": 512,
    "minLength": 1,
    "description": "A fact that may be surfaced verbatim."
   },
   "maxItems": 20,
   "minItems": 1
  },
  "intent": {
   "enum": [
    "greet",
    "warn",
    "offer_quest",
    "trade",
    "refuse"
   ],
   "type": "string"
  },
  "npc_name": {
   "type": "string",
   "maxLength": 128,
   "minLength": 1
  },
  "player_name": {
   "type": "string",
   "maxLength": 128,
   "minLength": 1
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/npc-dialogue-template-selector-d99ff2c4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gaming.halowerk.com](https://www.zero.xyz/host/gaming.halowerk.com/llms.txt)
