LogoPixi’VN

Inicio rápido

Empezando con Pixi’VN

Puedes empezar a usar Pixi’VN inicializando un nuevo proyecto o instalando el paquete en un proyecto existente.

Requisitos previos

Antes de comenzar, debes tener instaladas las siguientes herramientas:

Inicialización del proyecto

Si deseas comenzar desde un nuevo proyecto, puedes usar el siguiente comando para inicializar un proyecto con las plantillas de Pixi’VN:

npm create pixi-vn@latest

Puedes ver la lista de plantillas disponibles y demostraciones interactivas aquí.

Después de inicializar el proyecto, abre el directorio con tu editor de texto (se recomienda VSCode) y comienza a desarrollar tu proyecto.

Todas las plantillas incluyen un archivo README.md con más información sobre el proyecto.

Instalación

Para instalar el paquete Pixi’VN en un proyecto JavaScript existente, usa uno de los siguientes comandos:

npm install @drincs/pixi-vn

Inicialización

Antes de usar el motor Pixi’VN, debes inicializar el juego. Puedes hacerlo llamando al método Game.init.

Esta función tiene los siguientes parámetros:

  • element: El elemento HTML donde se agregará el canvas.
  • Equivalente a las opciones que puedes usar al inicializar una aplicación PixiJS. Las siguientes opciones son obligatorias:
    • width: El ancho del canvas.
    • height: La altura del canvas.
  • devtoolsOptions: Equivalente a las opciones utilizadas al inicializar PixiJS Devtools.
src/main.tsx
import { Game } from "@drincs/pixi-vn";

// Canvas setup with PIXI
const body = document.body
if (!body) {
    throw new Error('body element not found')
}

Game.init(body, {
    height: 1080,
    width: 1920,
    backgroundColor: "#303030",
}).then(() => {
    // ...
});

// read more here: https://pixi-vn.web.app/start/other-narrative-features.html#how-manage-the-end-of-the-game
Game.onEnd(async (props) => {
    Game.clear();
    props.navigate("/");
});

Game.onError((type, error, { notify }) => {
    notify("allert_error_occurred");
});
index.html
<!doctype html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Game</title>
  </head>
  <body>
    <div id="root"></div>
    <script type="module" src="/src/main.ts"></script>
  </body>
</html>