> ## 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 NetRumble 샘플 v0.1.0 릴리스

> Microsoft GDK, XBOX services 및 PlayFab을 하나의 타이틀에서 함께 실행하는 Godot 4 멀티플레이어 샘플인 XBOX Godot NetRumble v0.1.0의 릴리스 정보입니다.

***릴리스 날짜: 2026년 9월 10일***

[XBOX Godot NetRumble](https://github.com/microsoft/xbox-godot-netrumble)은 Microsoft GDK, XBOX services 및 PlayFab이 실행 중인 하나의 타이틀에서 함께 작동하는 모습을 보여 주는 완전하고 플레이 가능한 Godot 4 멀티플레이어 게임입니다. [XBOX Godot 샘플](https://aka.ms/XBOXGodotSample)이 애드온과 API별 예제를 제공한다면, NetRumble은 이를 사용하여 무엇을 빌드할 수 있는지 보여 줍니다. 이 문서에서는 초기 **v0.1.0** 릴리스를 요약합니다.

이 게임은 소규모 아레나 슈팅 게임이며, 의도적으로 가장 덜 흥미로운 부분으로 만들어졌습니다. 이 게임은 플랫폼 통합이 작동할 실제 세션, 실제 플레이어 명단 및 실제 매치 이벤트를 제공하기 위해 존재합니다.

## 유용한 이유

* **분리된 코드 조각이 아닌 하나의 타이틀.** 로그인, 세션 검색, 네트워킹, 음성, 개인 정보, 조정, 업적 및 저장이 처음부터 끝까지 실행할 수 있는 게임에 함께 연결되어 있으므로 API별 예제에서 빠진 호출 순서, 오류 처리 및 수명 주기 작업을 확인할 수 있습니다.
* **Godot 방식을 그대로 유지하는 멀티플레이어.** PlayFab Party는 바로 사용할 수 있는 Godot `MultiplayerPeer`로 래핑되어 있으므로 샘플의 모든 `@rpc`는 일반적인 Godot RPC입니다. 피어 생성 부분만 PlayFab에 특화되어 있으므로 기존 네트워킹 코드를 그대로 유지할 수 있습니다.
* **인증을 위한 빠른 시작.** 샘플에는 권한 확인, 플레이어별 음소거, 차단 및 회피 적용, 사용자 작성 콘텐츠 게시 전 텍스트 확인, 플레이어 신고가 포함되어 있으며, 각 XBOX 요구 사항을 이를 구현하는 코드에 매핑하는 페이지도 제공됩니다.
* **동일한 프로젝트에서 PC 및 콘솔 지원.** 동일한 프로젝트가 일시 중단, 다시 시작 및 제한 처리와 콘솔의 사용자별 Game Save를 포함하여 PC의 XBOX와 XBOX Series X|S를 대상으로 합니다.
* **바로 복사할 수 있는 경계.** 모든 플랫폼 호출은 관심사별로 하나의 파일로 구성된 단일 서비스 파사드 뒤에 있으므로 게임플레이에서 분리하는 수고 없이 필요한 부분만 가져다 사용할 수 있습니다.

## 보여 주는 기능

* 전용 진행률 화면 및 오프라인 대체 기능을 갖춘, PlayFab ID로 교환되는 GDK 로그인.
* PlayFab Lobby를 사용한 참가 코드 세션 검색과 함께 참가 가능한 친구, 활동 게시 및 가이드에서 참가 초대.
* 음소거 및 텍스트 개인 정보가 별도로 적용되는 PlayFab Party 음성 및 매치 내 입력 텍스트.
* 멀티플레이어 및 통신 권한 확인과 음소거, 차단 및 회피에 대한 개인 정보 적용.
* 매치 이벤트에 따른 일회성 및 증분 업적 진행.
* 프로필, 기록 및 카운터를 위한 콘솔의 Game Save.
* 온라인 플레이를 제공하기 전의 연결 감지와 GDK 사용자 및 디바이스 API를 통한 컨트롤러 연결.

## 요구 사항

* **Godot 4.6 이상.** GDK 애드온은 GDExtension이므로 표준 빌드로 충분합니다.
* 애드온을 한 번 빌드하기 위한 Visual Studio 2022 및 Microsoft GDK 에디션이 설치된 **Windows**.
* XBOX Series X|S로 내보내려면 W4 Games 콘솔 포크 버전의 Godot가 추가로 필요합니다.

등록된 PC의 XBOX 경로에는 GDK PC 도구, 권한이 부여된 샌드박스 및 타이틀, 일치하는 테스트 계정도 필요합니다. 리포지토리의 구성 가이드에서 이러한 단계를 순서대로 안내하며 전체 구성 없이 실행되는 항목을 나열합니다.

> \[!NOTE]
> NetRumble은 MIT 라이선스에 따른 소스 전용 참조이며, 인증된 타이틀이나 제품이 아닙니다. GDK 및 PlayFab 종속성은 여전히 자체 설치 및 라이선스 동의가 필요합니다.

## 시작하기

* **XBOX Godot NetRumble:** [microsoft/xbox-godot-netrumble](https://github.com/microsoft/xbox-godot-netrumble) - 하위 모듈과 함께 복제하고 `tools\sync_addons.ps1`을 실행한 다음 `tools\deploy-pc.ps1 -Launch`를 실행합니다.
* **XBOX Godot 샘플:** [XBOX Godot 샘플](https://aka.ms/XBOXGodotSample) - NetRumble의 기반이 되는 GDK 및 PlayFab 애드온으로, 하위 모듈로 고정되어 있습니다.

## 관련 항목

* [Godot 시작하기](/ko/build/gdk-and-engines/godot)
* [XBOX Godot 샘플 v0.3.0 릴리스](/ko/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-3-0)
* [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)
- [Godot와 함께 GDK 사용](/ko/build/gdk-and-engines/godot.md)
- [XBOX Godot Sample v0.2.0 릴리스](/ko/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-2-0.md)
- [XBOX Godot Sample v0.3.0 Release](/ko/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-3-0.md)
- [Multiplayer Manager API 개요](/ko/services/xbox-services/multiplayer/mpm/concepts/live-multiplayer-manager-api-overview.md)