# AINPCEngine — AI-Powered NPC Engine for Game Studios
# https://ainpcengine.com

## What is this?
AINPCEngine gives game NPCs persistent memory, real personalities, and multi-agent intelligence.
Send game events → get intelligent NPC responses. REST + WebSocket API. Unity, Unreal, Godot SDKs.

## Authentication
Every request requires two headers:
  x-api-key: YOUR_API_KEY
  x-game-id: YOUR_GAME_ID

Sign up free at https://ainpcengine.com/auth/register (1 NPC, 1000 interactions/month, no card).

## Quick Start
1. Create NPC:     POST /api/npcs {name, role, personality: {traits, speechStyle, backstory, values}}
2. Send event:     POST /api/npcs/:id/event {type: "player_dialogue", playerId, message, context}
3. Get response:   → {response: {dialogue, emotion, action, tradeOffer}, tokenUsage}

## Key Endpoints
POST   /api/npcs                    Create NPC
GET    /api/npcs                    List NPCs
GET    /api/npcs/:id                Get single NPC
PATCH  /api/npcs/:id                Update NPC
DELETE /api/npcs/:id                Delete NPC
POST   /api/npcs/:id/event          Send game event (dialogue, combat, trade, quest...)
POST   /api/events                   Batch events (up to 50)
POST   /api/npcs/generate            NPC Persona — AI-generate NPC with persona + schedule + psychology
POST   /api/npcs/generate-batch      Batch generate with social links
GET    /api/stats                    Expert registry + cognitive features
GET    /api/health                   Healthcheck
WS     /ws?apiKey=X&gameId=Y        Real-time game event streaming

## 12 Event Types
player_approached, player_dialogue, player_left, combat_started, combat_ended,
trade_requested, trade_completed, quest_accepted, quest_completed, quest_failed,
ambient_trigger, world_event, npc_interaction

## SDKs
Unity (C#):   Copy sdk/unity/ → Assets/Plugins/AINPCEngine/
Unreal (C++): Copy sdk/unreal/AINPCEngine/ → Plugins/
Godot (GD):   Copy sdk/godot/addons/ainpcengine/ → addons/

## Demo Repos (clone and run)
Unity:   https://github.com/jyswee/ainpc-unity-demo
Unreal:  https://github.com/jyswee/ainpc-unreal-demo
Godot:   https://github.com/jyswee/ainpc-godot-demo

## Agent Integration
Skill file (API key required):  https://ainpcengine.com/api/docs/skill.md
OpenAPI spec (API key required): https://ainpcengine.com/api/docs/openapi.json
Quickstart guides:               https://ainpcengine.com/docs/quickstart.html

## Pricing
Free: $0/mo (1 NPC, 1K interactions)
Indie: $29/mo (25 NPCs, 10K interactions)
Studio: $99/mo (100 NPCs, 50K interactions, all 9 Mind Modules)
Enterprise: $499/mo (unlimited)

## Company
AINPCEngine is a product of Tyga.Cloud Ltd — https://tyga.cloud
Contact: hello@ainpcengine.com