# Halowerk Quest Generation

> Halowerk Quest Generation 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 assembles a bounded quest outline by mapping a caller seed, theme, target, location, difficulty, and reward parameters to pre-declared objective framing, complication, and reward language templates.

## Facts

- Endpoint: POST https://gaming.halowerk.com/v1/quest-generation
- 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/halowerk-quest-generation-e42dae1b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FE-VmoZDUNypI7L-VUE2a

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 halowerk-quest-generation-e42dae1b -d '<json body>'
```

Example prompt: Generate a quest outline for a dark fantasy theme targeting a corrupted merchant, set in the Sunken Market location, with difficulty 6 and a reward of 500 gold coins — use seed 'shadow-run-42' to keep it reproducible.

## When to prefer this

Choose this endpoint when you need deterministic, reproducible quest outlines driven by a seed (same seed always produces the same quest), and your use case fits template-driven content rather than open-ended AI-authored narrative. Ideal for games needing consistent daily quests, procedural content at scale, or verifiable quest structures for blockchain/Web3 contexts. Not suitable if you need custom lore, scripted encounters, or narrative depth beyond a structured outline.

## Known failure modes

- Invalid seed (empty or over 256 characters) returns a 400 validation error
- Difficulty outside 1–10 range rejected with schema validation error
- Reward base exceeding maximum (1 trillion) returns a bounds error
- Missing required seed or theme fields causes a 422 unprocessable entity
- Unknown or unsupported theme/target/location strings may return a fallback or empty template match

## How this service works

Selects objective framing, complication, and reward language from declared templates using a caller seed. It returns a bounded quest outline, not model-authored narrative, encounter balancing, unique lore, scripting, or playable content.

## Output

A bounded quest outline containing selected objective framing (what the player must do), a complication element, and reward language — all drawn from pre-declared templates. Does not include model-authored narrative, encounter balancing, unique lore, scripting, or playable content.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "seed": {
   "type": "string",
   "maxLength": 256,
   "minLength": 1
  },
  "theme": {
   "type": "string",
   "maxLength": 128,
   "minLength": 1
  },
  "target": {
   "type": "string",
   "maxLength": 128,
   "minLength": 1
  },
  "location": {
   "type": "string",
   "maxLength": 128,
   "minLength": 1
  },
  "difficulty": {
   "type": "integer",
   "maximum": 10,
   "minimum": 1
  },
  "reward_base": {
   "type": "number",
   "maximum": 1000000000000,
   "minimum": 0
  },
  "reward_unit": {
   "type": "string",
   "maxLength": 64,
   "minLength": 1
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-quest-generation-e42dae1b/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)
