기존 SDK6 씬 마이그레이션

AI 도우미를 사용해 기존 SDK6 씬을 SDK7로 마이그레이션합니다.

오래된 SDK6 장면이 있는데 최신으로 업데이트하고 싶다면, AI 도우미의 도움으로 자동으로 SDK7로 마이그레이션할 수 있습니다. 그 Decentraland SDK Skills AI가 단계별로 따르는 전용 마이그레이션 워크플로가 포함되어 있어, 코드를 직접 번역할 필요가 없습니다.

이 가이드는 전체 과정을 안내합니다.

1. 새 빈 SDK7 장면 만들기

새롭고 빈 SDK7 프로젝트로 시작하세요. AI가 기존 코드와 에셋을 이 깔끔한 구조로 옮길 것입니다.

옵션 A — Creator Hub

1. Creator Hub를 엽니다.

2. 다음을 선택합니다 씬 탭을 열고 클릭 새 씬.

3. 다음을 선택하세요 빈 씬 템플릿.

옵션 B — 명령줄

빈 폴더에서 다음을 실행하세요:

npx @dcl/sdk-commands init

그러면 폴더에 SDK7 프로젝트의 기본 파일이 채워집니다.

2. SDK 스킬 설치하기

SDK 스킬은 Decentraland SDK7에서 작업하는 방법, 특히 올바른 SDK6 → SDK7 마이그레이션을 수행하는 방법을 AI 에이전트에게 알려줍니다.

설치하는 방법은 두 가지입니다.

옵션 A — AI에게 설치를 요청하기

장면 폴더에서 AI 도우미를 열고 간단히 이렇게 말하세요:

Decentraland SDK 스킬을 설치하세요.

AI는 명령을 알고 있으며 대신 설치해 줄 것입니다.

옵션 B — 명령줄에서 설치하기

npx skills add decentraland/sdk-skills --all

이 --all flag는 사용 가능한 모든 스킬을 설치합니다. 이를 빼면 대화형 선택기가 열려 설치할 스킬을 선택할 수 있습니다.

사용 가능한 스킬과 작동 방식에 대한 자세한 내용은 다음을 참조하세요 AI와 함께하는 바이브 코딩.

3. AI에게 장면 마이그레이션을 요청하기

기존 SDK6 프로젝트 파일을 AI가 읽을 수 있는 곳에 두세요. 예를 들어, 컴퓨터의 별도 폴더나 공개 GitHub 저장소에 둘 수 있습니다.

그런 다음 AI에게 다음과 같이 요청하세요:

이 SDK6 장면을 SDK7로 마이그레이션하세요.

스킬에는 전체 마이그레이션 플레이북이 포함되어 있으므로, AI는 다음을 수행합니다:

• SDK6 장면에서 진입점과 사용된 컴포넌트를 식별합니다.

• 엔티티, 컴포넌트, 시스템을 해당하는 SDK7 버전으로 변환합니다.

• 3D 모델, 오디오 및 기타 에셋을 새 프로젝트로 옮깁니다.

• 업데이트 scene.json 및 프로젝트 구성.

• 지원 중단된 API를 현재 SDK7 대응 항목으로 바꿉니다.

4. 테스트하고 반복하기

마이그레이션 작업이 끝나면 장면을 미리 보고 직접 플레이해 보세요.

• Creator Hub에서, 클릭 실행.

• 명령줄에서 다음을 실행하세요 npm run start.

테스트할 때 다음을 살펴보세요:

• 시각적 문제 — 모델 누락, 잘못된 위치나 크기, 깨진 머티리얼.

• 상호작용 문제 — 클릭이 작동하지 않음, 트리거가 활성화되지 않음, 대화상자가 나타나지 않음.

• 장면에서 사용했다면 멀티플레이어 또는 네트워킹 문제.

• 미리보기 창의 콘솔 오류.

버그를 발견하면, AI에게 자연어로 설명하세요:

테이블 위의 빨간 버튼이 더 이상 문을 열지 않아요. 예전에는 소리를 내고 문을 90도 회전시켰어요.

AI는 주변 스킬(상호작용, 애니메이션, 오디오 등)을 사용해 문제를 하나씩 해결할 수 있습니다. 장면이 원본처럼 동작할 때까지 반복하세요.

💡 팁— 한 번에 하나의 버그만 수정하고, 각 변경 후 미리보기를 확인하세요. 변경 사항이 작을수록 회귀를 훨씬 더 쉽게 잡을 수 있습니다.

다음 단계

• AI와 함께하는 바이브 코딩 — AI 도우미 및 SDK 스킬 사용을 위한 전체 참고 자료.

• SDK 빠른 시작 — SDK7 기초를 익혀 마이그레이션된 코드를 검토하고 다듬을 수 있습니다.