Skip to main content
이 문서는 Microsoft Game Development Kit(GDK)로 PC용 XBOX 게임을 빌드하기 위해 Godot 사용을 시작하는 방법을 설명합니다. GDK, XBOX 서비스, PlayFab을 Godot 프로젝트에 통합하는 방법을 보여주는 XBOX Godot 샘플을 안내하고, Godot 게임을 XBOX Series X|S나 XBOX One에 출시하기 위한 안내를 어디서 찾을 수 있는지 설명합니다. Godot은 GDK와 함께 사용할 수 있는 여러 엔진 중 하나입니다. 엔진 선택지와 각 엔진에 GDK가 어떻게 들어맞는지에 대한 개요는 Microsoft Game Development Kit 및 게임 엔진을 참조하세요.

XBOX Godot 샘플

XBOX Godot 샘플은 GitHub의 공개된 소스 전용 레퍼런스입니다. 이는 개발자가 Microsoft GDK, XBOX 서비스, PlayFab을 통합하는 Godot 확장을 어떻게 만들 수 있는지 보여주는 실제 예시이며, 이미 익숙한 엔진을 벗어나지 않고도 PC용 XBOX 타이틀을 빌드할 수 있게 해줍니다. 이 샘플은 Microsoft GDK와 PlayFab SDK를 함께 또는 각각 통합하는 방법을 포함해 모듈러 레퍼런스를 제공합니다.
v0.2.0 및 v0.3.0 릴리스는 PlayFab Party 채팅 인디케이터, 음성 컨트롤, 텍스트-음성 변환, 네트워크 진단을 추가하고, XUser API 래퍼를 완성하며, Godot .NET(C#) 지원을 추가하고, GDK 및 Godot 버전 호환성을 확장하며, GDK API 레퍼런스 커버리지를 100%로 확장합니다. 또한 커뮤니티가 보고한 수정 사항이 함께 포함됩니다. 이 릴리스에 대한 자세한 내용은 릴리스 노트를 참조하세요.
v0.3.0에는 호환성이 깨지는 변경 사항이 포함됩니다. GDK 애드온의 모든 스크립트 노출 타입이 이름이 변경되었습니다. 예를 들어 GDKUser는 이제 XboxUser이며, C# 네임스페이스 GodotGdk는 이제 GodotXbox입니다. 더 이상 사용되지 않는(deprecated) 별칭이 제공되지 않으므로, 기존 프로젝트는 타입 참조를 업데이트해야 로드됩니다. 엔진 싱글톤 이름은 여전히 GDK이므로 GDK.initialize()와 같은 호출은 영향을 받지 않습니다. 샘플에는 대부분의 변경을 자동화하는 코드모드가 포함되어 있습니다. 자세한 내용은 Breaking change: GDK addon type rename을 참조하세요.

포함된 내용

XBOX Godot 샘플은 Godot 게임 개발자가 PC용 XBOX를 빌드하는 데 필요한 상당 부분을 다루며, 다음의 핵심 기능을 보여줍니다.
  • Microsoft GDK 플랫폼 서비스
  • XBOX 서비스
  • PlayFab Core + Services
  • PlayFab Multiplayer (Lobby, Matchmaking, Party)
  • PlayFab Game Saves
  • GameInput (Godot의 Input / InputMap로의 브리징 포함)
v0.2.0부터 이 샘플은 GDScript에 더해 관리형 C# 트랙을 통해 Godot .NET(C#) 프로젝트도 지원합니다. XBOX 서비스에서 GameInput까지, 이 샘플은 Godot로 로그인, 게임패드 컨트롤러 지원 기능 등을 게임에 어떻게 도입하는지 보여줍니다. 인사이트와 재사용 가능한 통합 코드를 포함하며, 다양한 GDK 에디션과 Godot 버전을 기본 지원합니다. 각 릴리스에서 검증된 구체적인 에디션과 버전은 릴리스 노트를 참조하세요.

이것이 무엇이고 무엇이 아닌지

  • 이는 소스 전용 샘플이며 제품이 아닙니다. 래퍼 계층은 MIT 라이선스를 따르며, GDK와 PlayFab 종속성은 다른 XBOX 샘플과 마찬가지로 여전히 자체 설치와 라이선스 수락이 필요합니다.
  • 지원 또는 유지 관리에 대한 정해진 업데이트 주기가 없습니다. 리포지토리를 관찰하고 이슈를 모니터링하며 필요할 때 반복 개선하겠지만, 이는 상업 릴리스가 아닙니다. 그럼에도 여러분의 피드백과 커뮤니티의 PR을 함께 발전시키는 과정으로 기꺼이 받고자 합니다.
  • 이것은 PC용 XBOX에 Godot를 도입하는 첫 걸음입니다. 앞으로 커뮤니티가 가장 가치 있다고 알려주는 방향에 따라 발전시켜 나갈 계획입니다.
  • 이 샘플은 PC용 XBOX 전용으로 제작되었습니다. XBOX Series X|S나 XBOX One 지원은 포함되지 않습니다. 콘솔 지원에 대한 정보는 아래 XBOX Series X|S 및 XBOX One 지원 섹션을 참조하세요.

시작하기

리포지토리를 클론하고, 확장을 빌드하고, Godot 프로젝트에 통합을 시작하려면 다음 리소스를 사용하세요.
  • XBOX Godot Sample: XBOX Godot Sample - Microsoft GDK, PlayFab, GameInput을 Godot에 바인딩하는 예시 구현.
  • Microsoft GDK: microsoft/GDK - Microsoft 공개 GDK.
  • PlayFab SDK: PlayFab Unified SDK - PlayFab 통합 SDK.
  • GameInput: GameInput - 다양한 입력 디바이스를 단일 일관 인터페이스로 노출하는 차세대 입력 API.
  • 문서: XBOX Godot Docs - Godot XBOX 샘플에 대한 문서.
  • 이슈: XBOX Godot Issues - 버그 신고, 기능 요청 또는 기여.
Microsoft GDK를 Godot 프로젝트에 통합한 후에는 PC 엔드투엔드 가이드의 나머지를 따라 타이틀을 등록하고, Partner Center에서 제품을 설정하고, 게임을 Microsoft Store에 게시하세요.

릴리스 노트

XBOX Godot 샘플은 커뮤니티 피드백에 따라 시간이 지나며 발전합니다. 릴리스별 노트는 각 버전의 새 기능, 개선 사항, 수정 사항을 설명하며, 해당 릴리스에 대해 검증된 GDK 에디션과 Godot 버전도 함께 안내합니다. 릴리스와 다운로드의 전체 이력은 GitHub의 XBOX Godot sample releases를 참조하세요.

XBOX Series X|S 및 XBOX One 지원

XBOX Godot 샘플은 PC용 XBOX 전용으로 제작되었으며 XBOX Series X|S 또는 XBOX One 지원은 포함되지 않습니다. Godot는 오픈 소스이며 MIT 라이선스를 따르기 때문에 Godot Foundation은 콘솔 익스포트 템플릿을 공식적으로 유지 관리하지 않습니다. 콘솔 SDK는 NDA 하에 배포되며 엔진의 개방형 개발 모델과 양립하지 않는 법적 계약과 폐쇄된 접근을 필요로 합니다. 콘솔 포팅 프로세스, 미들웨어 제공업체 목록, 추가 Godot Foundation 안내에 대한 최신 정보는 공식 Godot Engine 웹사이트의 Godot and console porting를 참조하세요. 이미 XBOX Series X|S 또는 XBOX One용으로 빌드하고 있다면 담당 XBOX 대표에게 문의하세요. 아직 등록되지 않았다면 시작하려면 ID@XBOX 프로그램 등록을 참조하세요.

관련 항목

마지막 수정일 2026년 8월 24일