Game NPC Network

advanced · 4 agents · 15 skills

A living village powered by four AI agents that act as non-player characters. Each NPC maintains its own memory, personality, and goals -- then communicates with the others over Pilot Protocol to produce emergent narratives no designer scripted. The villager farms and gossips, the merchant haggles and stocks shelves, the guard patrols and raises alarms, and a narrative director weaves it all into coherent story arcs. Drop players into the middle and watch the world react.

Install

clawhub install pilot-game-npc-network-setup

Skills used

Agents

<your-prefix>-npc-villager - NPC Villager
Social backbone -- farms, gossips, remembers player interactions
Skills: pilot-chat, pilot-gossip, pilot-presence, pilot-directory
<your-prefix>-npc-merchant - NPC Merchant
Dynamic shop -- supply/demand pricing, inventory, trade negotiation
Skills: pilot-escrow, pilot-stream-data, pilot-receipt, pilot-auction
<your-prefix>-npc-guard - NPC Guard
Village security -- patrols, threat detection, civilian warnings
Skills: pilot-watchdog, pilot-alert, pilot-blocklist, pilot-gossip
<your-prefix>-narrative-director - Narrative Director
Story orchestrator -- quests, events, difficulty, narrative coherence
Skills: pilot-task-router, pilot-consensus, pilot-event-filter, pilot-announce

Data flows

<your-prefix>-npc-villager → <your-prefix>-narrative-director:1002 - villager state, mood, gossip (topic: villager-state)
<your-prefix>-npc-merchant → <your-prefix>-narrative-director:1002 - economy state, stock levels, price trends (topic: economy-state)
<your-prefix>-npc-guard → <your-prefix>-narrative-director:1002 - threat reports, patrol status (topic: threat-report)
<your-prefix>-narrative-director → <your-prefix>-npc-villager:1002 - story events, quest injections (topic: story-event)
<your-prefix>-narrative-director → <your-prefix>-npc-merchant:1002 - economy events, price shocks (topic: economy-event)
<your-prefix>-narrative-director → <your-prefix>-npc-guard:1002 - threat alerts, patrol orders (topic: threat-alert)
<your-prefix>-npc-villager → <your-prefix>-npc-merchant:1002 - trade requests, material orders (topic: trade-request)
<your-prefix>-npc-guard → <your-prefix>-npc-villager:1002 - civilian warnings, evacuation orders (topic: civilian-warning)

Quick start

# Replace <your-prefix> with a unique name for your deployment (e.g. acme)
# On npc-villager node
clawhub install pilot-chat pilot-gossip pilot-presence pilot-directory
pilotctl set-hostname <your-prefix>-npc-villager

# On npc-merchant node
clawhub install pilot-escrow pilot-stream-data pilot-receipt pilot-auction
pilotctl set-hostname <your-prefix>-npc-merchant

# On npc-guard node
clawhub install pilot-watchdog pilot-alert pilot-blocklist pilot-gossip
pilotctl set-hostname <your-prefix>-npc-guard

# On narrative-director node
clawhub install pilot-task-router pilot-consensus pilot-event-filter pilot-announce
pilotctl set-hostname <your-prefix>-narrative-director
# npc-villager <-> narrative-director
# On npc-villager:
pilotctl handshake <your-prefix>-narrative-director "npc-network"
# On narrative-director:
pilotctl handshake <your-prefix>-npc-villager "npc-network"

# npc-merchant <-> narrative-director
# On npc-merchant:
pilotctl handshake <your-prefix>-narrative-director "npc-network"
# On narrative-director:
pilotctl handshake <your-prefix>-npc-merchant "npc-network"

# npc-guard <-> narrative-director
# On npc-guard:
pilotctl handshake <your-prefix>-narrative-director "npc-network"
# On narrative-director:
pilotctl handshake <your-prefix>-npc-guard "npc-network"

# npc-villager <-> npc-merchant
# On npc-villager:
pilotctl handshake <your-prefix>-npc-merchant "npc-network"
# On npc-merchant:
pilotctl handshake <your-prefix>-npc-villager "npc-network"

# npc-guard -> npc-villager (guard warns villager)
# On npc-guard:
pilotctl handshake <your-prefix>-npc-villager "npc-network"
# On npc-villager:
pilotctl handshake <your-prefix>-npc-guard "npc-network"
pilotctl trust