portals-building-guide

Reference guide for building Portals spaces with triggers, NPCs, and quests.

5|1|Updated May 19, 2025
One-click install
npx skills add https://github.com/busportals/Portals-Building-Guide --skill portals-building-guide
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: portals-building-guide
Source: https://github.com/busportals/Portals-Building-Guide/tree/main/skills/portals-building-guide
Command: npx skills add https://github.com/busportals/Portals-Building-Guide --skill portals-building-guide

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a complete, centralized reference and workflow guide for building interactive Portals spaces, reducing the time spent searching through disparate docs.

Core Features & Use Cases

  • Comprehensive reference: covers Building Basics, Interactive Studio, Function Effects, triggers, NPCs, quests, token trading, and iframes.
  • Practical recipes: step-by-step examples and patterns to implement common game mechanics.
  • Debugging & testing guidance: structured debugging workflows and best practices.

Quick Start

Start by reviewing the Building Basics section to learn how to create a Space, enter Build Mode, and place items. Then follow a sample workflow to set up a simple space with a trigger and a basic NPC.

Frequently Asked Questions about portals-building-guide

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

FAQPage Schema
How do I build interactive Portals spaces with triggers and NPCs?

Building interactive Portals spaces involves using the Interactive Studio to place items, configure triggers for event activation, and script NPCs to handle quests. You start by entering Build Mode to establish the foundational space layout and object placement.

What are function effects in Portals game development?

Function effects in Portals game development are mechanisms that execute specific behaviors when triggered. They are configured using function expressions to define dynamic interactions, allowing developers to implement complex game mechanics and token trading systems within their spaces.

How do I set up token trading and quests in a Portals space?

Setting up token trading and quests in a Portals space requires configuring NPCs with specific trigger interactions. You use the Portals building guide to implement practical recipes that link quest progression steps to token economy transactions through function effects.

Can I use iframe integrations to embed external content in Portals?

Yes, you can use iframe integrations to embed external content and applications directly within Portals spaces. This allows you to extend the native functionality by connecting external web resources to your interactive studio environment and trigger systems.

What is the best way to structure a Portals space creation workflow?

The best way to structure Portals space creation is to follow a sequential workflow: establish Building Basics first, then implement triggers and effects, add NPCs for quests, and finally integrate advanced features like token trading and iframes for complete game development.

Why are my Portals triggers not working during space testing?

Portals triggers not working usually indicates an issue with function expression syntax or incorrect YAML frontmatter configuration. You should follow structured debugging workflows to isolate interaction logic errors and verify that trigger conditions match the expected NPC behaviors.