> 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/sdk7/getting-started/dev-workflow.md).

# 개발 워크플로

아이디어 구상부터 테스트와 게시까지, Creator Hub로 Decentraland 씬을 만드는 권장 워크플로.

이 문서에서는 Decentraland 씬을 구상하는 단계부터 게시 이후까지, 씬 개발에 권장되는 절차를 안내합니다.

## Decentraland 씬은 어떻게 만드나요?

1. **씬을 만들고, 미리 보고, 퍼블리시하기 위한 공식 데스크톱 앱인**  [**Creator Hub**](https://decentraland.org/download/creator-hub)를 설치하세요. 모든 숙련도의 크리에이터에게 권장되는 도구입니다.
2. **AI 코딩 어시스턴트를 사용한다면** (예: Claude Code, Cursor, Copilot), 검증된 SDK7 패턴을 활용할 수 있도록 공식  [Decentraland SDK Skills](https://docs.decentraland.org/creator/content-creator-ko/sdk7/getting-started/vibe-coding.md) 를 설치하세요: `npx skills add decentraland/sdk-skills`
3. **고급 사용자와 자동화된 워크플로를 위한 대안으로**  [**CLI**](https://docs.decentraland.org/creator/content-creator-ko/sdk7/getting-started/using-the-cli.md) 를 사용할 수도 있습니다.

아래 섹션에서 워크플로의 각 단계를 자세히 살펴봅니다.

## Creator Hub 설치

Decentraland Creator Hub가 설치되어 있는지 확인하세요.

* [설치 가이드](https://docs.decentraland.org/creator/content-creator-ko/scene-editor/get-started/editor-installation.md)

코드 작업을 할 예정이라면 다음도 설치하세요. [Visual Studio Code](https://code.visualstudio.com/) 또는 [Cursor AI](https://www.cursor.com/).

{% hint style="info" %}
**💡 팁**: 자연어로 설명을 작성해 AI 어시스턴트가 씬 코드를 생성하도록 할 수도 있습니다. AI 지원 개발을 시작하는 방법은 [AI를 활용한 바이브 코딩](https://docs.decentraland.org/creator/content-creator-ko/sdk7/getting-started/vibe-coding.md) 을 참고하세요.
{% endhint %}

## 경험 설계

필요한 공간의 크기, 배치 방식, 플레이어가 수행할 수 있게 할 게임 메커니즘 등을 생각해 보세요. 다음 문서를 참고하면 좋습니다.

* [UX 및 UI 가이드](https://docs.decentraland.org/creator/content-creator-ko/sdk7/designing-the-experience/ux-ui-guide.md)
* [게임 설계 제약 사항](https://docs.decentraland.org/creator/content-creator-ko/sdk7/designing-the-experience/design-games.md)
* [씬 MVP 지침](https://docs.decentraland.org/creator/content-creator-ko/sdk7/designing-the-experience/mvp-guidelines.md)

## 게시 위치

Decentraland에서는 제한된 공간에 인접한 토지 구획을 사용해 콘텐츠를 게시합니다. 플레이어는 한 구획에서 다른 구획으로 자유롭게 이동할 수 있습니다. 각 씬은 독립된 작은 세계이며, 한 씬의 아이템은 다른 씬으로 확장될 수 없습니다. 또한 각 씬의 코드는 다른 모든 씬과 격리된 샌드박스에서 실행됩니다.

각 구획에 게시할 수 있는 권한은 토큰으로 제어됩니다. 씬 개발에는 토지가 필요하지 않지만, 게시할 준비가 되면 토지에 대한 접근 권한이 필요합니다.

또는 독립적이고 격리된 씬인 Decentraland [월드](https://docs.decentraland.org/creator/content-creator-ko/sdk7/publishing/publishing-options.md#decentraland-worlds)에 게시할 수도 있습니다.

다음 옵션을 이용할 수 있습니다.

* LAND 임대
* LAND 구매
* 토지 소유자로부터 권한 받기
* Decentraland 월드에 게시하려면 [월드](https://docs.decentraland.org/creator/content-creator-ko/sdk7/publishing/publishing-options.md#decentraland-worlds) 를 참고하세요.

자세한 내용은 [게시 옵션](https://docs.decentraland.org/creator/content-creator-ko/sdk7/publishing/publishing-options.md) 을 참고하세요.

## 템플릿 및 예제

새 씬을 만들 때는 기본 코드와 3D 모델이 포함된 여러 기본 템플릿 씬 중 하나를 선택하세요. 이를 활용하면 더 빠르게 시작할 수 있습니다.

* [예제 씬](https://docs.decentraland.org/creator/content-creator-ko/tutorials-and-examples/examples.md): 여기에서 재사용하거나 참고할 수 있는 메커니즘을 보여 주는, 엄선된 작동 씬 및 저장소 모음을 확인할 수 있습니다.
* [도우미 라이브러리](https://studios.decentraland.org/resources?sdk_version=SDK7\&resource_type=Library): 다양한 일반 작업을 간소화할 수 있습니다.

## 아트 에셋

숙련된 아티스트이거나 아티스트의 도움을 받을 수 있다면, 씬에 사용할 맞춤형 `.gltf` 또는 `.glb` 모델을 만들 수 있습니다. Decentraland용 3D 모델을 만드는 방법은 [3D 모델 기본 사항](https://docs.decentraland.org/creator/content-creator-ko/3d/3d-models.md) 을 참고하세요.

하지만 에셋을 직접 만들 필요는 없습니다. [유용한 리소스](https://docs.decentraland.org/creator/content-creator-ko/sdk7/getting-started/useful-resources.md) 에서 3D 모델을 구할 수 있는 에셋 라이브러리와 생성형 AI 도구, 그리고 워크플로를 효율화할 수 있는 기타 도구를 확인하세요.

## 로컬 미리보기 실행

씬을 미리 보려면 Creator Hub에서 씬을 열고 **플레이** 버튼을 클릭하세요. 또는 명령줄에서 작업 중이라면 프로젝트 루트 폴더에서 다음 명령을 실행하세요. `npm run start` 를 실행하세요.

* [씬 미리보기](https://docs.decentraland.org/creator/content-creator-ko/sdk7/getting-started/preview-scene.md) 에서 자세히 알아보세요.
* 문제가 발생했을 때 디버깅하는 방법은 [씬 디버깅](https://docs.decentraland.org/creator/content-creator-ko/sdk7/debugging/debug-in-preview.md) 을 참고하세요.
* Desktop Explorer는 3D 모델을 최적화된 에셋 번들로 미리 보여 줍니다. 이 번들은 사용자의 컴퓨터에서 변환되므로 미리보기가 더 원활하게 실행되고, 게시 후의 모습과 똑같이 모델을 확인할 수 있습니다. 자세한 내용은 [최적화된 에셋으로 미리보기](https://docs.decentraland.org/creator/content-creator-ko/sdk7/getting-started/preview-scene.md#preview-with-optimized-assets).

{% hint style="info" %}
**💡 팁**: Creator Hub를 사용하는 경우 씬을 변경할 때마다 미리보기가 자동으로 업데이트됩니다. 미리보기가 실행 중일 때도 업데이트됩니다.
{% endhint %}

## Decentraland에 게시

씬이 마음에 들면 이제 Decentraland에 게시할 차례입니다. 게시하려면 LAND, Decentraland NAME 또는 ETH ENS 이름을 보유하고 있거나, 이를 보유한 사람에게 권한을 받아야 합니다.

게시 방법은 [게시](https://docs.decentraland.org/creator/content-creator-ko/sdk7/publishing/publishing.md) 안내를 참고하세요.

또는 LAND가 필요 없는 개인용 3D 공간인 [Worlds](https://docs.decentraland.org/creator/content-creator-ko/sdk7/publishing/publishing-options.md#decentraland-worlds)에 게시할 수도 있습니다.

## 홍보하기

이제 씬이 공개되었으니 널리 알려 보세요! 다음과 같은 방법이 있습니다.

* 소셜 미디어에 공유하기 (#DCL)
* 다음에서 알리기: [Discord](https://dcl.gg/discord)
* 다음에 소개될 수 있도록 제출하기: [events.decentraland.org](https://events.decentraland.org/)
* 씬에서 이벤트 열기
* 유동 인구가 많은 지역에 씬으로 연결되는 스폰 지점 추가하기

## 반복 개선

씬을 한동안 공개해 플레이어들의 피드백을 받았다면, 씬을 개선하기에 더없이 좋은 시점입니다!

콘텐츠를 개선하고 새로운 기능을 추가한 뒤, 씬의 새 버전을 같은 좌표에 배포하세요.

## 기여하기

자랑스러운 씬, 게임 또는 애플리케이션을 만들었다면 오픈 소스로 공개해 보세요! 다른 사람들이 코드를 통해 배우고 작업물을 발전시킬 수 있습니다. 전체 프로젝트를 다음에 공유할 수도 있습니다: [Awesome Repository](https://github.com/decentraland-scenes/Awesome-Repository).

재사용 가능한 기능을 만들었다면 다른 사람들이 프로젝트에 가져다 쓸 수 있도록 라이브러리로 만드는 것도 좋습니다.


---

# 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/sdk7/getting-started/dev-workflow.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.
