Dale a tus NPCs memoria, relaciones y personalidad.

Tres componentes forman el núcleo del sistema. Añádelos a cualquier GameObject para convertirlo en un NPC con cerebro social.

Cada NPC almacena memorias como entradas etiquetadas. Con el tiempo, las memorias pierden fuerza según la configuración de decaimiento. Las memorias más recientes e impactantes tienen más peso.

Crear una memoria por código

// Añadir memoria a un NPC
NPCMemoryAPI.AddMemory("Guard_A", "PLAYER_HELPED_ME", "Player");

// Comprobar si un NPC recuerda algo
bool remembers = NPCMemoryAPI.GetNPC("Guard_A").MemoryStore.HasMemory("PLAYER_HELPED_ME");

Tags de memoria incluidos en la demo

Las relaciones entre NPCs y el jugador se miden en múltiples ejes independientes. La combinación de estos ejes determina el estado general de la relación.

Ejes predeterminados

Estados de relación

El sistema calcula automáticamente un estado basado en los valores de los ejes:

Consultar relaciones por código

// Estado actual de la relación
string state = NPCMemoryAPI.GetRelationshipState("Guard_A", "Player");

// Valor de un eje concreto
float trust = NPCMemoryAPI.GetRelationshipValue("Guard_A", "Player", "Trust");

// Acceso directo al RelationshipManager
var brain = NPCMemoryAPI.GetNPC("Guard_A");
var rel = brain.RelationshipManager.GetRelationship("Player");
Dictionary<string, float> allAxes = rel.ToDictionary();

Configurar los ejes

Edita el RelationshipConfig ScriptableObject para cambiar nombres de ejes, rangos mínimo/máximo y los umbrales que determinan cada estado.

Agrupa NPCs en facciones. Cuando el jugador realiza una acción contra un NPC, la reputación con toda su facción puede verse afectada.

// Consultar reputación con una facción
float rep = FactionManager.Instance.GetReputation("Player", "Guards");

// Modificar reputación
FactionManager.Instance.ModifyReputation("Player", "Guards", -20f);

Los NPCs comparten memorias entre ellos como rumores. Un NPC que vio al jugador robar puede contárselo a otro, extendiendo la información por la red social.

El componente plug-and-play que conecta el sistema de relaciones con la experiencia de juego. Configura diálogos por estado y acciones del jugador sin escribir código.

UnityEvents del Reactor

Conecta lógica de tu juego directamente desde el Inspector:

Componentes opcionales que añaden feedback visual sin código.

Añade movimiento básico a los NPCs con un sistema de waypoints. Tres modos de patrulla y pausa automática durante interacciones.

Guarda y carga el estado completo de todos los NPCs: memorias, relaciones, reputación de facciones y estados actuales.

// Guardar
NPCSaveSystem.Instance.SaveToFile();

// Cargar
NPCSaveSystem.Instance.LoadFromFile();

// Implementa ISaveProvider
public class CloudSave : ISaveProvider
{
    public string Save(NPCSaveData data) { ... }
    public NPCSaveData Load(string raw) { ... }
}

// Asigna
NPCSaveSystem.Instance.CustomProvider =
    new CloudSave();

Datos guardados

El sistema proporciona tanto eventos estáticos globales como UnityEvents por NPC. Usa la API estática para interactuar desde cualquier script.

Eventos estáticos (NPCEvents)

// Cuando un NPC recibe una nueva memoria
NPCEvents.OnMemoryAdded += (args) => {
    Debug.Log($"{args.NpcId} recordará: {args.Memory.Tag}");
};

// Cuando cambia el estado de una relación
NPCEvents.OnRelationshipStateChanged += (args) => {
    Debug.Log($"{args.NpcId}: {args.OldState} → {args.NewState}");
};

// Cuando un NPC recibe un rumor
NPCEvents.OnRumorReceived += (args) => {
    Debug.Log($"{args.ReceiverId} oyó un rumor sobre {args.Rumor.Tag}");
};

// Cuando cambia la reputación con una facción
NPCEvents.OnFactionReputationChanged += (args) => {
    Debug.Log($"Facción {args.FactionId}: {args.NewValue}");
};

API principal (NPCMemoryAPI)

UnityEvents en el Inspector

NPCBrain y NPCReactor exponen eventos que puedes conectar directamente desde el Inspector sin código:

El paquete incluye ventanas de editor y custom inspectors para trabajar visualmente.

Custom Inspectors

Cada componente de integración tiene su propio inspector personalizado:

Assembly Definitions