> 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/modifier-areas.md).

# 수정 영역

Scene Editor에서 수정 영역을 사용해 아바타 동작을 변경하거나 씬의 특정 지역에서 카메라 모드를 강제합니다.

수정자 영역은 플레이어가 씬의 일부를 경험하는 방식을 바꾸는 보이지 않는 영역입니다. 유형은 두 가지입니다:

* **아바타 수정 영역**: 영역 안의 플레이어에게 보이는 아바타의 동작이나 모습을 변경합니다. 예를 들어 아바타를 숨기거나 패스포트 팝업을 비활성화합니다.
* **카메라 수정 영역**: 플레이어가 영역 안에 있는 동안 카메라를 1인칭 또는 3인칭으로 강제합니다.

플레이어가 밖으로 나가면 두 유형 모두 기본 동작으로 돌아갑니다.

## 수정자 영역 추가하기

수정자 영역은 두 가지 방법으로 추가할 수 있습니다:

**에셋 카탈로그에서:** 에셋 카탈로그를 열고 다음을 검색합니다 **아바타 수정 영역** 또는 **카메라 수정 영역** 로 들어가서 설정을 편집할 수 있습니다. **Utils** 카테고리를 찾습니다. 이를 씬으로 드래그합니다. 항목은 반투명한 자리표시자 큐브로 표시되며, 실행 중인 씬이 아니라 편집기에서만 보입니다.

