This document is about: QUANTUM 3
SWITCH TO

Overview

概述

自訂外掛程式 SDK 讓開發者能夠創建一個自訂的 Quantum 伺服器,在本機測試並上傳至 Photon 企業雲端。

創建 Photon 企業雲端會產生額外費用。如需更多資訊及外掛程式 SDK 的下載權限,請聯繫我們。

自訂 Quantum 外掛程式的常見功能包括:

  • 在 Photon 伺服器雲端上運行模擬,以獲得可信的遊戲結果
  • 向延遲加入或重新連接的客戶端發送伺服器快照

本機 Photon 伺服器僅支援在 Windows 上啟動。

下載

Quantum 3.1 預覽版本:

更新日誌

3.0.3

版本 55 (2025年4月28日)

  • 新增了一個 Powershell 指令碼用於升級外掛程式 SDK
  • 新增WebHookBaseUrlAllowList儀表板和RoomProperties.WebHookBaseUrl,以支援用戶使用伺服器上的鍵值允許列表選擇 Webhook URL
  • 新增自訂 Webhook 超時參數和可自訂的預設 Webhook 超時時間,使用儀表板鍵WebHookDefaultTimeout(單位:毫秒)
  • 將本機 Photon 伺服器升級至版本6.0.14.33515

3.0.2

版本 50 (2025年3月3日)

  • 客戶端引起的輸入反序列化錯誤現在會被忽略,設定ClientInputExceptionTolerance(預設為 2)以定義在斷開客戶端連接前忽略的錯誤數量
  • 在雲端運行的自訂外掛程式現在使用更高效的原生記憶體分配器
  • 將排程的外掛程式纖維計時器替換為增量計時器,從更新結束時開始,有助於提升伺服器穩定性
  • 修復了一個問題,該問題導致在 Webhook 中選擇-1(無限制)時無法正確設定MaxPlayerSlots
  • 大廳限制現在更寬鬆,最大數量從3調整為20,最大字串長度從64調整為128,違規現在會導致遊戲創建失敗,而非靜默地移除屬性
  • 新增了從PlayerRef到客戶端物件的映射,使用DeterministicServer.GetClientForPlayer(PlayerRef)

3.0.1

版本 49 (2024年12月13日)

  • 修復了一個問題,該問題可能導致外掛程式在替換斷開連接的客戶端時缺少斷開信號
  • 修復了一個問題,該問題會導致快速重新連接的客戶端在遊戲階段開始前被斷開
  • CreateJoin Webhook 中移除ActorNr屬性,因為此時 ID 尚未知曉

版本 39 (2024年12月2日)

  • 為所有與玩家相關的 Webhook 新增了ActorNrAuthCookie屬性
  • CreateGameResponse Webhook 中新增了UserData
  • LeaveGameRequest Webhook 中新增了IsInactive
  • DeterministicServer類別中新增了DeterministicPluginClient物件的Getter
  • 在 CreateGame Webhook 回應中新增了RunServerSimulation標誌,以控制特定遊戲的伺服器模擬運行
  • 新增了一個示範專案,展示如何攔截和重寫命令
  • 更改了伺服器模擬包裝器DotNetSessionRunner,並將職責移至另一個由DotNetSessionContext實現的介面,該介面負責讓資源管理器或命令序列化,可供不運行模擬的自訂外掛程式使用
  • DeterministicServer.ServerSimulation更名為SessionRunner
  • 棄用了DeterministicServer.ClientCount屬性
  • 修復了一個問題,該問題導致在使用 RoomTTL 的單一客戶端線上遊戲重新連接後停滯
  • 修復了一個與伺服器快照相關的問題,該問題會導致斷開連接並顯示Error #13: Snapshot request failed to start

3.0.0

版本 44 (2024年12月9日)

  • 修復了一個問題,該問題可能導致外掛程式在替換斷開連接的客戶端時缺少斷開信號

版本 38 (2024年10月16日)

  • 修復了一個問題,該問題導致伺服器命令翻轉斷開連接玩家的玩家連接標誌,從而產生不需要的 PlayerConnected 信號

版本 37 (2024年10月1日)

  • 修復了一個問題,該問題導致 GZip 壓縮的重播塊比必要的大小更大

版本 28 (2024年7月16日)

  • 修復了一個缺少依賴項的問題

版本 26 (2024年6月19日)

  • 移除了啟動 Windows 性能計數器,將被新功能替代

版本 24 (2024年6月11日)

  • 新增了DeterministicServer.OnDeterministicSessionCanStart回調,以在外掛程式上延遲遊戲階段啟動

版本 21 (2024年6月4日)

  • 初始版本
Back to top