사용 방법
- 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
- 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
- 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/drincs-productions/nqtr --skill nqtr-ink시작 전 확인
- 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
- 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.
NQTR in ink
Official docs: pixi-vn.com/nqtr. Ink basics, Vite plugin and the generic hashtag-command mechanism: skill pixi-vn-ink. Entities referenced here (rooms, activities, commitments, quests) must already be defined and registered in TypeScript, see nqtr.
When to use this skill
Use it for any .ink line that changes or reads NQTR state. If the project uses ink, write NQTR interactions here instead of in TypeScript labels.
Setup
import { createNqtrHandler } from "@drincs/nqtr/ink";
createNqtrHandler(); // once, with the other ink initializationcreateNqtrHandler(options?) registers all commands below plus the quest variable getter. Options: timeConverter(time: string) => number (default: "01:30" → 1.5, i.e. replaces : with .), dateConverter(date: string) => number (default Number), wait(delta) (replace the default time/date increase), and activityIds / commitmentIds / questIds / roomIds (readonly id arrays, e.g. the nqtr*Ids generated by vitePluginNqtr, to validate ids). Without id arrays any string is accepted. nqtrHandler() is a deprecated alias.
Commands
In the syntax below <...> is a placeholder, not ink interpolation.
| Command | Effect |
|---|---|
# enter room <roomId> | navigator.currentRoom = room; location and map follow |
# set time <time> | timeTracker.currentTime; accepts 18, 18.30, 18:30 |
# set date <date> | timeTracker.currentDate |
# wait | advance time by timeTracker.defaultTimeSpent |
# wait <time> | advance time by that many hours (rolls over to the next date after dayEndTime) |
# wait days <n> | advance n days, time reset to dayStartTime |
# wait days <n> hours <t> | advance both |
# add activity <activityId> in <roomId> | runtime link (saved with the game) |
# remove activity <activityId> from <roomId> | unlink a runtime-linked activity |
# add routine <commitmentId> in <roomId> | runtime-link a commitment (saved) |
# remove routine <commitmentId> | remove a runtime-linked commitment |
# start quest <questId> | quest.start(props) |
# continue quest <questId> | quest.continue(props), i.e. go to the next stage |
Unknown ids log a warning (Room x not found) and the command is skipped. Commands go on their own line or as a tag on a content line; follow the placement rules from pixi-vn-ink-hashtag-commands.
=== start ===
# enter room mc_room
# set time 08:00
# add activity order_product in mc_room
# start quest aliceQuest
mc: Let's begin.
# wait 2
# wait days 1 hours 8
-> DONEQuest variables
The handler also resolves read-only quest state in ink expressions, where <id> is the quest id:
| Variable | Type |
|---|---|
<id>_started | boolean |
<id>_completed | boolean |
<id>_failed | boolean |
<id>_currentStageIndex | number (0-based; stages.length once completed) |
=== talk_alice ===
{ aliceQuest_currentStageIndex:
- 0: -> talk_alice0
- 1: -> talk_alice1
- else: alice: Thanks for the book.
}
-> DONE
= talk_alice0
alice: Can you order me a book from the PC?
# continue quest aliceQuest
-> DONE+ {aliceQuest_started && not aliceQuest_completed} Ask about the questDo not declare VAR aliceQuest_started in ink; the value comes from NQTR. Failing a quest has no hashtag command: set quest.failed = true in TypeScript (or from a custom hashtag command, see pixi-vn-ink-hashtag-commands).
Not available from ink
Creating/registering entities, timeTracker.initialize, navigator queries beyond enter room, quest.advanceIfCompleted, hiding/disabling entities, timeTracker.isWeekend/currentTimeSlot. Do these in TypeScript, or expose them with a custom hashtag command / external function.
Typical call from the UI into ink
Activities and commitments run onRun(entity, props) in TypeScript; to hand over to ink, jump to the knot: await narration.jump("knot_name", props) (ink knots are Pixi'VN labels). See nqtr-activity.