triggers

Define and validate Trigger objects with declarative conditions and effects in the Voyage engine.

14|7|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/nikolaj-lat/World-Puppeteer --skill triggers-nikolaj-lat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: triggers
Source: https://github.com/nikolaj-lat/World-Puppeteer/tree/main/.claude/skills/triggers
Command: npx skills add https://github.com/nikolaj-lat/World-Puppeteer --skill triggers-nikolaj-lat

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Triggers are the core mechanism to coordinate dramatic events and branching narratives in Voyage worlds; this Skill provides a structured approach to author, validate, and orchestrate AI-driven triggers that respond to story, actions, and game state.

Core Features & Use Cases

  • Declarative trigger definitions: specify name, conditions, and effects that fire when all conditions pass.
  • Phase-aware execution: supports planning and state phases, ensuring predictable storytelling while preserving gameplay flow.
  • Scripted overrides and validations: optional script field for advanced logic, with safety checks and automatic storage mutations.
  • Use Case: author a quest beat that reveals a secret when a player enters a location and uses a story effect to advance the narrative.

Quick Start

Create a trigger named 'night_visit' with a dusk-condition and a story effect that reveals the encounter.

Frequently Asked Questions about triggers

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I define in-game triggers for branching narratives in Voyage?

In-game triggers in the Voyage engine are defined declaratively by specifying a name, conditions, and effects that fire when all conditions pass to coordinate dramatic events and branching narratives.

What is phase-aware execution for game triggers?

Phase-aware execution supports planning and state phases for game triggers, ensuring predictable storytelling while preserving gameplay flow across automatic storage mutations.

Can I use custom scripting to override trigger conditions in a game engine?

Custom scripting overrides trigger conditions via an optional script field, enabling advanced logic with safety checks and automatic storage mutations in the Voyage engine.

How do I validate trigger schemas and prevent malformed game triggers?

Trigger schemas are validated and malformed triggers are prevented via strict validation rules, safety checks, and automatic size limits enforced by the trigger system.

What's the best way to automate quest beats that reveal secrets based on location?

Quest beats that reveal secrets are automated by authoring a trigger with location-entry conditions and story effects that advance the narrative when the player enters the target location.

Are there size limits or constraints when authoring declarative trigger definitions?

Declarative trigger definitions are constrained by strict size limits and schema enforcement to guard against malformed triggers and ensure safe execution within the Voyage engine.