Pixi’VN - Ink Language Integration
Pixi’VN gives you the ability to write your own narrative using ink, a scripting language for writing interactive narrative.
The ink + Pixi’VN integration, exploits the inkjs and PixiVNJson libraries, to parse ink code and generate a Json that can be interpreted by Pixi’VN. So Javascript/Typescript and ink share the same storage and canvas, and it is also possible to launch ink labels (or knots) from Javascript/Typescript and vice versa. This allows you to use the best of both languages. You can use ink to write the narration, while using Javascript/Typescript to create minigames or complex animations.
What is ink?
ink is a scripting language for writing interactive narrative. It is used in games like 80 Days, Heaven's Vault, and Sorcery! to create branching stories.
This language is very simple to learn. Go on ink website to learn more about it.
Why use ink integration?
Programming a game narrative in Javascript/Typescript has the advantage of having total development freedom, but the disadvantage is that it slows down the writing of a narrative (it makes you write a lot of code).
Installation
To install the package, run the following command in your project:
npm install @drincs/pixi-vn-inkDevelopment
Use Node.js 20.19.0 or newer to run the tests and use Vite 8. The release build uses tsup@9 and requires Node.js 22.18.0 or newer. Package metadata does not enforce these versions.
npm ci
npm test
npm run buildStart using ink in Pixi’VN
If you have not created a project yet then it is recommended to use the template to start your project with ink.
After installing the package you need to use the importInkText() function to import the ink script into your project.
import { narration } from "@drincs/pixi-vn";
import { importInkText } from '@drincs/pixi-vn-ink'
importInkText([inkText, ...])
narration.callLabel(`start`, {});=== start ===
Hello, world!
-> ENDdeclare module "*.ink" {
const value: string;
export default value;
}API reference
The JSDoc API reference for this library is available at jsdocs.pixi-vn.com/pixi-vn-ink.
Agent Skills
Pixi'VN ships a set of Agent Skills that teach AI coding assistants how to correctly use each part of the engine.
> In LM Studio Bionic, ask the agent to install skills from https://github.com/DRincs-Productions/pixi-vn-ink, or add the skill files in Settings → Skills. To reuse skills installed for Codex or Claude Code, enable Settings → Skills → Use skills found in other apps.
Codex:
npx skills@latest add DRincs-Productions/pixi-vn-ink@latest --skill '*' --agent codex -g -yClaude Code:
npx skills@latest add DRincs-Productions/pixi-vn-ink@latest --skill '*' --agent claude-code -g -yOther agents:
npx skills@latest add DRincs-Productions/pixi-vn-ink@latest --all -yAvailable skills:
getting-started(skillpixi-vn-ink) — the index of the skill set: skill map, installation, the Vite plugin, dev-server debugging, translation files, and core ink syntax as used in Pixi'VNcharacters— dialogue attribution, name substitution, emotionsinput—# request inputpromptspause-continue—# pauseand<># continuemarkup— Markdown/HTML/CSS in dialogue textcanvas— every canvas hashtag commandsound— every sound hashtag commandassets—# load/# lazyloadtext-replacement—[key]substitutionhashtag-commands— writing a custom hashtag command instead of an ink functionmigration— upgrading an existing project to the current version