> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/creator/content-creator-ko/scene-editor/interactivity/trigger-area.md).

# 트리거 영역

플레이어의 위치에 반응

플레이어가 어떤 영역 안으로 들어가거나 밖으로 나갈 때 무언가가 일어나게 하려면 Trigger Area를 사용하세요 [스마트 아이템](/creator/content-creator-ko/scene-editor/interactivity/smart-items.md).

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-649dfd99d06849f543399b5b89a6a31a015cb439%2Ftrigger.png?alt=media\&token=cbc5fb9b-ecff-4733-b799-38b59244f78b)

씬을 편집하는 동안 보이는 주황색 큐브는 Scene Editor에서만 보이며, 씬 미리보기를 실행하면 보이지 않게 됩니다. 주황색 큐브의 크기와 스케일을 쉽게 조정해 필요한 영역을 정확히 덮을 수 있습니다.

씬으로 드래그한 다음 스케일 기즈모로 크기를 조절하세요. 보이는 상자나 구는 편집기에서만 그려지며, 플레이어에게는 보이지 않습니다.

플레이어 아바타의 어느 부분이든 이 주황색 큐브와 겹치면 지정된 이벤트가 호출됩니다. Trigger Area는 다른 플레이어의 아바타가 아니라 로컬 머신의 플레이어에게만 반응합니다. 각 플레이어는 자신의 씬 인스턴스에서 트리거를 실행합니다.

{% hint style="info" %}
**💡 팁**: 씬의 트리거 영역이 다른 콘텐츠를 편집하는 데 방해가 되기 시작하면, 언제든지 잠그거나/또는 다음에서 숨길 수 있다는 점을 기억하세요 [엔티티 트리](/creator/content-creator-ko/scene-editor/get-started/scene-editor-essentials.md#the-entity-tree).

<img src="https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-22638c584105c16e473cdbcab644d55b04540fc4%2Fhide-trigger.png?alt=media" alt="" data-size="original">
{% endhint %}

여러 Trigger Area는 서로 겹칠 수 있으며, 서로에게 영향을 주지 않습니다.

어떤 일이 일어나야 하는지 설명하면 [AI Assistant](/creator/content-creator-ko/scene-editor/extend-with-code/ai-assistant.md) 그에 대한 작은 스크립트를 작성해 줍니다.

### 설정

항목의 **스크립트** 컴포넌트에는 두 개의 필드가 있습니다:

| 필드         | 기능                  | 옵션                                                                          | 기본값      |
| ---------- | ------------------- | --------------------------------------------------------------------------- | -------- |
| **활성화 대상** | 영역을 작동시키는 것.        | `내 플레이어`, `모든 플레이어`, `모든 콜라이더`, `클릭 가능`, `사용자 지정 1`, `사용자 지정 2`, `사용자 지정 3` | `내 플레이어` |
| **모양**     | 볼륨이 상자 형태인지 공 형태인지. | `박스`, `구`                                                                   | `박스`     |

`내 플레이어` 씬을 실행 중인 플레이어의 아바타에만 반응합니다. `모든 플레이어` 씬의 다른 사람들을 포함한 모든 아바타에 반응합니다. 나머지 옵션은 다른 [충돌 레이어](/creator/content-creator-ko/sdk7/3d/colliders.md)에 해당하므로, 이 영역이 물리 객체, 클릭 가능한 객체 또는 사용자 지정 레이어에 반응하도록 할 수 있습니다.

전환 **모양** 편집기 자리표시자를 상자와 구 사이에서 전환하므로, 편집 중에 보이는 것이 그대로 적용됩니다.

### 무엇이 일어나야 하는지 설명하세요

영역은 두 개의 이벤트를 발생시킵니다: **진입** 과 **종료**. 에서 **반응** Script 컴포넌트의 섹션에는 각각에 대한 버튼이 있습니다:

* **플레이어가 들어오면…**
* **플레이어가 나가면…**

하나를 클릭하면 Creator Hub가 AI Assistant의 메시지 상자에 항목 이름을 넣은 문장의 앞부분을 작성합니다. 예를 들어 `플레이어가 "Trigger Area"에 들어오면,` 프롬프트는 엔티티 트리에서 보이는 항목의 이름을 사용합니다. 일어나길 원하는 내용을 넣어 문장을 완성한 뒤 전송하세요. Assistant는 별도의 스크립트를 작성하여 감지기와 함께 같은 엔티티에 첨부합니다.

버튼 옆의 세 개 칩(**소리 재생**, **메시지 표시**, **점수 획득**)은 완전한 문장을 대신 채워 주므로 그대로 보낼 수 있습니다.

{% hint style="info" %}
**💡 팁**: 반응 기능에는 [AI Assistant](/creator/content-creator-ko/scene-editor/extend-with-code/ai-assistant.md) 가 켜져 있어야 합니다. 꺼져 있다면, Creator Hub가 채팅을 여는 대신 어디에서 활성화해야 하는지 알려줍니다.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.decentraland.org/creator/content-creator-ko/scene-editor/interactivity/trigger-area.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
