> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XBOX Godot Sample v0.2.0 릴리스

> XBOX for PC용 Godot 게임 빌드를 위한 XBOX Godot 샘플의 v0.2.0 릴리스에서 제공되는 새로운 기능, 개선 사항 및 수정 사항에 대해 설명합니다.

***릴리스 날짜: 2026년 7월 30일***

[XBOX Godot 샘플](https://aka.ms/XBOXGodotSample)은 Microsoft GDK, XBOX 서비스, PlayFab을 통합하는 Godot 확장을 빌드하는 방법을 보여주는 공개 소스 전용 참조 자료로, XBOX for PC용 타이틀을 빌드할 수 있도록 지원합니다. 이 문서는 **v0.2.0 - Community Fixes + Godot .NET Support** 릴리스의 변경 사항을 요약합니다.

전체 커밋 목록은 GitHub의 [v0.2.0 전체 변경 로그](https://github.com/microsoft/XBOX-Godot-Sample/compare/v0.1.0...v0.2.0)를 참조하세요. 릴리스를 받으려면 [GitHub의 v0.2.0](https://github.com/microsoft/XBOX-Godot-Sample/releases/tag/v0.2.0)을 참조하세요.

## 주요 하이라이트

* **Godot .NET(C#) 지원.** 파사드(facade) 애드온, 튜토리얼 샘플, 패리티 게이트가 포함된 관리형 C# 트랙을 통해 Godot .NET 프로젝트에서 GDK와 PlayFab을 통합할 수 있습니다.
* **더 광범위한 GDK 및 Godot 버전 지원.** 샘플은 이제 더 넓은 범위의 GDK 에디션(빌드 타임 셀렉터를 사용하는 2025년 10월 에디션 포함)과 Godot 버전(CI는 이제 새 기본값인 Godot 4.7.1-stable까지 테스트)에서 작동합니다.
* **더 모듈화된 샘플.** 각 통합을 개별적으로 또는 함께 채택할 수 있도록 샘플이 모듈화된 GDK, PlayFab, Integrated 트랙으로 재구성되었습니다.
* **GDK API 참조 100% 커버리지.** text-to-speech, Store 및 Game UI show-UIs, 이벤트, feature probe, Game Save, XSAPI fills, GameChat2를 포함한 전체 GDK API 표면으로 커버리지가 확장되었습니다.
* **커뮤니티 보고 수정 사항.** `MicrosoftGame.config` 초기화 및 GDK 빌드/내보내기 실패를 포함하여 커뮤니티에서 제기한 여러 이슈가 해결되었습니다.

## 주요 변경 사항

### 새 기능

* Godot .NET(C#) 트랙: 관리형 파사드 애드온, 튜토리얼 샘플, 패리티 게이트.
* 토큰 기반 PlayFab 로그인 방식(Steam, OpenID Connect, Battle.net).
* 빌드 타임 셀렉터와 에디션 이식 가능한 활성화를 통한 2025년 10월 GDK 에디션 지원.
* GDK `add_user_with_ui_async` 흐름에서 게스트 로그인이 이제 옵트인 방식으로 변경되었습니다.

### 개선 사항

* Party 채팅 강화와 함께 샘플을 모듈화된 GDK / PlayFab / Integrated 트랙으로 재구성.
* GDK API 참조 커버리지를 100%로 확장.
* `godot_gdk_packaging` 애드온의 이름을 `godot_gdk_editortools`로 변경.
* 버그 신고 이슈 템플릿을 추가하고 README에서 링크했으며, 추가 문서 링크도 함께 제공.

### 수정 사항

* GDK 내보내기 "unexpected error code 47" 실패를 수정.
* `MicrosoftGame.config` 선택기 검사를 편집기에서만 사용하도록 제한.
* GDK/PlayFab async 프레임 콜백 auto-pump을 컴파일하여 포함.
* Godot 4.5.x에서 GDK 내보내기 플랫폼 감지를 수정.
* 누락된 GDExtension DLL에 대한 GDK 내보내기 견고성 강화.
* `setup_sample.ps1`에서 발생하는 샌드박스 명령의 오타를 수정.
* `getting-started.md`에서 `xbox-sandbox-and-test-accounts.md`에 대한 링크 대소문자 구분 문제 수정.

### 엔지니어링 및 CI

* PlayFab Party 및 GDK 요청 파싱 seam이 포함된 libFuzzer 인프라 추가.
* PR 게이트(파싱 매트릭스, 퍼즈 재생) 추가와 함께, 공급망 강화가 적용된 야간 PlayFab 라이브 테스트 추가.
* GDK 에디션별로 애드온을 한 번씩 빌드하며, Godot 버전 전반에 걸쳐 캐싱 및 테스트를 수행.

## 관련 항목

* [Godot 시작하기](/build/gdk-and-engines/godot)
* [XBOX Godot 샘플 릴리스](https://github.com/microsoft/XBOX-Godot-Sample/releases)


## Related topics

- [XBOX Godot Sample v0.1.0 릴리스](/ko/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-1-0.md)
- [XBOX Godot Sample v0.3.0 Release](/ko/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-3-0.md)
- [Godot와 함께 GDK 사용](/ko/build/gdk-and-engines/godot.md)
- [릴리스 정보](/ko/tools/tools-pc/xbox-pc-remote-tools/release-notes/index.md)
- [사전 릴리스 테스트 옵션](/ko/publishing/game-publishing/publishing-processes/managed-creators/publishing-processes-prerelease.md)