Game characters

• A character with a persona and a voice that players talk to out loud, in any language, cutting in whenever they like.
• Your API key stays on your server. Each player’s client gets a one-use secret that opens a session already set up as your character, and it cannot change what you lock.
• Live game state the character reads before every reply, tools your game runs, and memories kept per player.
• Audio goes straight from the player’s client to EESI. Your server never relays it.

​

Run it

npm install github:eesi-ai/eesi-sdk-typescript
export EESI_API_KEY=sk-eesi-...
node server.mjs

import { createServer } from "node:http";
import { NurClient } from "@eesi/sdk";

const nur = new NurClient();
const kael = nur.npc({ name: "Kael", persona: "The gatekeeper of Eldermoor. Wry, watchful, fair to honest folk.", voice: "Atlas" });

createServer(async (request, response) => {
  // Your own login decides who the player is, never the request.
  const secret = await kael.clientSecret({ playerId: "player-1", context: { location: "the northern gate" }, lock: "all" });
  response.writeHead(200, { "content-type": "application/json" }).end(JSON.stringify(secret.join));
}).listen(8080);

import { joinSession } from "@eesi/sdk";
import { browserAudio } from "@eesi/sdk/browser";

const join = await (await fetch("/join", { method: "POST" })).json();
const session = await joinSession(join, { audio: await browserAudio() });

​

In an engine

​

Make it part of the game

• Live state. Mint the secret with control: true, and your server can update what the character knows while the player talks: const session = await kael.control(secret).start(); await session.context.update({ health: "6/20" }).
• Tools. Give the character functions your game runs, such as opening a gate or selling an item. With control: true they run on your server, which checks each call first.
• Speaking first. session.cue("The player just drew a sword.") makes the character react as soon as nobody is talking.
• Several players. nur.multiplayerNpc(...) keeps one character’s story straight across everyone who talks to it.

​

Next