Skip to Content
DocsLoremind PlatformLoreMind Platform

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:

  1. Sign up  and create a project
  2. Create a Server API Key in Projects → API Keys
  3. 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:

  1. Authenticates players through your systems (Steam, Epic, custom)
  2. Receives NPC interaction requests from game clients
  3. Builds rich context from your game state
  4. Calls LoreMind with the context
  5. 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

EndpointMethodDescription
/npc/interactPOSTGenerate NPC response
/lore/documentsGETList lore documents
/lore/mindsGETList Entity Minds
/auth/sessionPOSTCreate 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:

SectionPurpose
ProjectsManage game projects and API keys
LoreUpload and organize world knowledge
Entity MindsCreate and configure NPC personalities
PlaygroundTest NPC responses in browser
BillingPurchase credits, view usage analytics
SettingsRate limits, team members, webhooks

Getting Started

  1. Sign up  and create a project
  2. Upload lore - Add your game’s world knowledge
  3. Create Entity Minds - Configure NPC personalities
  4. Integrate your server - See Server Integration Guide
  5. Connect your game client - Use the Unity SDK or call the API directly

Next Steps

Last updated on