Claves de variables — Beasty Visual Novel

Cada clave que vive en el almacén de variables, y cómo escribir una condición contra ella. Esta es la página para abrir cuando necesitas una condición sobre el tiempo del juego, el estado de una misión, la ubicación de un personaje o el inventario del jugador.

Un almacén para todo

Hay un único almacén clave/valor plano. Tus variables, las variables de personaje, el reloj, el progreso de las misiones, el inventario y el diccionario viven todos ahí, bajo distintos namespaces de clave. Por eso cualquiera de ellos puede usarse en cualquier condición, por eso todos se guardan, y por eso todos se rebobinan correctamente.

Qué	Formato de clave	Clave de ejemplo
Tus variables	`key` (sin prefijo)	`gold`
Variables de personaje	`@char:<id>:<field>`	`@char:maya:affection`
Nombre de personaje (reservado)	`@char:<id>:@name`	`@char:maya:@name`
Rutina (reservado)	`@char:<id>:@routineLocation`, `@char:<id>:@routineSpot`, `@char:<id>:@routineMode`	`@char:maya:@routineLocation`
Tiempo de juego	`@time:daypart`, `@time:hour`, `@time:day`, `@time:weekday`, `@time:season`	`@time:daypart`
Misiones	`@quest:<id>:@state`, `@quest:<id>:@stage`, `@quest:<id>:@period`, `@quest:<id>:@rewarded`, `@quest:<id>:@penalized`, `@quest:<id>:@lastResult`, `@quest:<id>:<objectiveId>`	`@quest:ana_m1:@state`
Inventario	`item.<id>`, `inventory.order`	`item.potion`
Diccionario	la clave del token (sin prefijo)	`city`

Los campos reservados se escriben con un @ inicial. Una clave definida por el autor nunca puede producir uno, así que tus variables nunca pueden colisionar con las del motor.

Nota Una clave que nunca se escribió se lee como un valor vacío. Una condición contra ella es false a menos que la compares con un valor vacío.

Cómo escribes una condición

En el editor nunca escribes una clave. Cada campo de condición tiene un selector con búsqueda que lista las claves e inserta la correcta. El selector muestra una etiqueta amigable, pero lo que se guarda siempre es la clave exacta de la tabla de arriba.

Namespace	Etiqueta en el selector
Tus variables	La clave misma: `gold`
Variables de personaje	`<id>.<field>`: `maya.affection`
Rutina	`<id>.<field>`, conservando el `@` reservado: `maya.@routineLocation`
Tiempo de juego	`time.<field>`: `time.daypart`
Misiones	`quest.<id>:<field>`: `quest.ana_m1:@state`
Inventario	La clave misma: `item.potion`

En el script de texto .vnbeasty no hay selector, así que escribes la clave tú mismo, exactamente como aparece en la columna de clave: if @time:daypart == Morning, no if time.daypart == Morning. Ver la sintaxis de .vnbeasty.

Operadores

Equals, NotEquals, Greater, Less, GreaterOrEqual, LessOrEqual, Contains. En el script de texto: ==, !=, >, <, >=, <=, contains.

Las cláusulas se combinan con And u Or.

Advertencia AND liga más fuerte que OR. a AND b OR c significa (a AND b) OR c, nunca a AND (b OR c). No hay paréntesis. Reordena tus cláusulas, o divide la rama en dos.

Dos reglas que atrapan a todos alguna vez:

Una condición vacía siempre es true. Ninguna condición significa “siempre”.
Una cláusula sin clave seleccionada está incompleta y evalúa a false. Se reporta en la consola una vez.

El panorama completo está en Variables y condiciones.

Tus propias variables

Declaradas en la pestaña Variables de la ventana Beasty VN. La clave no tiene prefijo y es exactamente lo que escribiste.

gold >= 10
saw_intro == true
player_class == Mage

Una bandera desnuda en el script de texto significa == true:

choice "Buy a sword" if gold >= 10 { gold -= 10 } -> smith
if saw_intro -> chapter2

Los valores están tipados: String, Int, Float, Bool. Una variable Enum ofrece sus valores permitidos como un desplegable en el editor de condiciones en vez de texto libre.

Variables de personaje

Cada campo en un personaje - los universales del CharacterVariableSchema y los propios del personaje - se almacena bajo @char:<id>:<field>.

Clave	Significado
`@char:<id>:<field>`	Un campo en un personaje.
`@char:<id>:@name`	Reservado. El nombre mostrado del personaje, una vez que se ha cambiado o el jugador lo ha nombrado.
`@char:@self:<field>`	Un marcador de posición usado en una condición compartida. Se resuelve al personaje para el que se esté evaluando la condición.

Ejemplos de condiciones:

maya.affection >= 3          etiqueta del selector
@char:maya:affection >= 3    la clave real
@char:@self:met == true      una condición compartida, evaluada por personaje

Usa @self cuando una plantilla de condición tiene que aplicarse a todo el elenco, por ejemplo la regla de visibilidad de la lista de elenco dentro del juego.

Ver Personajes.

Claves de rutina

Tres campos reservados por personaje, escritos por el sistema de rutinas en cada entrada a una sala y cada vez que el almacén cambia. Nunca escribes @routineLocation ni @routineSpot tú mismo.

