Work in progress

The content of this page was not yet updated for Godot 4.2 and may be outdated. If you know how to improve this page or you can confirm that it's up to date, feel free to open a pull request.

웹 에디터 사용하기

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

참고

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

브라우저 지원

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

  • Chrome 68 또는 이후 버전

  • Firefox 79 또는 이후 버전

  • Edge 79 또는 이후 버전

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

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

The web editor only supports the Compatibility rendering method, as there is no stable way to run Vulkan applications on the web yet.

참고

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

제한사항

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

  • C#/Mono 미지원.

  • No GDExtension support.

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

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

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

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

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

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

  • Android 원클릭 배포 미지원.

더 보기

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

프로젝트 가져오기

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

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

  • Run the editor by clicking Start Godot editor. The Godot Project Manager should appear after 10-20 seconds. On slower machines or connections, loading may take up to a minute.

  • 창 중앙에 나타나는 대화 상자에서 만들 폴더의 이름을 지은 다음 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를 사용해 네이티브 에디터처럼 사용자의 파일 시스템에 프로젝트 파일을 저장하는 것이 가능할 수도 있습니다. 그러나 아직 구현되지는 않았습니다.