This is a documentation for Board Game Arena: play board games online !

Main game logic: yourgamename.game.php

От Board Game Arena
Версия от 11:14, 5 януари 2013 на Sourisdudesert (беседа | приноси) (Created page with "=== Table class (<gamename>.game.php) === ; function _( $text ) : Transparent function, used to mark strings to be translated on the server side (ex: error message) ; functio...")
(разл) ← По-стара версия | Текуща версия (разл) | По-нова версия → (разл)
Направо към навигацията Направо към търсенето

Table class (<gamename>.game.php)

function _( $text )
Transparent function, used to mark strings to be translated on the server side (ex: error message)
function clienttranslate( $string )
Transparent function: used to mark string to be translated on client side (ex: notification message)
function getPlayersNumber()
Returns the number of players playing at the table
function checkAction( $actionName, $bThrowException=true )
Check if action is valid regarding current game state (exception if fails)
if "bThrowException" is set to "false", the function return false in case of failure instead of throwing and exception
function getActivePlayerId()
Get the "active_player", whatever what is the current state type
Note: it does NOT mean that this player is active right now, because state type could be "game" or "multiplayer"
function getActivePlayerName()
Get the "active_player" name
function getCurrentPlayerId()
Get the "current_player". The current player is the one from which the action originated. It is not always the active player.
function getCurrentPlayerName()
Get the "current_player" name
function getCurrentPlayerColor()
Get the "current_player" color
function isCurrentPlayerZombie()
Check the "current_player" zombie status
function activeNextPlayer()
Make the next player active
function activePrevPlayer()
Make the previous player active
function giveExtraTime( $player_id, $specific_time=null )
Give standard extra time to this player (standard extra time is a game option)
function initStat( $table_or_player, $name, $value, $player_id=null )
Create a statistic entry for the specified statistics with a default value
In case of a "player" entry, if player_id is not specified, all players are set to the same value
function setStat( $value, $name, $player_id = null )
Set statistic value
function incStat( $delta, $name, $player_id = null )
Increment (or decrement) specified value
function DbQuery( $sql )
Executes sql query on the database
function getCollectionFromDB( $sql, $bSingleValue=false )
Returns an associative array of rows for the sql query. First column must be a primary or alternate key. The resulting collection can be empty.
protected function getNonEmptyCollectionFromDB( $sql )
Idem, but raise an exception if the collection is empty
function getUniqueValueFromDB( $sql )
Returns a unique value from DB or null if no value is found
Raise an exception if more than 1 row is returned
function getObjectFromDB( $sql )
Returns one row for the sql query as an associative array or null if there is no result
Raise an exception if the query return more than one row
function getNonEmptyObjectFromDB( $sql )
Idem, but raise an exception if the query doesn't return exactly one row