Reglas y Comportamientos
Disparadores basados en eventos que se ejecutan entre turnos, sin intervención de la IA. Se encargan de cosas que necesitan ser precisas, consistentes o instantáneas.
En el editor, esta es la sección Comportamientos. Distinta de las Reglas de comportamiento en las variables: aquellas le enseñan a la IA cómo responder. Las reglas se ejecutan mecánicamente.
El mundo de horror no usa ninguna regla: corre por completo con entradas y Reglas de comportamiento. Eso está bien. La mayoría de mundos no las usan. Pero si quisieras garantizar una pantalla de "Game Over" exactamente cuando la salud toca 0 (en lugar de confiar en que la IA se dé cuenta), para eso son las reglas.
Cuándo usar automatización
Usa automatización para:
- Alertas de umbral: "Mostrar una advertencia cuando la salud baje de 10"
- Transiciones de fase de juego: "Cuando la afinidad llegue a 75, cambiar a modo romántico"
- Eventos temporizados: "Cada 5 turnos, avanzar el ciclo del día"
- Audio automático: "Reproducir música de combate cuando esté en la arena"
No uses automatización para:
- Cualquier cosa que la IA maneje bien a través de Reglas de comportamiento (la mayoría de lo narrativo)
- Lógica de ramificación compleja (para eso están las entradas + palabras clave)
- Generación de contenido (la automatización dispara acciones, no escribe narrativa)
Muchos mundos excelentes usan cero reglas. Si tu IA está haciendo un buen trabajo a través de entradas bien escritas y Reglas de comportamiento, puede que no necesites ninguna.
Cómo funciona la automatización
Cada regla de automatización tiene tres partes:
CUÁNDO — El disparador
Qué evento ejecuta esta regla:
| Disparador | Se ejecuta cuando |
|---|---|
| Variable crossed | Una variable sube por encima o baja por debajo de un umbral |
| State changed | Cualquier variable cambia de valor |
| Turn complete | Cada N turnos (p. ej., cada 5 turnos) |
| Session start | La primera vez que un jugador inicia tu mundo |
| Player keyword | El jugador menciona una palabra específica |
| AI keyword | La respuesta de la IA contiene una palabra específica |
| Every turn | Después de cada turno |
| Action | Un botón de UI personalizada llama a api.executeAction(actionId) |
| Manual | La regla no tiene disparador basado en eventos: se ejecuta siempre que sus condiciones se cumplan durante un pase de evaluación normal |
SI — Las condiciones (opcional)
Verificaciones adicionales que deben ser verdaderas para que la regla se ejecute:
- Variable igual / no igual / mayor que / menor que un valor
- Múltiples condiciones con lógica AND u OR
ENTONCES — Las acciones
Qué pasa cuando se ejecuta la regla:
| Acción | Qué hace |
|---|---|
| Modify variable | Cambia el valor de una variable (set, add, subtract, etc.) |
| Inject directive | Añade instrucciones al prompt de la IA para turnos futuros |
| Remove directive | Elimina una directiva inyectada previamente por id |
| Send context | Inyecta un mensaje único de sistema/usuario en el siguiente turno de la IA (invisible al jugador) |
| Notify player | Muestra una notificación toast |
| Play audio | Dispara un efecto de sonido o cambio de música |
| Toggle entry | Activa/desactiva una entrada del Lorebook |
| Toggle rule | Activa/desactiva otra regla |
Ejemplo real: Sistema de rutas de dating sim
El mundo "Sakura Season" usa 9 reglas de automatización para crear un sistema de progresión romántica:
A afinidad 25 — Una notificación sutil: "Parece haberse fijado en ti..."
A afinidad 50 — Un toast de logro + la IA recibe una nueva directiva: "Ella está empezando a mostrar sentimientos: describe comportamiento contradictorio, queriendo acercarse pero apartándose."
A afinidad 75 — El disparador del clímax: la IA recibe una directiva para escribir una escena de confesión, y la fase de la historia cambia a "clímax".
Cada heroína tiene esta misma estructura de 3 niveles. La IA maneja toda la narrativa de forma natural: la automatización solo asegura que los hitos de ritmo caigan en los momentos correctos.
Opciones de regla
- Priority: Las reglas de mayor prioridad se ejecutan primero (útil cuando varias reglas se disparan simultáneamente)
- Cooldown: Turnos mínimos entre ejecuciones (evita el spam)
- Max fire count: Veces totales que esta regla puede ejecutarse (1 = evento de una sola vez)
- Enabled/disabled: Las reglas pueden ser activadas por otras reglas (reacciones en cadena)
Consejos
- Empieza sin reglas. Construye tu mundo solo con entradas y Reglas de comportamiento primero. Solo añade reglas cuando notes que la IA es inconsistente con algo.
- Inyecta directivas para el ritmo. La acción más potente es "inject directive": cambia lo que se le dice a la IA que haga, lo que cambia la dirección narrativa entera.
- Usa las notificaciones con moderación. Una notificación toast cada turno es molesta. Guárdalas para hitos significativos.
- Prueba los umbrales con cuidado. Si tu automatización se ejecuta cuando health < 10, asegúrate de que tus Reglas de comportamiento realmente permitan que la salud alcance ese rango.