NPC Runtime

NPC Runtime

NPC Runtime: es un motor local de inteligencia artificial para personajes no jugadores (NPCs) en videojuegos. 

 NPC Runtime: is a local artificial intelligence engine for non-player characters (NPCs) in video games. 

Only for Windows.  - Sólo para Windows.

COMPATIBLE WITH Godot,Unity and UE!

Working on new Updates to Upgrade the software with new Features!!!

🇪🇸 Español

NPC Runtime es un motor de IA local y auto-contenido diseñado específicamente para desarrolladores de videojuegos que desean dotar a sus NPCs de diálogos inteligentes, memoria persistente y reacciones dinámicas al mundo del juego, sin depender de servicios en la nube ni conexión a internet.

🎮 Ventajas para el desarrollo de videojuegos

100% local y portable – Un solo ejecutable que incluye

• Modelos GGUF optimizados – Compatible con modelos cuantizados de llama.cpp (Mistral, Llama, Phi). Bajo consumo de VRAM/RAM.
• API REST simple – Integración trivial desde cualquier motor (Godot, Unity, Unreal, Construct) mediante HTTP.
• Memoria persistente por jugador – Cada jugador tiene su propio historial de conversación y hechos narrativos con cada NPC.
• Eventos del juego en tiempo real – Ataques, cambios de clima, objetos entregados, etc., modifican el estado emocional y el contexto del NPC.
• Panel de control web – Interfaz visual para crear, editar y probar NPCs sin escribir código.
• Estado emocional dinámico – Ánimo, confianza, miedo, energía y estrés afectan las respuestas.

⚙️ Resumen técnico de posibilidades

El runtime gestiona tantos personajes como permita la memoria del modelo.
Define personalidad, tono, historia, temas prohibidos, ejemplos de diálogo y estado emocional inicial.
Historial de conversación (últimos 20 mensajes) + hechos narrativos persistentes que el NPC "recuerda".
Los eventos recientes se incluyen en el prompt del modelo para que el NPC actúe en consecuencia.
Ajusta temperatura, top-p, max tokens y repeat penalty en caliente.
Copia de seguridad y portabilidad de NPCs en formato JSON.
Depuración del pipeline completo (chat, eventos, memoria, narrativa).

🇬🇧 English

NPC Runtime is a local, self-contained AI engine built specifically for game developers who want to give their NPCs intelligent dialogue, persistent memory, and dynamic reactions to the game world — without relying on cloud services or an internet connection.

🎮 Advantages for Game Development

• 100% Local & Portable – A single executable includes llama-server and all dependencies. Runs on Windows with no installation.
• Optimized GGUF Models – Compatible with quantized llama.cpp models (Mistral, Llama, Phi). Low VRAM/RAM footprint.
• Simple REST API – Effortless integration from any engine (Godot, Unity, Unreal, Construct) via HTTP.
• Per-Player Persistent Memory – Each player has their own conversation history and narrative facts with each NPC.
• Real-Time Game Events – Attacks, weather changes, items given, etc., modify NPC emotional state and context.
• Web Control Panel – Visual interface to create, edit, and test NPCs without writing code.
• Dynamic Emotional State – Mood, trust, fear, energy, and stress influence NPC responses.

⚙️ Technical Capabilities Overview

The runtime handles as many characters as the model's memory allows.
Define personality, tone, background, forbidden topics, dialogue examples, and initial emotional state.
Conversation history (last 20 messages) + persistent narrative facts that the NPC "remembers".
Recent events are included in the model's prompt so the NPC acts accordingly.
Adjust temperature, top-p, max tokens, and repeat penalty on the fly.
Backup and portability of NPCs in JSON format.
Full pipeline debugging (chat, events, memory, narrative).

License / Licencia

English

This software is proprietary and confidential. Use, copying, modification, and distribution are strictly prohibited without a valid license issued by the copyright holder.

Español

Este software es propietario y confidencial. Su uso, copia, modificación y distribución están estrictamente prohibidos sin una licencia válida emitida por el titular de los derechos de autor.

⚠️ Aviso de exención de responsabilidad

NPC Runtime es una herramienta que integra modelos de lenguaje de inteligencia artificial de terceros (como llama.cpp y modelos GGUF). El titular de los derechos de autor NO se hace responsable del contenido generado por dichos modelos ni del uso que los usuarios finales hagan del software.

La IA puede fallar. Los modelos de lenguaje pueden producir respuestas inexactas, incoherentes, ofensivas, sesgadas o completamente inventadas (alucinaciones). Estas respuestas no reflejan la opinión ni la intención del desarrollador del software.  La configuración y el ajuste fino (fine-tuning) son críticos. El comportamiento de los NPCs depende directamente del modelo GGUF seleccionado, los parámetros de inferencia (temperatura, top-p, tokens máximos, etc.), el prompt del sistema, los ejemplos de diálogo proporcionados y el contexto narrativo definido por el usuario. Una configuración inadecuada puede dar lugar a respuestas no deseadas.  El usuario asume toda la responsabilidad. Al descargar, instalar o utilizar NPC Runtime, el usuario acepta que es el único responsable del contenido que el software genere y de las consecuencias derivadas de su uso, incluyendo, sin limitación, cualquier daño directo o indirecto, pérdida de datos o perjuicio a terceros. El usuario se compromete a utilizar el software de forma ética y legal, y a implementar las salvaguardas necesarias en su aplicación o videojuego para filtrar o moderar el contenido generado si fuera preciso. 

NPC Runtime es una herramienta para desarrolladores. No está diseñado para ser utilizado directamente por usuarios finales sin la supervisión y configuración adecuadas por parte de un profesional.

⚠️ Disclaimer

NPC Runtime is a tool that integrates third-party artificial intelligence language models (such as llama.cpp and GGUF models). The copyright holder is NOT responsible for the content generated by these models or for the use that end users make of the software.

AI can fail. Language models may produce inaccurate, incoherent, offensive, biased, or completely fabricated responses (hallucinations). These responses do not reflect the opinion or intention of the software developer.  Configuration and fine-tuning are critical. The behavior of NPCs depends directly on the selected GGUF model, inference parameters (temperature, top-p, max tokens, etc.), system prompt, provided dialogue examples, and the narrative context defined by the user. Improper configuration may lead to unwanted responses.  The user assumes all responsibility. By downloading, installing, or using NPC Runtime, the user agrees that they are solely responsible for the content generated by the software and for any consequences arising from its use, including, without limitation, any direct or indirect damages, data loss, or harm to third parties. The user commits to using the software ethically and legally, and to implementing any necessary safeguards in their application or game to filter or moderate the generated content if required. 

NPC Runtime is a tool for developers. It is not intended to be used directly by end users without proper supervision and configuration by a professional.