galacean-interaction

Implement onPointerClick interactions on Galacean Engine entities with colliders.

5|2|Updated Feb 5, 2026
One-click install
npx skills add https://github.com/ArimaKana/galacean-skills --skill galacean-interaction
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: galacean-interaction
Source: https://github.com/ArimaKana/galacean-skills/tree/main/skills/galacean-interaction
Command: npx skills add https://github.com/ArimaKana/galacean-skills --skill galacean-interaction

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables rapid creation of object interaction in Galacean Engine by providing a Script-based pattern that responds to onPointerClick events, enabling game objects to react to user input.

Core Features & Use Cases

  • Script-driven click handling: attach a Script to an Entity, implement onPointerClick to trigger gameplay logic.
  • Collider dependency: ensures interactions rely on DynamicCollider or StaticCollider for raycast-based clicks.
  • Real-world use case: player taps a block to select or trigger an action, or to start a sequence when an object is clicked.

Quick Start

Create a Script that extends Script, implement onPointerClick, and attach it to an Entity with a collider to enable click interactions.

Frequently Asked Questions about galacean-interaction

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

FAQPage Schema
How do I handle click interactions in Galacean Engine?

To handle click interactions in Galacean Engine, you create a Script that implements the onPointerClick event and attach it to an Entity. This enables game objects to react to user input by triggering gameplay logic.

Why does my onPointerClick event not trigger when I click an object?

Your onPointerClick event will not trigger if the target Entity lacks a collider component. Galacean Engine requires a DynamicCollider or StaticCollider on the target Entity for raycast-based click detection to function properly.

What is the best way to make a Galacean Engine scene object selectable by clicking?

The best way to make a scene object selectable is by attaching a Script component that implements onPointerClick to handle the selection logic. You must also ensure the target Entity has a collider for raycast detection.

Do I need a collider to use onPointerClick for object interactions?

Yes, you need a collider to use onPointerClick for object interactions. The interaction system relies on DynamicCollider or StaticCollider components to perform raycast-based detection when a player taps an entity.

Can I use Script components to trigger actions when players tap entities?

Yes, you can use Script components to trigger actions when players tap entities. By extending a Script and implementing onPointerClick, you can activate sequences or trigger behavior when an object with a collider is clicked.