Referencia de assets

Cada ScriptableObject que creas con Beasty Visual Novel, su ruta exacta en el menú Create y sus campos principales. Usa esta página como consulta. Los conceptos detrás de estos assets se explican en Conceptos fundamentales.

Cuántos de cada uno

La mayoría de los assets son por historia o por personaje. Unos pocos son singletons para todo el juego.

Asset	Cuántos
VNSettings	Exactamente uno, en una carpeta Resources. Creado para ti.
VNContext	Exactamente uno para todo el juego. Cada historia lo comparte.
LocalizationTable	Uno para la historia (en el context) más una tabla global de UI (en VN Settings).
CharacterVariableSchema	Uno, referenciado por el context.
QuestCatalog	Uno, referenciado por el context.
VNMusicConfig	Uno, referenciado por el context.
VNTimeConfig	Uno, arrastrado al BeastyManager. Opcional.
FreeRoamMapGraph	Uno por escenario. La mayoría de los juegos tiene uno.
DialogueScene	Uno por historia o capítulo. Muchos.
StoryGraph	Un grafo raíz por escena, más uno por subgrafo. Muchos.
CharacterDefinition	Uno por personaje. Muchos.

El VNContext es el que hay que cuidar. Es el mundo compartido, resuelto en tiempo de ejecución a través de VNSettings.gameContext. Tools > Beasty VN > Content > Create Base Assets (intro + FreeRoam map) nunca lo duplica.

Tabla de consulta

Asset	Menú Create	Qué es
DialogueScene	Create > Beasty VN > Visual Novel (Dialogue Scene)	El asset raíz de una historia.
VNContext	Create > Beasty VN > Story > VN Context	El mundo compartido: elenco, variables, objetos, misiones.
StoryGraph	Create > Beasty VN > Story > Story Graph	Un lienzo de nodos.
VNSettings	Create > Beasty VN > Config > VN Settings	Configuración de todo el proyecto.
VNMusicConfig	Create > Beasty VN > Config > Music Config	La cola de música para cada modo de la aplicación.
VNTimeConfig	Create > Beasty VN > Config > Time Config	Dayparts, horas, weekdays, seasons.
CharacterDefinition	Create > Beasty VN > Characters > Character Definition	Un personaje.
CharacterVariableSchema	Create > Beasty VN > Characters > Character Variable Schema	Los campos que tiene cada personaje.
LocalizationTable	Create > Beasty VN > Localization > Localization Table	Clave por idioma.
FreeRoamMapGraph	Create > Beasty VN > FreeRoam > FreeRoam Map Graph	Salas más rutinas de personaje.
QuestCatalog	Create > Beasty VN > Quests > Quest Catalog	Las misiones del proyecto.
Los siete tipos de nodo	Create > Beasty VN > Advanced > Nodes > ...	Normalmente creados por el grafo, no a mano.

Casi nunca necesitas este menú. Tools > Beasty VN > Setup > Blank Canvas crea el DialogueScene, el VNContext, el LocalizationTable, un StoryGraph raíz y un primer nodo Dialogue en un solo paso. Ver Menús.

DialogueScene

El asset raíz de una historia. Se muestra en el editor como el campo “Visual Novel”.

Campo	Significado
context	El VNContext compartido. Vacío recurre al context global de VN Settings.
rootGraph	El StoryGraph desde el que arranca la reproducción.
musicOverride	Una cola de música que reemplaza la cola Visual Novel del context para esta historia.
scriptFile	El TextAsset .vnbeasty con el que esta escena se sincroniza.

Ver El grafo de la historia y El script de texto.

VNContext

El único mundo compartido. El elenco, las variables, el diccionario, los objetos, las misiones, las pantallas y la localización viven todos aquí, no en las historias individuales, así que varias DialogueScenes pueden compartirlos.

Campo	Significado
characters	El elenco: una lista de CharacterDefinition.
variables	Tus definiciones de variables (en línea, ver abajo).
characterSchema	El CharacterVariableSchema que hereda cada personaje.
musicConfig	El VNMusicConfig.
dictionary	Entradas del diccionario (en línea).
localization	La LocalizationTable de la historia.
languages	Los códigos de idioma que este juego incluye. El índice 0 es el idioma origen.
screens	Definiciones de pantallas de HUD y overlay.
items	Definiciones de objetos (en línea).
questCatalog	El QuestCatalog.

StoryGraph

Un lienzo de nodos: un grafo por escena, más uno por subgrafo.

Campo	Significado
nodes	Los nodos en el lienzo.
entryNodeId	Dónde arranca la reproducción.
exitOutcomes	Las claves de resultado que este grafo puede devolver cuando se usa como subgrafo.

Ver Subgrafos.

VNSettings

Configuración de todo el proyecto: el context global, la tabla de localización de UI, el idioma por defecto, el autoguardado, las ranuras de guardado, la profundidad de rollback, y las carpetas usadas para resolver nombres de asset en el script de texto. Vive en una carpeta Resources y se lee en tiempo de ejecución.

Ábrelo con Tools > Beasty VN > Settings > Global Settings o Edit > Project Settings > Beasty VN. Cada campo está documentado en VN Settings.

VNMusicConfig

La cola de música para cada modo de la aplicación: mainMenu, visualNovel, freeRoam y custom. Cada cola tiene clips, un mode, un volume y un crossfadeSeconds.

Ver Audio y música.

VNTimeConfig

Tiempo del juego. Arrástralo al campo Time Config del BeastyManager.

