LogoPixi’VN
NarrationNarration avec JS/TS

Labels et steps

Explique les concepts fondamentaux des labels et des steps dans Pixi’VN, en détaillant comment le flux narratif est structuré et géré au sein du moteur de jeu.

Les visual novels sont généralement une séquence de scènes avec des images et du texte. Dans Pixi’VN, l'ensemble du flux narratif repose sur les concepts de labels et de steps.

Un label est utilisé pour organiser la narration ; il fonctionne comme un « marque-page » ou une section de l'histoire. Techniquement, un label est une classe qui agit comme un conteneur pour les steps.

Un step est une action ou un événement individuel qui se produit au sein d'un label. Les steps sont utilisés pour afficher des images, du texte et d'autres éléments narratifs.

Terminologie

Le terme label est emprunté à Ren'Py, où il agit comme un « marque-page » ou un « repère » dans l'histoire. Dans le langage ink, le terme équivalent est knot.Le terme step est introduit par Pixi’VN pour représenter les actions ou événements individuels qui se produisent au sein d'un label.

Le terme step est introduit par Pixi’VN pour représenter les actions ou événements individuels qui se produisent au sein d'un label.

Ajouter

Pour créer un label, utilisez la fonction 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),
]);

Autres fonctionnalités

On this page