Clave	Valor	Etiqueta en el selector
`@char:<id>:@routineLocation`	El id de la sala en la que está el personaje ahora mismo, o vacío cuando está ausente.	`<id>.@routineLocation`
`@char:<id>:@routineSpot`	El id del spot dentro de esa sala, o vacío.	`<id>.@routineSpot`
`@char:<id>:@routineMode`	El nombre del perfil de rutina activo.	`<id>.@routineMode`

@routineLocation y @routineMode se ofrecen como desplegables: la lista de salas y la lista de perfiles de ese personaje.

Ejemplos de condiciones:

@char:maya:@routineLocation == bakery     Maya está en la panadería
@char:maya:@routineLocation ==            Maya está ausente (vacío = no está en el mapa)
@char:maya:@routineMode == Working        Maya está en su horario Working

@routineMode es la única clave de rutina que SÍ escribes. Establecerla con un bloque Set variable (o el bloque Routine override) cambia todo el horario de un personaje desde la historia.

Ver Rutinas de personaje.

Claves de tiempo

Cinco claves reservadas. Existen solo mientras haya un Time Config asignado en el BeastyManager.

Clave	Etiqueta en el selector	Disponibilidad	Valor
`@time:daypart`	`time.daypart`	Siempre	El nombre del daypart actual, p. ej. `Morning`.
`@time:hour`	`time.hour`	Solo en modo Clock	Un entero, p. ej. `14`.
`@time:day`	`time.day`	Siempre	Un entero, empezando en 1.
`@time:weekday`	`time.weekday`	Cuando hay weekdays configurados	El nombre del weekday.
`@time:season`	`time.season`	Cuando hay seasons configuradas	El nombre de la season.

@time:daypart se ofrece como un desplegable de los nombres de daypart que configuraste.

Ejemplos de condiciones:

@time:daypart == Morning
@time:hour >= 18
@time:day > 3
@time:weekday == Monday
@time:season == Summer

Advertencia Sin ningún Time Config asignado, el sistema de tiempo está apagado: ninguna de estas claves se escribe jamás, y toda condición sobre ellas es false. Esta es la causa más común de “mis condiciones de tiempo no hacen nada”.

El tiempo nunca avanza por sí solo. Lo mueves con el bloque Advance time, con el advanceTimeOnClick de un objeto de free roam, o desde código. Ver Tiempo de juego.

Claves de misión

Seis campos reservados por misión, más una clave por objetivo. Todos escritos por el sistema de misiones.

Clave	Valor
`@quest:<id>:@state`	`notstarted`, `active`, `completed` o `failed`.
`@quest:<id>:@stage`	El índice de objetivo actual en una misión `Ordered`.
`@quest:<id>:<objectiveId>`	`true` una vez que ese objetivo está hecho.
`@quest:<id>:@period`	El índice de período que rastrea una misión recurrente.
`@quest:<id>:@rewarded`	Latch: la recompensa se pagó para el período actual.
`@quest:<id>:@penalized`	Latch: la penalización se aplicó para el fallo actual.
`@quest:<id>:@lastResult`	`completed` o `failed`, para el último período resuelto de una misión recurrente.

@state y @lastResult se ofrecen como desplegables de sus valores permitidos. @stage solo aparece para misiones Ordered; @lastResult solo para las recurrentes.

Ejemplos de condiciones:

@quest:ana_m1:@state == active           la misión está en curso
@quest:ana_m1:@state == completed        está terminada
@quest:ana_m1:@stage >= 2                el jugador llegó al tercer objetivo
@quest:ana_m1:talk_to_ana == true        ese objetivo en particular está hecho
@quest:ana_m1:@lastResult == failed      fallaron la diaria de ayer

Compara un estado de misión contra el string, no contra un número. Los cuatro estados son en minúsculas.

Ver Misiones.

Claves de inventario

Clave	Valor
`item.<id>`	Cuántos de ese objeto tiene el jugador. Un objeto `Key` se lee como bool, un `Consumable` como int.
`inventory.order`	El orden de ranuras elegido por el jugador. No condiciones sobre esto.

Ejemplos de condiciones:

item.potion >= 1        el jugador tiene al menos una poción
item.rusty_key == true  un objeto Key que posee
item.potion == 0        se quedó sin pociones

Give y Take limitan al maxQuantity del objeto y a 0, así que un conteo de objeto nunca es negativo ni supera el tope.

Ver Objetos e inventario.

Claves de diccionario

Un token del diccionario se almacena bajo su propia clave, sin prefijo, exactamente igual que una de tus variables. Cuando un bloque Set dictionary o el jugador escribe un valor, va al almacén y eclipsa el valor por defecto del autor - así que se guarda y rebobina como todo lo demás.

city == Madrid

Como un token de diccionario comparte el namespace plano con tus variables, dale a los tokens nombres distintos. Tools > Beasty VN > Validate > Find duplicate ids no detectará un token que eclipsa a una variable.

Ver El diccionario.

Ver también

Variables y condiciones - alcances, efectos, el editor de condiciones
La sintaxis de .vnbeasty - escribir condiciones como texto
Accesores generados - VNVars y VNChars, claves tipadas para C#
APIs de gameplay - leer tiempo, rutinas, misiones e inventario en código
Assets