在 2026 年 8 月,我們修正了一個問題:依 XUID 重設玩家資料時會發生權限錯誤 (HTTP 401),即使帳戶已獲授與正確的 Partner Center 權限也是如此。此修正是在 XBOX 服務後端進行,因此會自動套用。您不需要安裝新版的 GDK、XBOX 服務工具套件或此工具本身。如果您先前遇到此錯誤並採取了因應措施,或曾被告知您的 Partner Center 權限設定不正確,可以依照下列步驟重試此工具。依 XUID 重設中所述的 “Tools Access” 權限仍為必要。
--xuid、--user 與 --file 選項彼此互斥。請連同 --scid 與 --sandbox,只指定其中一個選項。
依 XUID 重設
若要使用玩家資料重設工具依 XUID 重設使用者,用於登入(透過 XblDevAccount.exe)的開發者帳戶必須具備特定產品的適當權限。請注意,“Tools Access” 不是帳戶層級的權限,而是產品層級的權限。因此,您必須為每一個要重設玩家資料的產品逐一授與 “Tools Access” 權限。- 使用具有系統管理權限的開發者帳戶登入 Partner Center。
- 瀏覽至帳戶設定 => 使用者頁面。
- 按一下需要 “Tools Access” 權限的使用者或群組。
- 如果該使用者或群組目前被指派為標準角色(例如 Developer),您需要切換至 “Customize permissions”。
- 在下一頁,移至 “Product-level” 權限表格,展開 “XBOX Live” 表格標頭,並找到 “Tools access” 欄。
- 針對您要授與 “Tools Access” 權限的產品或產品群組,明確勾選該核取方塊。
依電子郵件地址重設
若要依測試帳戶電子郵件地址重設,您需要知道每個測試帳戶的密碼。請使用下列命令,系統會快顯視窗讓您以測試使用者身分登入:依檔案重設
若要依檔案重設,您可以傳遞下列檔案的位置:XUID 分隔檔、電子郵件分隔檔,或 Partner Center 帳戶匯出檔。@ 字元,整個檔案會被視為電子郵件地址清單;否則會被視為 XUID 清單。分隔檔中請勿包含標頭列,因為它會被剖析為一個帳戶。
Partner Center 帳戶匯出檔會自動偵測,但僅在原始標頭列存在且未經修改時才會偵測:
分隔符號選項
您可以選擇性地為--xuid 與 --user 選項,以及傳遞給 --file 的分隔檔,設定自訂分隔符號。預設分隔符號為逗號 (,)。
--file 的檔案是 Partner Center 帳戶匯出檔時,分隔符號會被忽略,因為該格式一律以逗號分隔。
帳戶的處理方式
帳戶的處理方式取決於您使用的選項。 當您依 XUID 重設,或從解析為 XUID 的檔案重設時,帳戶會以最多 10 個為一批進行處理。同一批次內的帳戶會平行重設,各批次則依序執行。 當您依電子郵件地址重設時,帳戶會逐一處理,因為每個帳戶都必須個別登入。如果任何測試帳戶登入失敗,工具會立即停止,且不會嘗試清單中其餘的帳戶。 每個帳戶在回報為失敗之前,會自動重試最多五次,且工具會等候服務完成每次重設後才繼續。因此,單一帳戶可能需要最多約一分鐘才會回報最終結果。請讓工具執行完畢,而不要取消它,尤其是在重設大量清單時。輸出
無論命令成功或失敗,您都會看到類似下列的輸出。 成功結束代碼
工具成功時傳回 0,失敗時傳回 -1。從指令碼或自動化測試流程呼叫此工具時,請檢查結束代碼,而不要依賴主控台文字。疑難排解
無法向 XBOX Live 授權帳戶
您的帳戶沒有執行此作業的存取權
依 XUID 重設需要已登入的 Partner Center 帳戶
XblDevAccount.exe signin。
無法登入測試帳戶
--sandbox 的沙箱。發生此情況時工具會停止,因此清單中其餘的帳戶不會被重設。