> 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/get-started/migrate-from-web.md).

# Creator Hub로 마이그레이션

Web Editor에서 씬을 Creator Hub로 마이그레이션합니다.

Creator Hub이 아닌 다른 도구로 만든 씬이 있다면, 쉽게 Creator Hub으로 마이그레이션할 수 있습니다.

Creator Hub은 Decentraland 씬을 만들 때 권장되는 도구입니다. Web Editor보다 훨씬 더 세련된 인터페이스를 제공하며, 쉬운 드래그 앤 드롭 인터페이스와 코드를 통해 더 세부적으로 커스터마이즈할 수 있는 기능을 결합할 수 있습니다. 또한 최신 데스크톱 클라이언트를 사용해 씬 미리보기를 실행할 수 있습니다.

## Web Editor에서 마이그레이션

Web Editor로 만든 씬의 코드를 편집하려면, 씬을 로컬 컴퓨터로 내보낸 다음 Creator Hub으로 열어야 합니다.

{% hint style="warning" %}
**📔 참고**: Creator Hub이 설치되어 있지 않다면, 시작하기 전에 다음 페이지의 단계를 따르세요.

[Creator Hub 설치](/creator/content-creator-ko/scene-editor/get-started/editor-installation.md)
{% endhint %}

1. 다음 **다운로드 아이콘** 씬을 편집하는 동안 Web Editor의 상단 메뉴에서

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-60c2ed69a5172f033eb1fb47980323cc50f21208%2Fexport.png?alt=media\&token=6587ddb6-64cc-416e-b594-74bac582874b)

2. 그러면 다음 항목이 다운로드됩니다 *.zip* 파일을 압축 해제하세요.
3. 다음을 열고 **크리에이터 허브**, 다음으로 이동하여 **씬** 섹션.
4. 다음 **씬 가져오기** 버튼을 클릭한 다음 내보낸 프로젝트 폴더의 경로를 선택하세요.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-684f70250aae678dd8d6f868d02f7a739a51ae22%2Fimport-scene.png?alt=media\&token=39ff763b-0e81-44cf-9c00-db8db1ad7000)

완료하면 Web Editor와 매우 비슷하지만 훨씬 더 세련된 시각적 인터페이스를 갖춘 Creator Hub 안에서 프로젝트 작업을 계속할 수 있습니다.

또한 다음 아래의 파일을 편집할 수도 있습니다 `/src` 폴더에서 코드로 씬에 동작을 추가하세요. 다음을 참조하세요 [코드와 결합](/creator/content-creator-ko/scene-editor/extend-with-code/overview.md) 씬의 코드를 편집하는 방법은

## 코드 전용 프로젝트 마이그레이션

코드 전용 프로젝트는 무엇이든 Creator Hub으로 가져올 수 있습니다. 이렇게 하려면

1. Creator Hub을 열고 다음으로 이동합니다 **씬** 섹션.
2. 다음 **씬 가져오기** 버튼을 클릭한 다음 내보낸 프로젝트 폴더의 경로를 선택하세요.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-684f70250aae678dd8d6f868d02f7a739a51ae22%2Fimport-scene.png?alt=media\&token=39ff763b-0e81-44cf-9c00-db8db1ad7000)

완료되면 Creator Hub 안에서 프로젝트 작업을 시작할 수 있으며, 이로 인해 씬의 코드를 편집할 때 여전히 즐겨 사용하는 코드 편집기를 사용하거나, 명령줄을 사용해 씬을 실행 또는 배포하는 데 지장이 생기지 않습니다.

프로젝트를 가져온 후에는 코드로 생성된 콘텐츠가 Creator Hub 캔버스에서 보이거나 편집할 수 없게 되며, 이로 인해 새 항목을 배치하고 정렬하기가 어려울 수 있습니다. 처음에는 씬이 빈 그리드로 표시됩니다.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-0be6795f51a4b3256f2316be0347810e4fcb034b%2Fempty-project.png?alt=media\&token=0fc98b7a-139d-40fd-9732-36bddcdadb71)

콘텐츠를 캔버스에 처음부터 수동으로 추가하는 대신, 명령을 실행해 자동으로 추가할 수 있습니다. 그러려면 최신 버전의 SDK가 설치되어 있는지 확인한 다음 터미널에서 다음 명령을 실행하세요:

```
npx sdk-commands code-to-composite
```

{% hint style="danger" %}
**❗경고**: 이 명령을 실행하기 전에 프로젝트를 백업해 두세요.

이 명령은 다음 항목을 덮어씁니다 `main.composite` 파일을 새 스냅샷으로 덮어씁니다. 또한 다음 안의 모든 코드를 주석 처리합니다 `.ts` 의 파일 `src` 폴더. 다시 실행하려면 코드 주석을 해제해야 합니다.
{% endhint %}

이 명령은 씬을 실행하고 첫 프레임에서 코드로 생성된 콘텐츠의 스냅샷을 찍습니다. 이 스냅샷은 다음에 저장됩니다 `main.composite` 파일이며, Creator Hub이 씬의 콘텐츠를 표시하는 데 사용합니다. 씬의 코드는 모든 엔티티가 중복되는 것을 방지하기 위해 주석 처리됩니다.

이 명령은 Creator Hub UI에서 표현할 수 있는 엔티티와 컴포넌트만 캡처한다는 점에 유의하세요. 사용자 정의 컴포넌트나 로직을 수행하는 코드, 또는 코드로 생성된 UI 요소는 복제하지 않습니다. 주석 처리된 동작을 다시 추가하려면 다음에 있는 코드를 편집해야 합니다 `.ts` 의 파일 `src` 폴더에서 필요한 줄의 주석을 해제하세요.

새 엔티티를 생성하는 대신 이름이나 태그로 기존 엔티티를 참조하여 동작을 부여하도록 코드의 일부를 다시 작성하고 싶을 수도 있습니다. 다음을 참조하세요 [코드와 결합](/creator/content-creator-ko/scene-editor/extend-with-code/overview.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/creator/content-creator-ko/scene-editor/get-started/migrate-from-web.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.
