Pixi’VN

Navigation Quest Time Routine (NQTR)

nqtr on GitHub

cover

What is NQTR? NQTR (Navigation Quest Time Routine) is an extension for Pixi’VN that adds advanced systems for navigation, quests, time management, and game state handling. It is fully customizable and extensible, enabling developers to implement complex game mechanics with ease.

Installation

If you are starting a new Pixi’VN project, it is recommended to use one of the templates that already include NQTR.

To install the NQTR package in an existing JavaScript project, use one of the following commands:

npm install @drincs/nqtr

Development

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 build

Features

NQTR provides the following features (the order is important):

  1. Navigation and map
  2. Time system
  3. Activity
  4. Routine
  5. Quest system

Agent Skills

NQTR ships a set of Agent Skills that teach AI coding assistants how to correctly use each part of the library. When a project uses Pixi’VN with ink, the skills prefer ink (hashtag commands such as # enter room, # wait, # start quest) over TypeScript labels.

> In LM Studio Bionic, ask the agent to install skills from https://github.com/DRincs-Productions/nqtr, 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/nqtr@latest --skill '*' --agent codex -g -y

Claude Code:

npx skills@latest add DRincs-Productions/nqtr@latest --skill '*' --agent claude-code -g -y

Other agents:

npx skills@latest add DRincs-Productions/nqtr@latest --all -y

Available skills:

  • getting-started (skill nqtr) — the index of the skill set: skill map, installation, registries, the Vite plugin, OnRunProps, custom classes
  • ink — every NQTR hashtag command and quest variable for .ink files
  • navigation — rooms, locations, maps and navigator
  • time — timeTracker, time slots, wait
  • activity — player actions linked to rooms
  • routine — character commitments (schedules)
  • quest — quests, stages and state queries

Install them together with the Pixi’VN and Pixi’VN ink skills.

On this page