LogoPixi’VN
NarraciónNarration with JS/TS

Labels y steps

Explica los conceptos fundamentales de labels y steps en Pixi’VN, detallando cómo se estructura y gestiona el flujo narrativo dentro del motor de juego.

Las visual novels son típicamente una secuencia de escenas con imágenes y texto. En Pixi’VN, todo el flujo narrativo se basa en los conceptos de labels y steps.

Un label se utiliza para organizar la narración; funciona como un "marcador" o sección de la historia. Técnicamente, un label es una clase que actúa como contenedor de steps.

Un step es una acción o evento individual que ocurre dentro de un label. Los steps se utilizan para mostrar imágenes, texto y otros elementos narrativos.

Nomenclatura

El término label está tomado de Ren'Py, donde actúa como un "marcador" o "punto de referencia" en la historia. En el lenguaje ink, el término equivalente es knot.El término step es introducido por Pixi’VN para representar las acciones o eventos individuales que ocurren dentro de un label.

El término step es introducido por Pixi’VN para representar las acciones o eventos individuales que ocurren dentro de un label.

Agregar

Para crear un label, utilice la función newLabel.

content/labels/start.label.ts
import { narration, StepLabelProps } from "@drincs/pixi-vn";

export const startLabel = newLabel("start", [
    () => {
        narration.dialogue = { character: liam, text: "Example of dialogue" };
    },
    (props: StepLabelProps, { labelId }) => narration.jump(labelId, props),
]);

Otras funcionalidades

On this page