> 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/contributor/contributor-ko/scene-runtime/overview.md).

# 개요

Decentraland 씬 런타임은 샌드박스형 실행 환경으로, 여기서 하나의 [씬](https://github.com/decentraland/docs/tree/main/content/entity-types/scenes.md) 이 메인 스크립트를 실행합니다.

각 씬은 자체적으로 분리된 런타임에서 실행됩니다. 그 안에서 씬은 특정 [전역 객체](https://github.com/decentraland/docs/tree/main/contributor/globals.md) 를 사용할 수 있으며 [모듈](https://github.com/decentraland/docs/tree/main/contributor/modules.md) 을 런타임 라이브러리에서 가져올 수 있습니다.

```mermaid
flowchart TB
    subgraph WorldExplorer["월드 탐색기"]
        subgraph Runtime1["런타임 1"]
            Scene1["씬"]
        end
        
        subgraph Runtime2["런타임 2"]
            Scene2["씬"]
        end
        
        subgraph Runtime3["런타임 3"]
            Scene3["씬"]
        end
        
        Scene1 --> Library["런타임 모듈 라이브러리"]
        Scene2 --> Library
        Scene3 --> Library
    end
```

런타임 라이브러리에서 모듈을 가져오면 씬은 다음을 포함한 다양한 기능에 접근할 수 있습니다:

* 엔티티를 생성하고 동작을 제어하기
* 플레이어와 상호작용하기
* 다른 플레이어와 통신하기
* 월드 상태를 살펴보기
* 외부 서비스에 연결하기
* 웹3 결제하기

실제로, 씬은 다음을 [Decentraland SDK](https://github.com/decentraland/docs/tree/main/contributor/creator/sdk7/getting-started/sdk-101.md) 를 자신의 코드와 함께 번들로 묶는데, 이는 런타임 라이브러리의 RPC 스타일 인터페이스를 캡슐화하고 더 좋고 편리한 API를 제공합니다.

{% hint style="info" %}
참고로 SDK는 *아닙니다* Decentraland 프로토콜의 일부가 아니며, 더 낮은 수준의 인터페이스만 해당됩니다. 씬은 SDK를 번들로 포함할지 아니면 대체 라이브러리를 사용할지 결정할 수 있습니다.
{% endhint %}

### 전역 객체

샌드박스 환경 내부에서는, [장면들](https://github.com/decentraland/docs/tree/main/content/entity-types/scenes.md) 특정 객체와 함수가 전역적으로 사용 가능하다고 가정합니다. 일부는 표준 ES2020 객체이며(예: `Date` 또는 `Math`), 그리고 다른 것들은 모듈을 require하고, 메시지를 기록하고, 콜백을 예약하는 등의 기능을 구현하기 위해 런타임에 의해 주입됩니다.

자세한 내용은 [globals](https://github.com/decentraland/docs/tree/main/contributor/globals.md) 에서 더 자세히 확인하세요.

### 모듈

그 [`require`](https://github.com/decentraland/docs/tree/main/contributor/globals.md#module) 전역 함수는 다음에서 제공하는 모듈을 가져올 수 있습니다: [런타임 라이브러리](https://github.com/decentraland/docs/tree/main/contributor/execution.md). 이러한 모듈을 통해 ECS나 커뮤니케이션 시스템과 같은 유틸리티를 선택적으로 가져올 수 있습니다.

전체 목록은 런타임 모듈 섹션을 참조하세요.

### 실행

런타임은 씬이 특정 메서드 집합을 구현하도록 요구하며, 해당 메서드들이 특정 규칙에 따라 호출됨을 보장합니다.

참고 [실행](https://github.com/decentraland/docs/tree/main/contributor/execution.md) 자세한 내용은 여기를 참조하세요.

### 권한

타사 서비스에 HTTP 요청을 보내는 것과 같은 민감한 기능은, 다음에서 특정 권한을 요청하지 않는 한 런타임에 의해 제한됩니다: [씬](https://github.com/decentraland/docs/tree/main/content/entity-types/scenes.md)그리고 플레이어가 부여합니다.

참고 [권한](https://github.com/decentraland/docs/tree/main/contributor/permissions.md) 자세히 알아보려면.


---

# 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/contributor/contributor-ko/scene-runtime/overview.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.