Advertencia Deja ese campo vacío y el sistema de tiempo queda apagado. No se escribe ninguna variable de tiempo y toda condición de tiempo evalúa a false.

Campo	Significado
mode	SlotsOnly (dayparts con nombre, sin hora) o Clock (un contador de horas).
dayparts	Las bandas con nombre. Cada una tiene un name y, en modo Clock, un startHour.
hoursPerDay	Solo en modo Clock.
weekdays	Nombres de weekday opcionales. Déjalo vacío para desactivar.
seasons, daysPerSeason	Opcional.
startDay, startDaypartIndex, startHour	El momento inicial de una partida nueva.

Ver Tiempo de juego.

CharacterDefinition

Un personaje: su nombre, su aspecto en el escenario y en la UI, sus estadísticas, y su menú de conversación.

Campo	Significado
id	El id estable usado en condiciones, scripts y código.
displayName, nameColor, textColor	Cómo se dibujan el nombre y la línea.
allowPlayerRename	Deja que el jugador ponga el nombre de este personaje.
category	Main o Secondary.
tags, aliases	Etiquetas libres; nombres de display alternativos que una línea puede usar.
expressions	Los sprites de escenario. La clave por defecto es base.
portraits	Los íconos de UI.
deliveryStyles	Fuente, color y efecto de texto por estado de entrega.
variables	Los campos propios de este personaje, sobre el esquema.
talkMenu	Las entradas del centro de conversación.
freeRoamSprite	El sprite usado en una sala.
listed, listVisibleWhen	Si el personaje aparece en la lista de elenco del juego.
showCurrentLocation, showRoutine	Qué revela la pantalla de perfil.

Ver Personajes y El menú de conversación.

CharacterVariableSchema

Los campos que tiene TODO personaje. Una lista fields de CharacterVariableField (ver abajo). Un personaje puede sobrescribir el valor por defecto y la visibilidad de un campo del esquema sin cambiar el esquema.

Ver Personajes.

LocalizationTable

Una grilla de claves por idioma.

Campo	Significado
languages	Códigos de idioma. El índice 0 es el idioma origen.
entries	Una fila por clave, con una celda por idioma y su estado de traducción.

Hay dos tablas: la tabla de la historia en el VNContext, y la tabla global de UI en VN Settings. Ver Localización.

FreeRoamMapGraph

Las salas por las que camina el jugador, y las rutinas que deciden quién está parado en ellas.

Campo	Significado
entryRoomId	La sala en la que empieza una partida nueva.
rooms	Los nodos de sala: fondo, fondos condicionales, prefab de sala, botones.
routines	Un CharacterRoutine por personaje.

Asigna el grafo al componente FreeRoamScenario en el Stage. Ver Salas de free roam y Rutinas de personaje.

QuestCatalog

Las misiones del proyecto, en una lista quests. Cada misión tiene un id, un título, un dueño, una categoría, un modo de orden, una recurrencia, condiciones de inicio y fallo, efectos de recompensa y penalización, y sus objetivos.

Ver Misiones.

Los siete tipos de nodo

Todo tipo de nodo tiene una entrada Create bajo Create > Beasty VN > Advanced > Nodes >:

Dialogue Node, Choice Node, Decision Node, Flow Node, SubGraph Node, Return Node, Talk Menu Node.

Normalmente nunca los usas. Hacer clic derecho en el lienzo del grafo crea el nodo, lo nombra, lo añade al grafo y lo archiva como sub-asset por ti. Las entradas Advanced existen para el caso raro en que necesites un asset de nodo fuera de un grafo. Ver El grafo de la historia.

Datos en línea: lo que NO es un asset

Cuatro tipos de datos viven dentro del VNContext en vez de ser assets separados. Los editas en la ventana Beasty VN, no en la ventana Project, y nunca creas un archivo para ellos.

Definiciones de variables

Editadas en la pestaña Variables. Una VariableDefinition por variable.

Campo	Significado
key	La clave en el almacén. Sin prefijo.
kind	PlayerInput, Fixed, Enum o Computed.
valueType	String, Int, Float o Bool.
defaultValue	El valor al inicio de una partida nueva.
promptAtRuntime	Preguntarle al jugador por ella cuando empieza el juego.
allowedValues	El dominio de una variable Enum.

Ver Variables y condiciones y Claves de variables.

Entradas de diccionario

Editadas en la pestaña Dictionary. Una DictionaryEntry por token: key, defaultValue, playerEditable.

Ver El diccionario.

Definiciones de objetos

Editadas en la pestaña Items.

Campo	Significado
id	El id del objeto. También la clave de inventario item.<id>.
icon	El sprite de inventario.
kind	Key o Consumable.
maxQuantity	El tope. Give y Take limitan a él y a 0.
nameKey, descriptionKey	Claves de localización.
onUse	useCondition, cannotUseMessageKey, effects, jumpToScene, jumpToNodeId, consumeAmount.

Ver Objetos e inventario.

Campos de variable de personaje

Un CharacterVariableField aparece ya sea en el CharacterVariableSchema (todo personaje lo tiene) o en una CharacterDefinition (solo ese personaje lo tiene).

Campo	Significado
key	El nombre del campo. La clave en el almacén es @char:<id>:<key>.
type	String, Int, Float o Bool.
defaultValue	El valor inicial.
showOnStats	Mostrarlo en la pantalla de estadísticas del personaje.
editable	Dejar que el jugador lo cambie ahí.
clamp, min, max, step	Límites opcionales.

Ver también

• Menús
• Claves de variables
• Prefabs
• Conceptos fundamentales
• Validación e ids