> ## 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 版本

> XBOX Godot NetRumble v0.1.0 的版本資訊，這是一個 Godot 4 多人遊戲範例，在單一遊戲中同時執行 Microsoft GDK、XBOX services 和 PlayFab。

***發行日期：2026 年 9 月 10 日***

[XBOX Godot NetRumble](https://github.com/microsoft/xbox-godot-netrumble) 是一款完整、可遊玩的 Godot 4 多人遊戲，展示 Microsoft GDK、XBOX services 和 PlayFab 如何在一個執行中的遊戲裡協同運作。[XBOX Godot 範例](https://aka.ms/XBOXGodotSample)提供附加元件和各 API 的範例，而 NetRumble 則向您展示可以用它們建置什麼。本文摘要說明初始的 **v0.1.0** 版本。

這款遊戲是一個小型競技場射擊遊戲，而且刻意設計為最不重要的部分。它的存在是為了提供真實的工作階段、真實的玩家名單和真實的對戰事件，讓平台整合能據以運作。

## 實用之處

* **一個完整遊戲，而非零散的程式碼片段。** 登入、工作階段探索、網路、語音、隱私權、內容管理、成就和存檔，都串接在一個您可以從頭到尾執行的遊戲中，讓您能看到各 API 範例所省略的呼叫順序、失敗處理和生命週期處理。
* **保持道地 Godot 風格的多人遊戲。** PlayFab Party 被包裝成可直接替換的 Godot `MultiplayerPeer`，因此範例中的每個 `@rpc` 都是一般的 Godot RPC。只有 peer 的建構是 PlayFab 專屬的，讓您現有的網路程式碼保持不變。
* **在認證上搶得先機。** 範例包含權限檢查、個別玩家靜音、封鎖和避開的強制執行、使用者撰寫內容發佈前的文字驗證，以及玩家檢舉，並提供一個頁面將每項 XBOX Requirement 對應至實作它的程式碼。
* **同一個專案支援 PC 和主機。** 同一個專案以 PC 版 XBOX 和 XBOX Series X|S 為目標，包括暫停、繼續和受限處理，以及主機上的個別使用者 Game Save。
* **可直接複製的邊界。** 每個平台呼叫都位於單一服務外觀 (facade) 之後，每個關注點一個檔案，因此您可以直接取出所需的部分，而不必將其從遊戲邏輯中拆解出來。

## 示範內容

* 將 GDK 登入交換為 PlayFab 身分識別，並提供專用的進度畫面和離線後援。
* 使用 PlayFab Lobby 進行加入代碼工作階段探索，以及可加入的好友、活動發佈和從指南加入的邀請。
* PlayFab Party 語音和對戰中的輸入文字，並分別強制執行靜音和文字隱私權。
* 多人遊戲和通訊權限檢查，以及靜音、封鎖和避開的隱私權強制執行。
* 由對戰事件驅動的一次性和累進式成就進度。
* 主機上用於設定檔、歷程記錄和計數器的 Game Save。
* 在提供線上遊戲之前偵測連線能力，並透過 GDK 使用者和裝置 API 進行控制器關聯。

## 需求

* **Godot 4.6 或更新版本。** GDK 附加元件是 GDExtension，因此標準組建即可。
* **Windows**，搭配 Visual Studio 2022 和 Microsoft GDK 版本，用於建置附加元件一次。
* 匯出至 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](/zh-TW/build/gdk-and-engines/godot)
* [XBOX Godot 範例 v0.3.0 版本](/zh-TW/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 NetRumble Sample v0.1.0 Release](/build/gdk-and-engines/godot-release-notes/godot-netrumble-release-notes-0-1-0.md)
- [Use the GDK with Godot](/build/gdk-and-engines/godot.md)
- [XBOX Godot 示例 v0.1.0 发布](/zh-CN/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-1-0.md)
- [XBOX Godot Sample v0.1.0 Release](/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-1-0.md)
- [Versión v0.1.0 de XBOX Godot Sample](/es/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-1-0.md)