Pixi’VN

Live2D

So verwendest du die Live2D-Integration in Pixi’VN, um Modelle zu laden, Bewegungen abzuspielen, Ausdrücke zu wechseln und alles mit den Animationen von Pixi’VN zu kombinieren – ein Stil der Charakteranimation, der in Gal Games beliebt ist.

Die Live2D-Integration befindet sich derzeit in der Testphase, und ihre API kann sich in zukünftigen Versionen ändern.

In deinem Pixi’VN-Projekt kannst du die Live2D-Integration verwenden, um Live2D-Modelle deiner Charaktere darzustellen und zu animieren. Diese Integration ist eine Wrapper-Schicht um untitled-pixi-live2d-engine. Beachte, dass dies kein offizielles PixiJS/Live2D-Plugin ist, sondern eine von der Community gepflegte Engine, die Live2D mit PixiJS verbindet und deren Funktionen direkt in deinem Pixi’VN-Projekt verfügbar macht.

Installation

Um das Live2D-Paket in einem bestehenden JavaScript-Projekt zu installieren, verwende einen der folgenden Befehle:

npm install @drincs/pixi-vn-live2d

extensions.add(Live2DPlugin) muss beim Start in deiner Hauptdatei aufgerufen werden, bevor Game.init aufgerufen wird.

main.ts
import { extensions } from "pixi.js";
import { Live2DPlugin } from "@drincs/pixi-vn-live2d/core";
extensions.add(Live2DPlugin);

Game.init(body, {
    // ...
});

Verwendung

Du kannst die Komponente Live2D wie jede andere Pixi’VN-Komponente verwenden. Anders als bei Spine muss ein Live2D-Modell nicht vorab mit Assets.load geladen werden: Es reicht, seinen Alias mit Assets.add zu registrieren, da Live2D das Modell selbst auflöst und abruft.

Da dieser Abruf asynchron erfolgt, darfst du das Modell erst verwenden, nachdem sein ready-Promise aufgelöst wurde. Warte direkt nach der Erstellung mit await darauf, bevor du vom geladenen Modell abhängige Werte (z. B. seine Größe) ausliest.

Zum Beispiel:

main.ts
import { canvas } from "@drincs/pixi-vn";
import { Live2D } from "@drincs/pixi-vn-live2d";

const live2d = new Live2D({
    source: "shizuku",
    xAlign: 0.5,
    yAlign: 1,
    scale: 0.5,
});
await live2d.ready;
canvas.add("shizuku", live2d);

Auf dieser Seite