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...

XR 툴 소개

Godot는 XR 프로젝트를 설정하기 위한 모든 기초 지원을 제공합니다. 하지만 XR의 특정 게임 메커니즘은 이 기반의 위에 구현되어야 합니다. Godot는 이 작업을 비교적 쉽게 만들어 주지만, 여전히 어려운 작업일수 있습니다.

이러한 이유로 Godot에서는 Godot XR Tools라고 하는 툴킷을 개발하였습니다. XR 게임들에 필요한 기초적인 로코모션과 오브젝트 상호작용, 그리고 UI 상호작용이 구현되어 있습니다.

이 툴킷은 OpenXR과 WebXR 런타임에 모두 동작하도록 설계되었습니다. 이 문서는 이 툴킷을 기반으로 작성할 것입니다. 빠르게 동작 가능한 프로그램을 만드는 데 도움이 될 것이고, 필요한 경우에는 직접 로직을 작성하셔도 무방합니다. 직접 작성하는 경우에도 XR 툴이 도움이 될 수 있을 것입니다.

XR 툴 설치하기

XR 설정하기 에서 설정한 프로젝트에서부터 Godot XR 도구 라이브러리를 추가할 것입니다. Godot XR Tools releases page 에서 다운로드 할 수 있습니다. Godot 4 버전의 pre-release 최신 버전을 찾아서 godot-xr-tools.zip 파일을 assets에 다운로드하세요.

다운로드가 완료되면 압축을 푸세요. 그러면 파일들이 godot-xr-tools 폴더 아래 있는 것을 확인할 수 있습니다. 그 안에 addons 폴더가 있고, 이 폴더를 복사해서 여러분의 Godot 프로젝트 폴더에 복사하시면 프로젝트가 아래와 같은 상황이 될 것입니다:

../../_images/godot_xr_tools_root_folder.webp

이제 Godot에서 프로젝트를 열고, 필요하다면 플러그인의 리소스 가져오기가 완료될 때까지 몇 분 기다리세요.

가져오기가 완료된 후 여러 "스크립트 로드 실패" 메시지가 나타나는 것을 확인할 수 있습니다. 이는 정상적인 현상입니다. 프로젝트 설정에서 플러그인을 활성화하면 됩니다.

다음으로 프로젝트 메뉴에서 프로젝트 설정``을 열고 ``플러그인 탭으로 가서 플러그인을 활성화 하세요.

../../_images/godot_xr_tools_enable.webp

그런 다음 모든 것이 제대로 활성화되도록 프로젝트를 닫았다가 다시 열어야 합니다.

기초 손 설정

어떻게 동작하는지를 보여드리기 위해 먼저 플레이어의 손 모델을, 몇 가지 표준적인 컴포넌트를 씬에 추가해서 만들어 보겠습니다.

OpenXR에서는 핸드 트래킹을 지원하지만 서로 다른 XR 런타임간에 큰 능력 차이가 존재합니다.

이에 대한 대안으로 Godot XR 도구는 몇 개의 리깅된 손 씬을 제공하며, 이는 여러분 컨트롤러의 트리거와 그립 입력에 반응합니다. 로우 폴리곤과 하이 폴리곤 버전이 있고, 몇 가지 구성과 손가락 위치를 제어하는 애니메이션 파일, 그리고 텍스처를 제공합니다.

씬 트리에서 왼손의 XRController3D 노드를 선택하세요. 자식 씬 인스턴스화 버튼을 눌러서 자식 씬으로 addons/godot-xr-tools/hands/scenes/lowpoly/left_hand_low.tscn 를 추가하세요.

씬 경로에서 볼 수 있듯이 로우 폴리곤 모델은 lowpoly 폴더에 있고 하이 폴리곤 모델은 highpoly 폴더에 있습니다. 모바일 장치로 게임을 출시할 예정이면 로우 폴리곤 버전을 사용하는 것이 좋습니다.

우리가 선택한 디폴트 손은 그냥 손입니다. 다른 옵션으로는:

  • tac_glove - 손가락이 노출된 장갑을 낀 손

  • full_glove - 손 전체를 덮는 장갑을 낀 손

마지막으로 각 손 모델에는 physics 버전이 존재합니다. 이 모델은 모든 뼈(bone)에 접근이 가능합니다. 사용 방법에 대해서는 다른 튜토리얼에서 살펴보도록 하겠습니다.

오른손에 대해서도 같은 작업을 반복합니다.

../../_images/xr_tools_basic_hands.webp

추가 정보

다음 몇 장에 걸쳐서 Godot XR 도구를 사용해서 튜토리얼 프로젝트에 기능들을 추가해 볼 것입니다. 툴킷에 대한 세부 정보는 `툴킷의 도움 페이지<https://godotvr.github.io/godot-xr-tools/>`_ 에서 보실 수 있습니다.