SandboxScripts

以下是您可以從 Sandbox 腳本中調用的函數參考。

BGA 沙箱腳本是用 Javascript 編寫的。

使用Javascript，您可以編寫腳本來讓您的沙盒遊戲具有更多的自動化規則。

重要：與 Javascript 最常見的用法相反，沙盒腳本在伺服器端執行。

為了與您的 BGA Sandbox 遊戲交互，我們為您提供了一個 API。

使用此 API，您可以從當前遊戲情況中獲取遊戲元素的屬性值、修改它們和/或觸發遊戲行動（例如：移動配件、翻卡等）。

從 Sandbox 編輯器的「界面視圖【interface view】」選項卡中，選擇一個元素，並訪問其屬性（右上角的圖標）。

轉到「腳本（高級）【Scripts (advanced)】」部分。

在「單擊此元素時【When this element is clicked】」前面，輸入「onMyClick」。

關閉窗口。轉到「script view」選項卡。

輸入以下內容：

function onMyClick( element_id )
{
   bga.log("Hello world! You just clicked on element " + element_id + ". Congrats!");
}

保存並發佈您的項目，開始測試會話，點擊前一個元素：您的消息會出現在右側的日誌中！

您不必為腳本的每次修改都執行保存並發佈：每次保存腳本（control+S）時，用於所有測試會話的腳本都會更新。請注意，BGA 上的生產版本當然不會更新，直到您再次明確保存和發佈您的項目。
要檢查變量的內容，您可以將bga.log()與JSON.stringify()結合使用。例如：

 bga.log( JSON.stringify( bga.getPlayers()) );

除了log() 之外，您還可以使用 bga.exit( "my message" ) 來調試腳本。使用 bga.exit，腳本會立即停止執行，並且所有以前的遊戲更改都會被取消，因此嘗試重試作直到腳本正常。

在Board Game Arena 上，玩家們期待可以自動執行所有規則的遊戲。因此，即使從技術上講可以只編寫一部分腳本也能暢玩遊戲，但是在大多數情況下，我們也會只發佈完全腳本化的遊戲:)

目次