NPCs that react to your game

import { npc } from '@npc/client';

// 1. Initialize NPC brain with public key & character ID
const smith = npc({
  key: 'pk_live_your_game_key',
  id: 'smith',
});

// 2. React to game events from your physics or input loop
async function onPlayerInteract(event, worldState) {
  // react() NEVER throws. Always returns guaranteed behaviour.
  const reaction = await smith.react(event, worldState);

  switch (reaction.behaviour) {
    case 'greet':     playAnimation('wave'); break;
    case 'warn':      playAnimation('angry'); break;
    case 'offer_deal': openShopUI(); break;
    case 'throw_out': ejectPlayer(); break;
  }

  if (reaction.say) {
    showSpeechBubble(reaction.say);
  }
}

// 3. Fire-and-forget background observations (memory only)
smith.observe('player completed the dragon cavern quest');