Troubleshooting - Revision history

Thoun at 10:07, 20 April 2026

2026-04-20T10:07:51Z

Thoun at 10:27, 13 February 2026

2026-02-13T10:27:00Z

← Older revision		Revision as of 12:27, 13 February 2026
Line 75:		Line 75:
	Check that notfication you sending have args method supplied, i.e		Check that notfication you sending have args method supplied, i.e

	$this->notify->all('message', "", []); // 3rd argument MUST be array		$this->bga->notify->all('message', "", []); // 3rd argument MUST be array

	=== The server reported an error ===		=== The server reported an error ===
Line 184:		Line 184:
	* did not get any notification from the PHP side. To avoid this, put an empty notify->player in the PHP side of the Ajax handler to ensure the client receives a response. This line of code should do it:		* did not get any notification from the PHP side. To avoid this, put an empty notify->player in the PHP side of the Ajax handler to ensure the client receives a response. This line of code should do it:
	<pre>		<pre>
	$this->notify->player($this->getCurrentPlayerId(), 'message', ''~~, []~~); // sent to current player, who originated the action		$this->bga->notify->player($this->getCurrentPlayerId(), 'message', ''); // sent to current player, who originated the action
	</pre>		</pre>

Thoun: /* Zombie mode */

2025-09-04T08:30:12Z

Zombie mode

