Main game logic: yourgamename.game.php - Гісторыя версій

Een: /* Language dependent games API */ fix typo + add Belarusian to languages

2020-10-27T12:24:59Z

Language dependent games API: fix typo + add Belarusian to languages

← Папярэдн. версія		Версія ад 12:24, 27 кастрычніка 2020
Радок 913:		Радок 913:
	'language_dependecy' => array( 1 => 'en', 2 => 'fr', 3 => 'it' ), //1-based list of supported languages		'language_dependecy' => array( 1 => 'en', 2 => 'fr', 3 => 'it' ), //1-based list of supported languages

	In ~~tge~~ gamename.game.~~oho~~ file, you can get the id of selected language with the method '''getGameLanguage'''.		In the gamename.game.php file, you can get the id of selected language with the method '''getGameLanguage'''.
	; function getGameLanguage()		; function getGameLanguage()
	: Returns an index of the selected language as defined in gameinfos.inc.php.		: Returns an index of the selected language as defined in gameinfos.inc.php.
Радок 919:		Радок 919:
	Languages currently available on BGA are:		Languages currently available on BGA are:
	'ar' => array( 'name' => "العربية", 'code' => 'ar_AE' ), // arabic		'ar' => array( 'name' => "العربية", 'code' => 'ar_AE' ), // arabic
			'be' => array( 'name' => "беларуская мова", 'code' => 'be_BY' ), // Belarusian
	'bn' => array( 'name' => "বাংলা", 'code' => 'bn_BD' ), // bengali		'bn' => array( 'name' => "বাংলা", 'code' => 'bn_BD' ), // bengali
	'bg' => array( 'name' => "български език", 'code' => 'bg_BG' ), // bulgarian		'bg' => array( 'name' => "български език", 'code' => 'bg_BG' ), // bulgarian

Joezg на 12:19, 27 кастрычніка 2020

2020-10-27T12:19:27Z

@@ Радок 899: / Радок 899: @@
 ; function removeLegacyTeamData()
 : Same as removeLegacyData, except that it retrieves some data for the whole team within the current table (set by storeLegacyTeamData)
 == Debugging and Tracing ==

PurplishCat на 23:30, 24 кастрычніка 2020

2020-10-24T23:30:17Z

← Папярэдн. версія		Версія ад 23:30, 24 кастрычніка 2020
Радок 10:		Радок 10:

	* Constructor: where you define global variables.		* Constructor: where you define global variables.
	* setupNewGame: initial setup of the game.		* setupNewGame: initial setup of the game. Takes an array of players, indexed by player_id. Structure of each player is...?
	* getAllDatas: where you retrieve all game data during a complete reload of the game.		* getAllDatas: where you retrieve all game data during a complete reload of the game.
	* getGameProgression: where you compute the game progression indicator.		* getGameProgression: where you compute the game progression indicator.

PurplishCat: /* Accessing the database */

2020-10-05T15:44:18Z

Accessing the database

