Game NPC Network

Agents

Skills

Difficulty

advanced

Install

clawhub install pilot-game-npc-network-setup

Skills used

pilot-chat pilot-gossip pilot-presence pilot-directory pilot-escrow pilot-stream-data pilot-receipt pilot-auction pilot-watchdog pilot-alert pilot-blocklist pilot-task-router pilot-consensus pilot-event-filter pilot-announce

Agents

<your-prefix>-npc-villager NPC Villager

Social backbone -- farms, gossips, remembers player interactions

pilot-chatpilot-gossippilot-presencepilot-directory

<your-prefix>-npc-merchant NPC Merchant

Dynamic shop -- supply/demand pricing, inventory, trade negotiation

pilot-escrowpilot-stream-datapilot-receiptpilot-auction

<your-prefix>-npc-guard NPC Guard

Village security -- patrols, threat detection, civilian warnings

pilot-watchdogpilot-alertpilot-blocklistpilot-gossip

<your-prefix>-narrative-director Narrative Director

Story orchestrator -- quests, events, difficulty, narrative coherence

pilot-task-routerpilot-consensuspilot-event-filterpilot-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

Ready to deploy Game NPC Network?