> 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/content/overview.md).

# 개요

Decentraland의 가상 세계 안에서 찾을 수 있는 모든 것은 Catalyst로 알려진 분산 서버 네트워크에 호스팅되며, 이 서버들은 (그 밖의 것들 중) 콘텐츠 API를 제공합니다. 이는 클라이언트가 콘텐츠를 업로드하고 다운로드하는 수단입니다.

Catalyst의 전체 API는 [자체 참조 문서에서](https://decentraland.github.io/catalyst-api-specs/). 여기서는 콘텐츠가 어떻게 구성되고, 어떻게 발견되어 다운로드될 수 있는지 이해하는 데 초점을 맞추겠습니다.

아래에서 언급되는 모든 중요한 개념은 각자의 페이지에서 더 자세히 설명됩니다.

### 파일, 엔티티, 포인터

Decentraland의 콘텐츠 시스템에는 세 가지 계층이 있습니다: [파일](https://github.com/decentraland/docs/blob/main/contributor/filesystem.md) 는 ... 안에 패키징되어 있고 [엔티티입니다](https://github.com/decentraland/docs/blob/main/contributor/entities.md), 그리고 엔티티는 ...를 사용하여 발견됩니다 [pointers](https://github.com/decentraland/docs/blob/main/contributor/pointers.md).

{% @mermaid/diagram content="flowchart LR
Pointer --> Entity
Entity --> File1\["File 1"]
Entity --> File2\["File 2"]
Entity --> File3\["File 3"]" %}

[파일](https://github.com/decentraland/docs/blob/main/contributor/filesystem.md) 은 IPFS와 유사한 분산 파일 시스템에 저장되며, 콘텐츠 서버 전반에 자동으로 동기화됩니다. 이들은 파일 내용으로부터 계산된 고유한 문자열 ID로 식별되며, 식별자와 콘텐츠 모두 **불변입니다**. 파일을 업데이트하는 것은 존재하지 않습니다. 대신, 대체 파일이 업로드되고 오래된 파일은 삭제됩니다.

[엔티티](https://github.com/decentraland/docs/blob/main/contributor/entities.md) 는 파일들의 원자적 묶음이며, 씬과 웨어러블 아이템 같은 월드에서 발견되는 실제 콘텐츠를 나타냅니다. 엔티티에는 최소한 하나의 파일이 있으며, 이는 *매니페스트*, 일반 설명 및 메타데이터와 함께. 포함하는 개별 파일들처럼, 이것들도 불변이며 고유하고 결정적인 문자열로 식별됩니다. 모든 엔티티에는 소유자가 있으며, 이를 관리하는 데 필요한 개인 키를 보유하고 있습니다.

[포인터](https://github.com/decentraland/docs/blob/main/contributor/pointers.md) 는 엔티티의 ID로 확인할 수 있는 안정적인 참조입니다. 엔티티가 교체되면(즉, 소유자가 새 패키지를 업로드하고 이전 패키지가 삭제되면), 포함된 파일과 메타데이터가 달라지고 식별자도 달라지지만, 포인터는 그대로 유지되고 새 버전으로 리디렉션됩니다.

### 스냅샷

콘텐츠 서버는 또한 특정 시점의 모든 활성 엔티티(즉, 현재 포인터가 참조하는 엔티티)의 요약이 담긴 큰 줄바꿈 구분 JSON 파일도 호스팅합니다. 이를 [스냅샷](https://github.com/decentraland/docs/blob/main/contributor/snapshots.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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.decentraland.org/contributor/contributor-ko/content/overview.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.