← Older revision		Revision as of 10:30, 4 September 2025
Line 330:		Line 330:
	=== Unexpected error: BGA gameserver 1 do not respond (method: zombie) (timeout: cluster) ===		=== Unexpected error: BGA gameserver 1 do not respond (method: zombie) (timeout: cluster) ===

	You are trying to end the game from a zombie method. This is not allowed. The zombie logic must continue the game as best it can~~. See [[Main_game_logic:_yourgamename.game.php#Zombie_mode\|Zombie mode]] for more info~~.		You are trying to end the game from a zombie method. This is not allowed. The zombie logic must continue the game as best it can.

	=== Game unexpectedly ends when one player becomes zombie ===		=== Game unexpectedly ends when one player becomes zombie ===

	There is an error in handling zombie mode, check error log. Example: if the zombie turn is called again, framework detects a infinite loop and cancels the game. On the studio there is a notification called ZombieTurnFailed		There is an error in handling zombie mode, check error log. Example: if the zombie turn is called again, framework detects a infinite loop and cancels the game. On the studio there is a notification called ZombieTurnFailed

			For more details about how the Zombie code should work, see [[Zombie Mode\|Zombie mode]] for more info.

	== Dead locks ==		== Dead locks ==

Victoria La: /* Game starts but I can't make a move */

2025-07-14T01:08:45Z

Game starts but I can't make a move

← Older revision		Revision as of 03:08, 14 July 2025
Line 150:		Line 150:

	You may have an error in your AJAX path, such as /reversi/reversi when your game's name is different.		You may have an error in your AJAX path, such as /reversi/reversi when your game's name is different.

			=== When I do a move, I get "Server syntax error: Fatal error: Allowed memory size of X bytes exhausted". ===

			You have a stack overflow when your action is called. Caused by infinitive recursion.

	=== Some player action is triggered randomly when I click somewhere on the game area ===		=== Some player action is triggered randomly when I click somewhere on the game area ===

Ufm: /* HTTP Error 500 (when the BGA server is stable) */

2025-02-12T10:16:14Z

HTTP Error 500 (when the BGA server is stable)

← Older revision		Revision as of 12:16, 12 February 2025
Line 119:		Line 119:

	The table has been created, but the table loading (e.g. getAllDatas()) hasn't been finished properly for some reason. For example php type error when strict typing is enabled.		The table has been created, but the table loading (e.g. getAllDatas()) hasn't been finished properly for some reason. For example php type error when strict typing is enabled.

			Also, this may happen when the game is using <code>gameoptions.inc.php</code> and is using a non-string option name.

	=== Unexpected error: Wrong formatted data from gameserver 1 (method: createGame): JSON_ERROR_SYNTAX - Warning: Undefined array key 100 in .../table.game.php - Unknown gamestate label: 100 ===		=== Unexpected error: Wrong formatted data from gameserver 1 (method: createGame): JSON_ERROR_SYNTAX - Warning: Undefined array key 100 in .../table.game.php - Unknown gamestate label: 100 ===

Thoun at 16:49, 13 January 2025

2025-01-13T16:49:26Z

← Older revision		Revision as of 18:49, 13 January 2025
Line 75:		Line 75:
	Check that notfication you sending have args method supplied, i.e		Check that notfication you sending have args method supplied, i.e

	$this->notify->all('message', "", []); // 3rd argument MUST be array ~~and MANDATORY~~		$this->notify->all('message', "", []); // 3rd argument MUST be array

	=== The server reported an error ===		=== The server reported an error ===

Thoun at 16:48, 13 January 2025

2025-01-13T16:48:14Z

← Older revision		Revision as of 18:48, 13 January 2025
Line 75:		Line 75:
	Check that notfication you sending have args method supplied, i.e		Check that notfication you sending have args method supplied, i.e

	$this->~~notifyAllPlayers~~('message', "", []); // 3rd argument MUST be array and MANDATORY		$this->notify->all('message', "", []); // 3rd argument MUST be array and MANDATORY

	=== The server reported an error ===		=== The server reported an error ===

Thoun at 16:36, 13 January 2025

2025-01-13T16:36:33Z

← Older revision		Revision as of 18:36, 13 January 2025
Line 132:		Line 132:
	"Waiting for update" means that your client interface is waiting for some notifications from the server that correspond to the move we just did.		"Waiting for update" means that your client interface is waiting for some notifications from the server that correspond to the move we just did.

	If this message stays forever, it is probably that your PHP code does not send any notification when the move happens, which is abnormal. To fix this: add a ~~notifyAllPlayers~~ or a ~~notifyPlayer~~ call in your PHP code.		If this message stays forever, it is probably that your PHP code does not send any notification when the move happens, which is abnormal. To fix this: add a notify->all or a notify->player call in your PHP code.

	=== When I do a move, I get "Sending move to server..." then nothing and game resets to state before the move ===		=== When I do a move, I get "Sending move to server..." then nothing and game resets to state before the move ===
Line 176:		Line 176:
	* action is not complete yet - i.e. takes some time, and user clicked something again		* action is not complete yet - i.e. takes some time, and user clicked something again
	* if there is bug in interface where MULTIPLE handlers are fired on same click. To debug this add some console.trace() in place this specific checkAction is called.		* if there is bug in interface where MULTIPLE handlers are fired on same click. To debug this add some console.trace() in place this specific checkAction is called.
	* did not get any notification from the PHP side. To avoid this, put an empty ~~notifyPlayer~~ in the PHP side of the Ajax handler to ensure the client receives a response. This line of code should do it:		* did not get any notification from the PHP side. To avoid this, put an empty notify->player in the PHP side of the Ajax handler to ensure the client receives a response. This line of code should do it:
	<pre>		<pre>
	$this->~~notifyPlayer~~($this->getCurrentPlayerId(), 'message', '', []); // sent to current player, who originated the action		$this->notify->player($this->getCurrentPlayerId(), 'message', '', []); // sent to current player, who originated the action
	</pre>		</pre>

Pdw3: Added item about forgetting to initialize a new game option

2024-09-05T19:57:47Z

Added item about forgetting to initialize a new game option

← Older revision		Revision as of 21:57, 5 September 2024
Line 119:		Line 119:

	The table has been created, but the table loading (e.g. getAllDatas()) hasn't been finished properly for some reason. For example php type error when strict typing is enabled.		The table has been created, but the table loading (e.g. getAllDatas()) hasn't been finished properly for some reason. For example php type error when strict typing is enabled.

			=== Unexpected error: Wrong formatted data from gameserver 1 (method: createGame): JSON_ERROR_SYNTAX - Warning: Undefined array key 100 in .../table.game.php - Unknown gamestate label: 100 ===

			You've added a new option to <code>gameoptions.json</code> but forgot to initialize the option via <code>self::initGameStateLabels()</code>.

	== Game starts but I can't make a move ==		== Game starts but I can't make a move ==

Victoria La: /* HTTP Error 500 (when the BGA server is stable) */

2024-08-25T17:28:16Z

HTTP Error 500 (when the BGA server is stable)

← Older revision		Revision as of 19:28, 25 August 2024
Line 118:		Line 118:
	=== HTTP Error 500 (when the BGA server is stable) ===		=== HTTP Error 500 (when the BGA server is stable) ===

	The table has been created, but the table loading (e.g. getAllDatas()) hasn't been finished properly for some reason.		The table has been created, but the table loading (e.g. getAllDatas()) hasn't been finished properly for some reason. For example php type error when strict typing is enabled.

	== Game starts but I can't make a move ==		== Game starts but I can't make a move ==

← Older revision		Revision as of 12:07, 20 April 2026
Line 81:		Line 81:
	During table creation: "The server reported an error" error shown and nothing else.		During table creation: "The server reported an error" error shown and nothing else.

	If you cannot even create a table - there is syntax error in gameinfos.~~php~~, check it, reload it from management panel.		If you cannot even create a table - there is syntax error in gameinfos.jsonc, check it, reload it from management panel.
	If still no luck copy clean version from ~~template https://github~~.~~com/elaskavaia/bga-sharedcode/blob/master/gameinfos.inc.php~~		If still no luck copy clean version from the EmptyGame project.

	=== Unexpected Error : Invalid player number for this game : 4 ===		=== Unexpected Error : Invalid player number for this game : 4 ===

	This error may comes when trying to change the player number configuration in gameinfos.~~inc.php~~ from a higher to lower number of players (for example from 4 to 2).		This error may comes when trying to change the player number configuration in gameinfos.jsonc from a higher to lower number of players (for example from 4 to 2).

	The following steps will help to change a player config from array(4) to array(2) :		The following steps will help to change a player config from array(4) to array(2) :

	* change in gameinfos.~~inc.php~~ the entry to 'players~~' => array(~~ 2,3,4 )		* change in gameinfos.jsonc the entry to "players": [2,3,4]
	* In game management page (Control Panel > Manage Games > "Your Game"), press the "Reload Game information" button		* In game management page (Control Panel > Manage Games > "Your Game"), press the "Reload Game information" button
	* create a new table		* create a new table
	* reduce the number of players to 2 and start the game		* reduce the number of players to 2 and start the game
	* (express) Stop the game		* (express) Stop the game
	* change in gameinfos.~~inc.php~~ the entry to 'players~~' => array(~~ 2 )		* change in gameinfos.jsonc the entry to "players": [2]
	* press again the "Reload Game information" button		* press again the "Reload Game information" button

Line 258:		Line 258:
	No further details in the log. When log is filling with some social connect errors.		No further details in the log. When log is filling with some social connect errors.

	Possible Reason: Syntax error in of the php script which is loaded before the start, such as gameoptions.~~inc.php~~, gameinfos.~~inc.php~~ and such. This can also occur if the gamedatas returned from getAllDatas() in *.game.php contains objects that cannot be properly serialized. For example, a class that defines functions as well as scalars.		Possible Reason: Syntax error in of the php script which is loaded before the start, such as gameoptions.jsonc, gameinfos.jsonc and such. This can also occur if the gamedatas returned from getAllDatas() in *.game.php contains objects that cannot be properly serialized. For example, a class that defines functions as well as scalars.

	=== Game interface spins in a loop throwing error ===		=== Game interface spins in a loop throwing error ===