Variables

Las variables son el estado del juego de tu mundo. Números, texto, banderas, objetos complejos — cualquier dato que necesite persistir entre turnos. La IA las lee, las actualiza mediante directivas, y tu automatización puede reaccionar a los cambios.

Solo describe la variable en sí, en lenguaje natural

En las Reglas de comportamiento de una variable, solo necesitas escribir en lenguaje sencillo qué es la variable y cuándo debería cambiar. No hace falta mencionar sintaxis como [health: -1]: nuestro motor ya se lo ha enseñado a la IA.

✅ Escribe esto: «Disminuye cuando recibe daño físico, ajustado a la gravedad del daño. Un puñetazo -5 a -10, un tajo -15 a -25. Se recupera lentamente al descansar.»

En el editor, abre la sección Variables. Cada variable tiene un nombre, un tipo, un valor por defecto y Reglas de comportamiento.

El mundo de horror de la página de entradas usa 5 variables: health (number, 0-5), energy (number, 0-8), day count (number, 1-14), game phase (string, "Night" o "Day"), y armed status (boolean). Eso es suficiente para correr un juego de supervivencia completo de 14 noches.

En cada turno, la IA lee los valores actuales, escribe directivas como [health: -1] en su respuesta, y el motor las extrae y actualiza el estado.

Tipos de variables

Number

Rastrea cantidades: salud, oro, afinidad, contador de días, hambre.

Puedes establecer límites min/max y el motor recorta al rango automáticamente.

String

Rastrea estado de texto: ubicación, ánimo, misión actual, hora del día.

Boolean

Rastrea banderas verdadero/falso: tiene una llave, conoció al NPC, disparó un evento.

JSON

Rastrea estructuras complejas: arrays de inventario, objetos de relaciones con NPCs, registros de misiones, datos de mapa.

Las variables JSON soportan actualizaciones por dot-path: puedes modificar un campo anidado sin reescribir el objeto entero.

Reglas de comportamiento — La parte más importante

Las Reglas de comportamiento son instrucciones en lenguaje natural que le enseñan a la IA cuándo y cómo cambiar una variable. Sin ellas, la IA no usará tus variables de forma fiable.

(En el editor este campo se llama Reglas de comportamiento. Aquí lo llamamos Reglas de comportamiento para no confundirlo con el sistema de automatización que el editor llama Comportamientos.)

Buenas Reglas de comportamiento

Variable: Salud:

Esta es la salud del jugador. 0 = muerte — describe una escena de muerte y termina el juego. 1-20 = crítico (sangrando, dificultad para respirar). 20-50 = herido (el dolor afecta las acciones). 50-80 = magullado (molestia menor). 80-100 = sano.

Disminuye con daño físico proporcional a la gravedad. Un puñetazo: -5 a -10. Un tajo de espada: -15 a -25. Una caída desde altura: -20 a -40. Se recupera lentamente al descansar (+5 por escena de descanso) o al curarse (+10 a +30). Nunca cambia más de 30 en un solo turno.

Patrones que funcionan

Rangos numéricos — define qué significa cada rango narrativamente:

0 = fin de juego. 1-25 = desesperado. 26-50 = luchando. 51-75 = capaz. 76-100 = confiado.

Disparadores — cuándo debería cambiar esto:

Aumenta cuando el jugador ayuda a los aldeanos, da regalos o los defiende. Disminuye en robos, amenazas o promesas rotas.

Límites — evita oscilaciones salvajes:

Nunca cambia más de 10 en un turno. Mínimo 0, máximo 100.

TIP

De dos a cuatro frases suele bastar. Si tus Reglas de comportamiento son más largas que un párrafo corto, toca simplificar. La IA es lista: dale el concepto y los límites, no un ensayo de 500 palabras.