메인 콘텐츠로 건너뛰기
릴리스 날짜: 2026년 9월 10일 XBOX Godot NetRumble은 Microsoft GDK, XBOX services 및 PlayFab이 실행 중인 하나의 타이틀에서 함께 작동하는 모습을 보여 주는 완전하고 플레이 가능한 Godot 4 멀티플레이어 게임입니다. XBOX Godot 샘플이 애드온과 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 - 하위 모듈과 함께 복제하고 tools\sync_addons.ps1을 실행한 다음 tools\deploy-pc.ps1 -Launch를 실행합니다.
  • XBOX Godot 샘플: XBOX Godot 샘플 - NetRumble의 기반이 되는 GDK 및 PlayFab 애드온으로, 하위 모듈로 고정되어 있습니다.

관련 항목

마지막 수정일 2026년 10월 6일