> 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인칭 시점으로 고정합니다.

플레이어가 영역 밖으로 나가면 두 유형 모두 일반 동작으로 되돌아갑니다.

## 수정자 영역 추가하기

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

**에셋 카탈로그에서 추가:** 에셋 카탈로그를 열고 다음 항목을 검색합니다. **아바타 수정자 영역** 또는 **카메라 수정자 영역** 의 **유틸리티** 카테고리에서 항목을 장면으로 드래그합니다. 해당 항목은 에디터에서만 표시되고 실행 중인 장면에서는 표시되지 않는 반투명한 자리표시자 큐브로 나타납니다.

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

![Stage area라는 엔티티에서 컴포넌트 추가 메뉴를 연 모습. 3D 콘텐츠 및 상호작용 그룹 아래에 아바타 수정자 영역과 카메라 수정자 영역을 비롯한 컴포넌트가 나열되어 있습니다.](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-e735e723bc67fa3ef0cdcb9aff864a9bc8143f34%2Fadd-component.webp?alt=media)

## 영역 크기 조정

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

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

## 아바타 수정자 영역

아바타 수정자 영역 패널에는 두 가지 설정이 있습니다.

![아바타 수정자 영역 컴포넌트 패널. 수정자 드롭다운에서 아바타 숨기기가 선택되어 있고, 플레이어 ID 제외 섹션과 플레이어 ID 추가 버튼이 표시되어 있습니다.](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-1ec168b1d049a28a6e43815dc799a57997d87af8%2Favatar-modifier-area-component.webp?alt=media)

### 수정자

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

* **아바타 숨기기**: 영역 안의 아바타가 보이지 않게 됩니다. 영역 안의 플레이어는 서로를 볼 수 없지만, 영역 밖의 플레이어에게는 계속 정상적으로 표시됩니다.
* **여권 비활성화**: 영역 안에서 플레이어의 아바타를 클릭해도 프로필 팝업이 더 이상 열리지 않습니다.

같은 영역에 수정자를 하나 또는 두 개 모두 선택할 수 있습니다. 컴포넌트를 추가하면 **아바타 숨기기** 가 기본적으로 선택됩니다. 수정자를 제거하려면 해당 수정자의 **x** 를 클릭하세요.

### 플레이어 ID 제외

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

클릭하여 **플레이어 ID 추가** 항목을 추가하려면 지갑 주소를 붙여넣으세요. 항목을 삭제하려면 해당 항목 옆의 점 3개 메뉴를 클릭하고 **플레이어 ID 삭제**.

무대에서 관객 아바타는 숨기고 공연자는 계속 표시하려는 이벤트에 유용합니다.

{% hint style="warning" %}
**참고:** 지갑 주소는 소문자로 입력해야 합니다. 수정 영역에서는 문자열을 정확히 일치시켜 비교합니다.
{% endhint %}

### 사용 사례

* **프라이버시 구역**: 무대 뒤편이나 탈의 공간에서 아바타를 숨깁니다.
* **깔끔한 무대**: 무대에서 관객 아바타를 숨겨, 제외 플레이어 ID에 등록된 공연자만 표시합니다.
* **게임 아레나**: 전투 구역에서 여권을 비활성화해 플레이어가 게임 중 실수로 프로필을 열지 않도록 합니다.

## 카메라 수정 영역

카메라 수정 영역 패널에는 설정이 하나 있습니다.

![카메라 모드 드롭다운이 1인칭으로 설정된 카메라 수정 영역 구성 요소 패널입니다.](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-c102f8a50a07268c75d75aeaa01414e74b112855%2Fcamera-modifier-area-component.webp?alt=media)

### 카메라 모드

두 가지 옵션이 있는 드롭다운입니다.

* **1인칭**: 영역 안에 있는 동안 플레이어를 1인칭 시점으로 고정합니다.
* **3인칭**: 영역 안에 있는 동안 플레이어를 3인칭 시점으로 고정합니다.

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

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

### 사용 사례

* **좁은 복도 또는 퍼즐 방**: 작은 오브젝트를 정확하게 클릭할 수 있도록 1인칭 시점을 강제합니다.
* **경치 감상 장소**: 배경과 함께 아바타를 볼 수 있도록 3인칭 시점을 강제합니다.
* **튜토리얼 구역**: 안내형 경험 중 모든 플레이어가 같은 카메라 모드를 사용하도록 합니다.

## 수정 영역 함께 사용하기

두 종류의 수정 영역을 동일한 엔티티에 배치하거나, 같은 공간에 별도의 수정 영역을 겹쳐 배치할 수 있습니다. 각 영역은 효과를 독립적으로 적용합니다.

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

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

씬 편집기의 구성 요소는 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.