← Папярэдн. версія		Версія ад 15:44, 5 кастрычніка 2020
Радок 80:		Радок 80:
	'''IMPORTANT'''		'''IMPORTANT'''

	BGA uses [http://dev.mysql.com/doc/refman/5.0/en/sql-syntax-transactions.html database transactions]. This means that your database changes WON'T BE APPLIED to the database until your request ends normally. Using transactions is in fact very useful for you; at any time, if your game logic detects that something is wrong (example: a disallowed move), you just have to throw an exception and all changes to the game situation will be removed.		BGA uses [http://dev.mysql.com/doc/refman/5.0/en/sql-syntax-transactions.html database transactions]. This means that your database changes WON'T BE APPLIED to the database until your request ends normally (web request, not database request). Using transactions is in fact very useful for you; at any time, if your game logic detects that something is wrong (example: a disallowed move), you just have to throw an exception and all changes to the game situation will be removed. This also means that you need not (and in fact cannot) use your own transactions for multiple related database operations.

	; DbQuery( $sql )		; DbQuery( $sql )

Victoria La: /* States functions */

2020-10-03T18:02:56Z

States functions

← Папярэдн. версія		Версія ад 18:02, 3 кастрычніка 2020
Радок 365:		Радок 365:
	: This is used specifically in certain game states when you want to authorize additional actions for players that are not active at the moment.		: This is used specifically in certain game states when you want to authorize additional actions for players that are not active at the moment.
	: Example: in ''Libertalia'', you want to authorize players to change their mind about the card played. They are of course not active at the time they change their mind, so you cannot use "checkAction"; use "checkPossibleAction" instead.		: Example: in ''Libertalia'', you want to authorize players to change their mind about the card played. They are of course not active at the time they change their mind, so you cannot use "checkAction"; use "checkPossibleAction" instead.

			This is how PHP action looks that returns player to active state (only for multiplayeractive states). To be able to execute on js side do not checkAction on js side for this specific one.

			function actionUnpass() {
			$this->gamestate->checkPossibleAction('actionUnpass'); // player chane mind about passing while others were thinking
			$this->gamestate->setPlayersMultiactive(array ($this->getCurrentPlayerId() ), 'error', false);
			}

	; $this->gamestate->state()		; $this->gamestate->state()

Een: /* Semi-coop */

2020-09-24T09:52:17Z

Semi-coop

← Папярэдн. версія		Версія ад 09:52, 24 верасня 2020
Радок 609:		Радок 609:
	=== Semi-coop ===		=== Semi-coop ===

	If the game is not full-coop, then everyone ~~lose~~ = everyone is ~~tie~~. I.e. set score to 0 to everybody.		If the game is not full-coop, then everyone loses = everyone is tied. I.e. set score to 0 to everybody.

	=== Only "winners" and "losers" ===		=== Only "winners" and "losers" ===

Een: /* Co-operative game */ improve description

2020-09-24T09:50:51Z

Co-operative game: improve description

← Папярэдн. версія		Версія ад 09:50, 24 верасня 2020
Радок 599:		Радок 599:
	=== Co-operative game ===		=== Co-operative game ===

	To make everyone lose in full-coop game:		To make everyone win/lose together in a full-coop game:

	Add the following in gameinfos.inc.php :		Add the following in gameinfos.inc.php :
	'is_coop' => 1, // full cooperative		'is_coop' => 1, // full cooperative

	~~And~~ score zero to everyone.		Assign a score of zero to everyone if it's a loss.
			Assign the same score > 0 to everyone if it's a win.

	=== Semi-coop ===		=== Semi-coop ===

Een: /* Solo */ zero

2020-09-24T09:45:50Z

Solo: zero

← Папярэдн. версія		Версія ад 09:45, 24 верасня 2020
Радок 643:		Радок 643:
	=== Solo ===		=== Solo ===

	If game supports solo variant, a negative score means defeat, a positive score means victory.		If game supports solo variant, a negative or zero score means defeat, a positive score means victory.

	=== Player elimination ===		=== Player elimination ===

LaszloK: /* Game statistics */ clarify so others don't make my mistake :)

2020-09-22T12:47:14Z

Game statistics: clarify so others don't make my mistake :)

← Папярэдн. версія		Версія ад 12:47, 22 верасня 2020
Радок 518:		Радок 518:
	There are 2 types of statistics:		There are 2 types of statistics:
	* a "player" statistic is a statistic associated to a player		* a "player" statistic is a statistic associated to a player
	* a "table" ~~statistics~~ is a statistic not associated to a player (global statistic for this game).		* a "table" statistic is a statistic not associated to a player (global statistic for this game).

	See [[Game statistics: stats.inc.php]] to see how you ~~defines~~ statistics for your game.		See [[Game statistics: stats.inc.php]] to see how you define statistics for your game.


	'''initStat( $table_or_player, $name, $value, $player_id = null )'''		'''initStat( $table_or_player, $name, $value, $player_id = null )'''

	Create a statistic entry with a default value.		Create a statistic entry with a default value.
	~~This method must be called for each statistics of your game, in your setupNewGame method~~.

	~~'$table_or_player'~~ must be ~~set~~ to ~~"table" if~~ this is a ~~table statistics~~, or ~~"player"~~ if ~~this is a player~~ statistics.		This method must be called for each statistic of your game, in your setupNewGame method.
			If you neglect to call this for a statistic, and also do not update the value during the course of a certain game using setStat or incStat, the value of the stat will be undefined rather than 0. This will result in it being ignored at the end of the game, as if it didn't apply to that particular game, and excluded from cumulative statistics.

	~~'$name' is the name of your statistics, as it has been defined in your stats.inc.php file.~~

	'$value' is the initial value of the ~~statistics~~. If this is a player ~~statistics~~ and if the player is not specified by "$player_id" argument, the value is set for ALL players.		'$table_or_player' must be set to "table" if this is a table statistic, or "player" if this is a player statistic.

			'$name' is the name of your statistic, as it has been defined in your stats.inc.php file.

			'$value' is the initial value of the statistic. If this is a player statistic and if the player is not specified by "$player_id" argument, the value is set for ALL players.

PurplishCat: Grammar

2020-09-10T03:31:43Z

Grammar

← Папярэдн. версія		Версія ад 03:31, 10 верасня 2020
Радок 491:		Радок 491:
	Here's are a list of techniques you should use in these situations, from the best to the worst.		Here's are a list of techniques you should use in these situations, from the best to the worst.

	=== ~~Dices~~ and bga_rand ===		=== Dice and bga_rand ===

	'''bga_rand( min, max )'''		'''bga_rand( min, max )'''
	This is a BGA framework function that provides you a random number between "min" and "max" (~~included~~), using the best available random method available on the system.		This is a BGA framework function that provides you a random number between "min" and "max" (inclusive), using the best available random method available on the system.

	This is the preferred function you should use, because we are updating it when a better method is introduced.		This is the preferred function you should use, because we are updating it when a better method is introduced.

	At now, bga_rand is based on the PHP function "random_int", which ~~ensure~~ a cryptographic level of randomness.		As of now, bga_rand is based on the PHP function "random_int", which ensures a cryptographic level of randomness.

	In particular, it is '''mandatory''' to use it for all '''dice throw''' (ie: games using other methods for dice throwing will be rejected by BGA during review).		In particular, it is '''mandatory''' to use it for all '''dice throw''' (ie: games using other methods for dice throwing will be rejected by BGA during review).