El diccionario

El diccionario contiene las propias palabras del jugador. Una entrada de diccionario es un token de texto con nombre que colocas en una línea — su ciudad natal, el nombre de su mascota, cómo llama a su espada — y se lee igual en todos los idiomas, porque lo escribió el jugador.

Qué es, y qué no es

Un token de diccionario es un fragmento de texto con una clave. Escribes [city] en una línea, y el jugador lee “Madrid”, o “Boston”, o lo que sea que haya escrito.

No se traduce. No tiene columna por idioma en la tabla de localización, y nunca la tendrá. Ese es todo el sentido: cuando el jugador escribe “Madrid”, la versión en alemán también debe decir “Madrid”. Sus palabras son sus palabras. Todo lo demás que lee el jugador — diálogo, elecciones, etiquetas de pantalla — pasa por las tablas de localización descritas en Localización. El diccionario es lo único que no.

Crear una entrada

Abre Tools > Beasty VN > Editor, ve a la pestaña Dictionary y pulsa + Add Term.

Campo	Qué es
Key	El nombre del token, escrito sin corchetes: city. Lo usas en el texto como [city].
Default value	Lo que lee el token hasta que algo lo fija. Lo mismo en todos los idiomas.
Player editable	Si está activado, el jugador puede cambiar este término en tiempo de ejecución desde la pantalla de personalización del juego.

Deja Player editable desactivado para un token que fijas tú desde la historia y el jugador nunca toca.

Usarlo en una línea

Escribe la clave entre corchetes, en cualquier parte del texto de un bloque Dialogue:

maya "So you're from [city]? I've never been."

Lo mismo funciona en cualquier texto autorado que resuelva tokens, incluido el nombre mostrado de un personaje.

Fijarlo

Tres formas, según quién decida el valor.

Tú lo decides. Usa el bloque Set dictionary (categoría de paleta State). Elige el token, escribe el valor. En el guion de texto:

dict city = "Madrid"

El jugador lo decide, en la historia. Usa el bloque Ask -> dictionary (categoría de paleta Input). Es una parada autocontenida: muestra una línea de pregunta — con un hablante opcional, como cualquier línea de diálogo — y abre el cuadro de entrada en el mismo momento. Tiene un valor por defecto usado cuando el jugador deja el cuadro en blanco, y un indicador required que rechaza una respuesta en blanco en su lugar.

ask dict city "Where are you from?"

El jugador lo decide, en las opciones. Activa Player editable y el token aparece en la pantalla de personalización del juego, donde puede fijarlo cuando quiera.

Como sea que se fije, el valor se escribe en el almacén de variables compartido bajo la clave del token, donde eclipsa tu valor por defecto. Así que se guarda con la partida, y se rebobina con todo lo demás, y tú no hiciste nada para que eso pasara. Consulta Variables y condiciones.

¿Token de diccionario o variable String?

Viven en el mismo almacén y una condición puede leer cualquiera de los dos. La diferencia es qué quieres decir con ellos, y el editor sigue tu intención: los selectores de diccionario solo te ofrecen entradas de diccionario, y los selectores de variables solo te ofrecen variables.

Usa un token de diccionario cuando el valor es texto que el jugador lee de vuelta, con sus propias palabras, que debe sobrevivir a un cambio de idioma sin traducirse:

• la ciudad de la que viene
• el nombre de su mascota
• el nombre que le dio a su nave

Usa una variable String cuando el valor es estado del juego sobre el que ramificas:

• chapter = "two"
• faction = "rebels" (una variable Enum, con sus valores permitidos listados)
• cualquier cosa sobre la que se filtre una elección, una puerta o una misión

Si te encuentras escribiendo una condición sobre un token de diccionario, probablemente querías una variable. Si te encuentras imprimiendo una variable en una línea y preocupándote de que el traductor la cambie, querías un token de diccionario.

Ver también

• Variables y condiciones — el almacén en el que viven ambos
• Localización — qué se traduce sí, y cómo
• Referencia de bloques — los bloques Set dictionary y Ask
• Sintaxis de .vnbeasty — dict y ask dict en el guion de texto