LoreMind Platform
AI-powered NPC intelligence for games. Give your NPCs real knowledge, personalities, and dynamic conversations.
Quick Test
Test the API in 2 minutes:
- Sign up and create a project
- Create a Server API Key in Projects → API Keys
- Run this curl:
curl -X POST https://loremind.peekgames.dev/api/loremind/v1/npc/interact \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"text": "Hello, what do you do here?",
"character": { "name": "Town Guard" }
}'You’ll get an NPC response immediately. Add entityMindId once you’ve created Entity Minds in the dashboard.
Features
Intelligence
AI-powered NPC responses with game-specific knowledge. Upload your lore, configure NPC personalities, and LoreMind handles the AI complexity.
Long-Term Memory
NPCs remember players across sessions. A blacksmith recalls that you helped defend their shop, a merchant remembers your past purchases, a guard recognizes a returning troublemaker.
- Automatic extraction - Key facts extracted from conversations (not raw logs)
- Hybrid retrieval - Semantic + keyword + recency scoring
- Memory consolidation - Similar memories merge to prevent bloat
- Per-player scoping - Each player builds unique history with each NPC
Requires Server Mediated mode with playerId. See Long-Term Memory docs.
Dashboard
Web interface for teams to manage projects, purchase credits, configure rate limits, and test NPC behaviors.
Architecture
Production games integrate LoreMind through their game server:
Your server:
- Authenticates players through your systems (Steam, Epic, custom)
- Receives NPC interaction requests from game clients
- Builds rich context from your game state
- Calls LoreMind with the context
- Returns responses to clients
This architecture gives you full control over access, rate limiting, and player management while LoreMind handles the AI complexity.
See the Server Integration Guide for implementation patterns.
Platform Components
Lore Store
Upload your game’s world knowledge:
- World history and lore documents
- Location descriptions
- Faction backstories
- Item descriptions
- Character backgrounds
Documents are chunked, embedded, and indexed for semantic search. When players talk to NPCs, relevant lore is retrieved automatically.
Entity Minds
Configure each NPC’s personality:
- Name and role
- Personality traits and speaking style
- Backstory and motivations
- Knowledge scope (which lore tags they can access)
- Relationships with other NPCs
- Response settings (verbosity, temperature)
Entity Minds are created in the dashboard and referenced by ID in your game.
Player Memory
NPCs remember individual players across sessions:
- Automatic extraction of important conversation moments
- Semantic search for relevant memories
- PII filtering for privacy compliance
- Per-player, per-NPC memory isolation
Memory requires Server Mediated authentication to identify players.
Credit System
Usage-based billing with no subscriptions:
- Pay for what you use
- Credits never expire
- Volume discounts available
- Real-time cost tracking
- Auto-reload with spending caps
API Overview
All endpoints at https://loremind.peekgames.dev/api/loremind/v1/
Core Endpoints
| Endpoint | Method | Description |
|---|---|---|
/npc/interact | POST | Generate NPC response |
/lore/documents | GET | List lore documents |
/lore/minds | GET | List Entity Minds |
/auth/session | POST | Create client session (Direct Client only) |
Request Example
POST /npc/interact
Authorization: Bearer sk_server_...
{
"text": "What can you tell me about the dragon?",
"entityMindId": "clxyz_blacksmith",
"playerId": "steam_76561198012345678",
"memory": { "retrieve": true },
"context": {
"location": "Blacksmith Shop",
"timeOfDay": "evening",
"playerReputation": "trusted ally",
"recentEvents": ["Dragon spotted near the village"]
}
}Response Example
{
"success": true,
"response": "The dragon? Aye, I've heard the rumors. Spotted near the old watchtower, they say. If you're thinking of going after it, you'll need better steel than what you're carrying.",
"character": "Grom the Blacksmith",
"metadata": {
"creditsUsed": 0.45,
"creditsRemaining": 9543.20,
"loreChunksUsed": 3,
"memoriesUsed": 1,
"latency": { "total": 1823 }
}
}Dashboard
The web dashboard at loremind.peekgames.dev provides:
| Section | Purpose |
|---|---|
| Projects | Manage game projects and API keys |
| Lore | Upload and organize world knowledge |
| Entity Minds | Create and configure NPC personalities |
| Playground | Test NPC responses in browser |
| Billing | Purchase credits, view usage analytics |
| Settings | Rate limits, team members, webhooks |
Getting Started
- Sign up and create a project
- Upload lore - Add your game’s world knowledge
- Create Entity Minds - Configure NPC personalities
- Integrate your server - See Server Integration Guide
- Connect your game client - Use the Unity SDK or call the API directly
Next Steps
- Server Integration Guide - Architecture patterns for production
- Authentication - Set up Server Mediated mode
- Entity Minds - Configure NPC personalities
- Unity SDK - Client-side integration