**컴포넌트 메뉴에서:** 기존 엔티티를 선택하고, **+** 속성 패널 상단의 버튼을 클릭한 다음, 목록에서 **아바타 수정 영역** 또는 **카메라 수정 영역** 을 선택합니다. 다음을 참조하세요: [컴포넌트 추가](/creator/content-creator-ko/scene-editor/build/components.md#add-components) 자세한 내용은.

![Stage area라는 엔티티에서 컴포넌트 추가 메뉴가 열려 있으며, 3D Content 및 Interaction 그룹 아래에 Avatar Modifier Area와 Camera Modifier Area를 포함한 컴포넌트 목록이 보입니다.](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-6a35142910f0343c27340673c61d75ed5f75f05a%2Fadd-component.png?alt=media\&token=a3fb4e60-b24d-4e2a-b9b8-45d7db23aee0)

## 영역 크기 조정하기

수정자 영역의 크기는 엔티티의 **Transform scale**로 제어됩니다. 엔티티를 4 x 3 x 4로 스케일하면 수정자 영역은 엔티티 위치를 중심으로 한 4 x 3 x 4미터 상자가 됩니다. 필요한 크기를 설정하려면 스케일 기즈모를 사용하거나 Transform 컴포넌트에 정확한 값을 입력하세요.

{% hint style="warning" %}
**참고:** 편집기 패널에는 별도의 "Area" 필드가 없습니다. 편집기는 내부 area 속성을 엔티티의 scale과 자동으로 동기화하므로, 엔티티 크기 조정만 하면 됩니다.
{% endhint %}

## 아바타 수정 영역

Avatar Modifier Area 패널에는 두 가지 설정이 있습니다:

![Avatar Modifier Area 컴포넌트 패널로, Modifiers 드롭다운에서 Hide Avatars가 선택되어 있고 Exclude Player IDs 섹션과 Add Player ID 버튼이 보입니다.](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-43c3143c3e75e9ead736fcab3199e6eabeb53d1d%2Favatar-modifier-area-component.png?alt=media\&token=d81790d6-c6ab-4736-8eeb-15a1c1e887fd)

### Modifiers

다음 옵션이 있는 다중 선택 드롭다운입니다:

* **Hide Avatars**: 영역 안의 아바타가 보이지 않게 됩니다. 영역 안의 플레이어는 서로를 볼 수 없지만, 영역 밖의 플레이어는 여전히 정상적으로 볼 수 있습니다.
* **Disable Passports**: 이제 영역 안에서 플레이어의 아바타를 클릭해도 프로필 팝업이 열리지 않습니다.

같은 영역에서 하나 또는 두 수정자 모두를 선택할 수 있습니다. 컴포넌트를 추가하면 **Hide Avatars** 가 기본값으로 선택됩니다. 수정자를 제거하려면 **x** 를 클릭하세요.

### Exclude Player IDs

수정자의 영향을 받지 않는 지갑 주소 목록입니다. 이 목록에 주소가 있는 플레이어는 영역 안에 있어도 정상적으로 동작합니다.

클릭 **Add Player ID** 를 눌러 항목을 추가한 다음 지갑 주소를 붙여넣으세요. 항목을 제거하려면 옆의 점 세 개 메뉴를 클릭하고 **Remove Player ID**.

이는 무대에서는 관객의 아바타를 숨기면서 출연자는 보이게 유지하고 싶을 때 유용합니다.

{% hint style="warning" %}
**참고:** 지갑 주소는 반드시 소문자로 입력하세요. 수정자 영역은 정확한 문자열 일치를 사용합니다.
{% endhint %}

### 사용 사례

* **프라이버시 구역**: 백스테이지나 탈의 공간에서 아바타를 숨깁니다.
* **깔끔한 무대**: 관객 아바타를 무대에서 숨겨서 출연자(Exclude Player IDs에 등록된 플레이어)만 보이게 합니다.
* **게임 경기장**: 전투 구역에서 패스포트를 비활성화하여 플레이 중에 플레이어가 실수로 프로필을 열지 않도록 합니다.

## 카메라 수정 영역

Camera Modifier Area 패널에는 하나의 설정이 있습니다:

![Camera Modifier Area 컴포넌트 패널로, Camera Mode 드롭다운이 First Person으로 설정되어 있습니다.](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-4b25e231dcd2e4d14dfdadf7b942f94e16ad55f4%2Fcamera-modifier-area-component.png?alt=media\&token=4967a8a8-9658-481c-b84e-2de3b2a6bf25)

### Camera Mode

다음 두 옵션이 있는 드롭다운입니다:

* **First Person**: 영역 안에 있는 동안 플레이어를 1인칭 시점으로 강제합니다.
* **Third Person**: 영역 안에 있는 동안 플레이어를 3인칭 시점으로 강제합니다.

기본값은 **First Person**입니다. 플레이어가 영역을 벗어나면 이전 카메라 모드가 복원됩니다.

{% hint style="info" %}
**팁:** 여기서는 시네마틱 카메라 모드를 사용할 수 없습니다. 1인칭/3인칭 전환보다 더 세밀하게 카메라를 제어하려면 [가상 카메라](/creator/content-creator-ko/sdk7/3d/camera.md#using-virtual-cameras) 를 코드와 함께 사용하세요.
{% endhint %}

### 사용 사례

* **좁은 복도나 퍼즐 방**: 작은 오브젝트를 정확하게 클릭해야 할 때 1인칭을 강제합니다.
* **경치가 좋은 전망대**: 플레이어가 배경과 함께 자신의 아바타를 볼 수 있도록 3인칭을 강제합니다.
* **튜토리얼 구역**: 안내형 체험 동안 모든 플레이어가 동일한 카메라 모드를 사용하도록 합니다.

## 수정자 영역 결합하기

같은 엔티티에 두 유형의 수정자 영역을 모두 배치하거나, 같은 공간에 별도의 수정자 영역을 겹쳐 놓을 수 있습니다. 각 영역은 독립적으로 효과를 적용합니다.

{% hint style="warning" %}
**참고:** 씬에 있는 수정자 영역의 수는 적게 유지하세요. 너무 많으면 성능에 영향을 줄 수 있습니다. 대부분의 씬에서는 몇 개 정도면 충분합니다.
{% endhint %}

## 코드와 함께 수정자 영역 사용하기

Scene Editor의 컴포넌트는 SDK7의 `AvatarModifierArea` 과 `CameraModeArea` 컴포넌트와 직접 대응됩니다. 사용 가능한 수정자, 런타임 동작, 그리고 제외 목록을 동적으로 변경하는 것 같은 고급 옵션에 대한 자세한 내용은 다음을 참조하세요:

* [아바타 수정자 영역](/creator/content-creator-ko/sdk7/interactivity/avatars/modifier-areas.md) (SDK7)
* [카메라 모드 영역](/creator/content-creator-ko/sdk7/3d/camera.md#1st-and-3rd-person-camera-modes) (SDK7)


---

# 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/modifier-areas.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.