Skip to main content
發行日期:2026 年 9 月 10 日 XBOX Godot NetRumble 是一款完整、可遊玩的 Godot 4 多人遊戲,展示 Microsoft GDK、XBOX services 和 PlayFab 如何在一個執行中的遊戲裡協同運作。XBOX Godot 範例提供附加元件和各 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 - 連同子模組一起複製,執行 tools\sync_addons.ps1,然後執行 tools\deploy-pc.ps1 -Launch。
  • XBOX Godot 範例: XBOX Godot 範例 - NetRumble 所依據的 GDK 和 PlayFab 附加元件,以子模組形式固定版本。

相關主題

Last modified on October 6, 2026