{
 "schema_version": 1,
 "generated": "2026-10-26",
 "id": "christos-antono-npctalk--make-npcs-follow-spoken-orders",
 "repo": "christos-antono/NPCTalk",
 "repo_url": "https://github.com/christos-antono/NPCTalk",
 "repo_slug": "christos-antono-npctalk",
 "title": "Make NPCs act on what you tell them",
 "page_title": "How to make NPCs act on what you tell them with NPC Talk",
 "summary": "Add the npc-actions skill so NPCs physically react while talking and follow spoken orders in your game.",
 "who": "A game developer or modder who wants NPC conversations to change what happens in the game.",
 "problem": "Talking NPCs feel hollow if they never move, react or do what the player asks.",
 "outcome": "NPCs that choose actions while they talk and follow spoken orders, mapped to your game's animations with per-action thresholds.",
 "steps": [
  "Get one NPC answering typed text in the game first with the make-npcs-talk skill",
  "Set TYPESAFE_API_KEY as an environment variable",
  "Ask the npc-actions skill to define the actions and orders your NPCs can follow",
  "Set per-action thresholds and map each action to an animation",
  "Verify in the real game with every step's timing logged"
 ],
 "agent_prompt": "With christos-antono/NPCTalk, add the npc-actions skill to my <game> NPCs so they can <actions> when the player asks, set conservative per-action thresholds, map them to animations, and log timings while I test.",
 "agents": [
  "claude-code",
  "codex",
  "cursor",
  "gemini-cli"
 ],
 "difficulty": "Advanced",
 "time": "2 hours",
 "basis": "readme",
 "caveat": "",
 "category": "Games and hobbies",
 "tags": [
  "Games and hobbies"
 ],
 "lang": "python",
 "requirements": [
  "A game you own, ideally single-player (the README says never inject into online games with anti-cheat)",
  "Git, Python 3.10+, uv and ffmpeg",
  "A Modal account for the GPU voice server, with the NPCVOICE_TOKEN environment variable set",
  "A fal key (FAL_KEY) for speech-to-text and the MCP server",
  "A Cerebras key (CEREBRAS_API_KEY) for the NPC's lines",
  "Optional: a TypeSafe key (TYPESAFE_API_KEY) for actions and spoken orders",
  "Windows and the .NET SDK (8+) only if you follow the GTA V example"
 ],
 "risk": "dual-use",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [
  {
   "tag": "credentials",
   "notice": "TypeSafe, fal, Cerebras and Modal keys go in environment variables, never files; run npctalk check before sharing anything."
  }
 ],
 "best": false,
 "score": 0.7,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/christos-antono-npctalk/make-npcs-follow-spoken-orders/",
 "md": "https://dedupedai.com/use-cases/christos-antono-npctalk/make-npcs-follow-spoken-orders/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/christos-antono-npctalk--make-npcs-follow-spoken-orders.json",
 "api_version": "v1"
}
