웹 에디터 사용하기

Godot 3.3부터 새 프로젝트나 기존 프로젝트를 웹 에디터에서도 작업할 수 있습니다.

참고

웹 에디터는 초기 단계에 있습니다. 기능이 교육 목적으로 충분할 수 있지만 현재로서는 출시할 게임을 작업하는 것은 권장되지 않습니다. 아래 제한사항를 참조하세요.

브라우저 지원

웹 에디터는 웹어셈블리(WebAssembly)의 SharedArrayBuffer에 대한 지원이 필요합니다. 이는 브라우저에서 스레딩을 지원하는 데 필요합니다. 다음 데스크탑 브라우저들은 웹어셈블리 스레딩을 지원하므로 웹 에디터를 실행할 수 있습니다:

  • Chrome 68 또는 이후 버전

  • Firefox 79 또는 이후 버전

  • Edge 79 또는 이후 버전

Opera 및 Safari는 아직 지원되지 않습니다. 적절한 스레딩 지원이 추가되면 나중에 Safari에서도 작동할 수 있습니다.

모바일 브라우저는 현재 지원되지 않습니다.

웹 에디터는 GLES3 및 GLES2 렌더러를 모두 지원하지만 더 나은 성능과 구형/저사양 하드웨어와의 호환성을 위해 GLES2를 권장합니다.

참고

Linux를 사용할 경우 Firefox WebGL 성능 저하로 인해 Firefox 대신 Chromium 기반 브라우저 사용을 권장합니다.

제한사항

Godot 또는 웹 플랫폼 측의 제한으로 인해 현재 다음 기능이 누락되었습니다:

  • C#/Mono 미지원.

  • GDNative 미지원.

  • 디버깅 미지원. GDScript 디버깅/프로파일링, 라이브 장면 편집, 원격 씬 트리 독 및 디버거 프로토콜에 의존하는 기타 기능이 작동하지 않습니다.

  • 프로젝트 내보내기 미지원. 해결 방법으로 프로젝트(Project) > 도구(Tools) > 프로젝트 소스 다운로드(Download Project Source)로 프로젝트 소스를 다운로드하고 네이티브 버전 Godot 에디터을 사용해 내보낼 수 있습니다.

  • 에디터에서 변경 내용이 저장되지 않아도 탭을 닫을 때 여러분에게 경고하지 않습니다.

  • 라이트맵 베이킹 미지원. 기존 라이트맵이 네이티브 버전 Godot 에디터로 베이크된 경우(예: 기존 프로젝트 가져오기로 가져온 프로젝트) 계속 사용할 수 있습니다.

다음 기능들은 웹 플랫폼의 고유한 제한으로 인해 지원되지 않을 수 있습니다:

  • 외부 스크립트 에디터 미지원.

  • Android 원클릭 배포 미지원.

더 보기

알려진 버그는 Github의 웹 에디터 오픈 이슈 목록을 참조하세요.

프로젝트 가져오기

기존 프로젝트를 가져오려면 다음과 같이 합니다:

  • Preload project ZIP 입력을 사용해 HTML5 파일 시스템에 미리 가져올 ZIP 파일을 지정하세요.

  • Start Godot editor를 클릭해서 에디터를 실행하세요. Godot 프로젝트 관리자는 10-20초 후에 나타납니다. 느린 컴퓨터나 연결 상태에서는 로딩하는 데 최대 1 분이 걸릴 수 있습니다.

  • 창 중앙에 나타나는 대화 상자에서 만들 폴더의 이름을 지은 다음 Create Folder 버튼을 클릭하세요(ZIP 압축 파일 이름과 일치하지 않아도 됨).

  • Install & Edit을 클릭하면 에디터에서 프로젝트가 열립니다.

주의

프로젝트 폴더를 /home/web_user/에 위치시키는 것이 중요합니다. 프로젝트 폴더가 /home/web_user/ 외부에 있는 경우 에디터를 닫을 때 프로젝트를 잃게 됩니다!

위에서 설명한 단계를 따라가면 프로젝트 폴더는 항상 /home/web_user/projects에 위치하므로 안전합니다.

프로젝트 편집 및 실행

Godot의 네이티브 버전과 달리 웹 에디터는 단일 창으로 제한됩니다. 따라서 프로젝트 실행 시 새 창을 열 수 없습니다. 대신에 실행 버튼을 클릭하거나 F5를 눌러 프로젝트를 실행하면 에디터 창을 "대체"합니다.

웹 에디터는 에디터 및 게임 창(현재 "탭")을 처리하는 다른 방법을 제공합니다. 위쪽 버튼을 사용해 EditorGame탭으로 전환할 수 있습니다. 해당 탭 옆에 있는 × 버튼을 클릭하면 실행 중인 게임이나 에디터를 닫을 수도 있습니다.

제 프로젝트 파일은 어디에 있나요?

브라우저 보안 제한으로 인해 에디터는 프로젝트 파일을 브라우저의 IndexedDB 저장소에 저장합니다. 이 저장소는 컴퓨터에서 일반 폴더로 액세스할 수 없지만 데이터베이스단에서 추상화됩니다.

프로젝트(Project) > 도구(Tools) > 프로젝트 소스 다운로드(Download Project Source)를 사용해 프로젝트 파일을 ZIP 압축 파일로 다운로드할 수 있습니다. 이는 웹 에디터에서 내보내기가 아직 지원되지 않기 때문에 네이티브 Godot 편집기를 사용해서 프로젝트를 내보내는 데 사용할 수 있습니다.

미래에는 HTML5 FileSystem API를 사용해 네이티브 에디터처럼 사용자의 파일 시스템에 프로젝트 파일을 저장하는 것이 가능할 수도 있습니다. 그러나 아직 구현되지는 않았습니다.