Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

웹 편집기 사용하기

새로운 프로젝트나 기존 프로젝트를 진행하는 데 사용할 수 있는 웹 편집기가 있습니다.

참고

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

브라우저 지원

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

지원되는 웹 브라우저 목록은 :ref:`doc_system_requirements`를 참조하세요. 모바일 브라우저는 지원되지만 성능 및 입력 제한으로 인해 이상적인 환경을 제공하지 않습니다.

웹 편집기는 호환성 렌더링 방식만 지원하는데 Vulkan 애플리케이션을 아직 웹에서 실행할 수 있는 안정적인 방법이 아직 없기 때문입니다.

참고

Firefox에서 성능 문제가 발생하는 경우 Chromium 기반 브라우저를 사용해 보십시오. WebGL 애플리케이션에서 더 나은 성능을 발휘할 수 있습니다.

제한 사항

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

  • C#/Mono 지원이 없습니다.

  • GDExtension 지원이 없습니다.

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

  • 프로젝트 내보내기가 없습니다. 해결 방법으로 프로젝트 > 툴 > Download Project Source를 사용하여 프로젝트 소스를 다운로드하고 Godot 편집기의 네이티브 버전을 사용하여 내보낼 수 있습니다.

  • 편집기는 저장되지 않은 변경사항이 있는 탭을 닫을 때 경고하지 않습니다.

  • 라이트맵 굽기 지원이 없습니다. 여전히 기존 라이트맵을 Godot 편집기의 네이티브 버전으로 구운 경우 (예: 기존 프로젝트 가져오기) 사용할 수 있습니다.

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

  • 외부 스크립트 편집기를 위한 지원이 없습니다.

  • Android 원클릭 배포에 대한 지원이 없습니다.

더 보기

알려진 버그의 목록에 대해서는 웹 편집기와 관련된 GitHub의 열린 이슈의 목록을 참조하세요.

프로젝트 가져오기

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

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

  • Start Godot editor를 클릭해서 편집기를 실행하세요. Godot 프로젝트 매니저는 10-20초 후에 나타납니다. 컴퓨터나 연결 느린 상태에서는 불러오는 데 최대 1분이 걸릴 수 있습니다.

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

  • 설치 및 편집을 클릭하면 프로젝트가 편집기에서 열릴 것입니다.

주의

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

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

프로젝트 편집 및 실행하기

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

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

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

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

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

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