jcrt-bga

[jcrt-bga]

遊戲統計設計

stats.json 完整文件在此

會在遊戲結束顯示的統計表，設計好之後，需要在 XXX.game.php 各處紀錄。

[jcrt-bga]

設計狀態變化

states.inc.php 完整文件在此

這個檔案定義遊戲的 state 有限狀態機，會從哪個狀態進到哪個狀態。

建議製作遊戲的第一步，是先完成 states.inc.php。能夠搭配狀態圖會更清楚。

每個狀態下需要定義 type，共有四種：

activeplayer 在這種狀態下，我們期望 active player 執行 action。

multipleactiveplayer 在這種狀態下，我們期望多個玩家（活躍玩家）執行 action。

game 這是一種中間狀態，我們不期望玩家執行任何 action。你的遊戲邏輯必須決定下一個遊戲狀態是什麼。

manager 初始和最終狀態的特殊類型。

狀態除了 type 必填，還有以下選填參數：

name GameState 狀態的名稱，工程師識別用。

description 目前狀態的描述，會在遊戲頂部的動作列顯示。對於 type=game 的狀態無用。

descriptionmyturn 輪到你時目前遊戲狀態的描述。

action 當遊戲進入此狀態時，讓 PHP 呼叫的方法名稱，通常以 st 為前綴命名，如： stPlayerTurn。

possibleactions Array，指定玩家在此狀態中時，可執行的 actions。可呼叫 Javacript：this.checkAction 和 PHP：self::checkAction 來確認。

transitions Array，列出所有可能的下一個遊戲狀態。有列出的狀態才能在 PHP 中呼叫 nextState。

args 讓 Javacript 呼叫的方法名稱。會在 JS onEnteringState 使用、或在遊戲狀態描述中設定參數。

updateGameProgression 設定 true 時，會呼叫 getGameProgression 方法讓遊戲進度更新。