Mod API Reference:ClientGame - Revision history

StereoTunic9039: 'Map' was present twice, identical, for no apparent reason

2026-01-03T00:59:31Z

'Map' was present twice, identical, for no apparent reason

← Older revision		Revision as of 00:59, 3 January 2026
Line 5:		Line 5:
	* '''Us''' ''[[Mod API Reference:GamePlayer\|GamePlayer]]'': Details about the player who is playing. Note that this will be '''nil''' when a spectator views this game, so be sure to test your mod as spectators if you use this field.		* '''Us''' ''[[Mod API Reference:GamePlayer\|GamePlayer]]'': Details about the player who is playing. Note that this will be '''nil''' when a spectator views this game, so be sure to test your mod as spectators if you use this field.
	* '''Game''' ''[[Mod API Reference:GameWL\|GameWL]]'': Details about the game.		* '''Game''' ''[[Mod API Reference:GameWL\|GameWL]]'': Details about the game.
	* '''Map''' ''[[Mod API Reference:MapDetails\|MapDetails]]'': Details about the map for this game.
	* '''Settings''' ''[[Mod API Reference:GameSettings\|GameSettings]]'': The settings this game uses.		* '''Settings''' ''[[Mod API Reference:GameSettings\|GameSettings]]'': The settings this game uses.
	* '''LatestStanding''' ''[[Mod API Reference:GameStanding\|GameStanding]]'': The latest state of the game.		* '''LatestStanding''' ''[[Mod API Reference:GameStanding\|GameStanding]]'': The latest state of the game.

Fizzer at 20:43, 7 November 2024

2024-11-07T20:43:13Z

← Older revision		Revision as of 20:43, 7 November 2024
Line 9:		Line 9:
	* '''LatestStanding''' ''[[Mod API Reference:GameStanding\|GameStanding]]'': The latest state of the game.		* '''LatestStanding''' ''[[Mod API Reference:GameStanding\|GameStanding]]'': The latest state of the game.
	* '''GetDistributionStanding''': A function used to get the [[Mod API Reference:GameStanding\|GameStanding]] during the picking phase of this game. Pass this function your own callback function which takes a [[Mod API Reference:GameStanding\|GameStanding]] as an argument. For example: <code>game.GetDistributionStanding(function(standing) print('got ' .. standing) end)</code>. Your function will be called with nil if the distribution standing is not available, for example if it's an automatic distribution game. In the event of an error, such as lack of an internet connection, your callback will not be called and instead the player will get a "Could not connect" message.		* '''GetDistributionStanding''': A function used to get the [[Mod API Reference:GameStanding\|GameStanding]] during the picking phase of this game. Pass this function your own callback function which takes a [[Mod API Reference:GameStanding\|GameStanding]] as an argument. For example: <code>game.GetDistributionStanding(function(standing) print('got ' .. standing) end)</code>. Your function will be called with nil if the distribution standing is not available, for example if it's an automatic distribution game. In the event of an error, such as lack of an internet connection, your callback will not be called and instead the player will get a "Could not connect" message.
	* '''GetStanding''': A function used to get the [[Mod API Reference:GameStanding\|GameStanding]] for any turn of the game. Pass this function three arguments: The first argument is an integer representing what turn to get (0 for the start of the game, 1 for the second turn, 2 for the third turn, etc.) The second argument is ~~currently not used, so always pass~~ 0. Third, pass a callback function that will get called with the [[Mod API Reference:GameStanding\|GameStanding]]. In the event of an error, such as lack of an internet connection, your callback will not be called and instead the player will get a "Could not connect" message.		* '''GetStanding''': A function used to get the [[Mod API Reference:GameStanding\|GameStanding]] for any turn of the game. Pass this function three arguments: The first argument is an integer representing what turn to get (0 for the start of the game, 1 for the second turn, 2 for the third turn, etc.) The second argument is how many orders you want from that turn applied into the standing (specify 0 to get the start of the turn). Third, pass a callback function that will get called with the [[Mod API Reference:GameStanding\|GameStanding]]. In the event of an error, such as lack of an internet connection, your callback will not be called and instead the player will get a "Could not connect" message.
	* '''GetTurn''': A function used to get the [[Mod API Reference:GameTurn\|GameTurn]] for any turn of the game. Identical to GetStanding in every way, except that it calls back your function with a [[Mod API Reference:GameTurn\|GameTurn]].		* '''GetTurn''': A function used to get the [[Mod API Reference:GameTurn\|GameTurn]] for any turn of the game. Identical to GetStanding in every way, except that it calls back your function with a [[Mod API Reference:GameTurn\|GameTurn]].
	* '''Orders''' ''Array<[[Mod API Reference:GameOrder\|GameOrder]]>'': Allows you to read and write the orders that the player is building up in the orders list for the current turn. You can call this property to see the orders, or assign a list of orders to it to replace the player's orders with your list.		* '''Orders''' ''Array<[[Mod API Reference:GameOrder\|GameOrder]]>'': Allows you to read and write the orders that the player is building up in the orders list for the current turn. You can call this property to see the orders, or assign a list of orders to it to replace the player's orders with your list.

Fizzer at 20:41, 7 November 2024

2024-11-07T20:41:35Z

← Older revision		Revision as of 20:41, 7 November 2024
Line 9:		Line 9:
	* '''LatestStanding''' ''[[Mod API Reference:GameStanding\|GameStanding]]'': The latest state of the game.		* '''LatestStanding''' ''[[Mod API Reference:GameStanding\|GameStanding]]'': The latest state of the game.
	* '''GetDistributionStanding''': A function used to get the [[Mod API Reference:GameStanding\|GameStanding]] during the picking phase of this game. Pass this function your own callback function which takes a [[Mod API Reference:GameStanding\|GameStanding]] as an argument. For example: <code>game.GetDistributionStanding(function(standing) print('got ' .. standing) end)</code>. Your function will be called with nil if the distribution standing is not available, for example if it's an automatic distribution game. In the event of an error, such as lack of an internet connection, your callback will not be called and instead the player will get a "Could not connect" message.		* '''GetDistributionStanding''': A function used to get the [[Mod API Reference:GameStanding\|GameStanding]] during the picking phase of this game. Pass this function your own callback function which takes a [[Mod API Reference:GameStanding\|GameStanding]] as an argument. For example: <code>game.GetDistributionStanding(function(standing) print('got ' .. standing) end)</code>. Your function will be called with nil if the distribution standing is not available, for example if it's an automatic distribution game. In the event of an error, such as lack of an internet connection, your callback will not be called and instead the player will get a "Could not connect" message.
	* '''GetStanding''': A function used to get the [[Mod API Reference:GameStanding\|GameStanding]] for any turn of the game. Pass this function ~~two~~ arguments: first, an integer representing what turn to get (0 for the start of the game, 1 for the second turn, 2 for the third turn, etc.) ~~Second~~, pass a callback function that will get called with the [[Mod API Reference:GameStanding\|GameStanding]]. In the event of an error, such as lack of an internet connection, your callback will not be called and instead the player will get a "Could not connect" message.		* '''GetStanding''': A function used to get the [[Mod API Reference:GameStanding\|GameStanding]] for any turn of the game. Pass this function three arguments: The first argument is an integer representing what turn to get (0 for the start of the game, 1 for the second turn, 2 for the third turn, etc.) The second argument is currently not used, so always pass 0. Third, pass a callback function that will get called with the [[Mod API Reference:GameStanding\|GameStanding]]. In the event of an error, such as lack of an internet connection, your callback will not be called and instead the player will get a "Could not connect" message.
	* '''GetTurn''': A function used to get the [[Mod API Reference:GameTurn\|GameTurn]] for any turn of the game. Identical to GetStanding in every way, except that it calls back your function with a [[Mod API Reference:GameTurn\|GameTurn]].		* '''GetTurn''': A function used to get the [[Mod API Reference:GameTurn\|GameTurn]] for any turn of the game. Identical to GetStanding in every way, except that it calls back your function with a [[Mod API Reference:GameTurn\|GameTurn]].
	* '''Orders''' ''Array<[[Mod API Reference:GameOrder\|GameOrder]]>'': Allows you to read and write the orders that the player is building up in the orders list for the current turn. You can call this property to see the orders, or assign a list of orders to it to replace the player's orders with your list.		* '''Orders''' ''Array<[[Mod API Reference:GameOrder\|GameOrder]]>'': Allows you to read and write the orders that the player is building up in the orders list for the current turn. You can call this property to see the orders, or assign a list of orders to it to replace the player's orders with your list.

Fizzer at 01:47, 26 October 2022

2022-10-26T01:47:55Z

← Older revision		Revision as of 01:47, 26 October 2022
Line 17:		Line 17:
	# '''payload''': Data that will be delivered to the Server_GameCustomMessage hook. Must be a lua table.		# '''payload''': Data that will be delivered to the Server_GameCustomMessage hook. Must be a lua table.
	# '''callback''': A function you provide which will be called back when the message is complete. If the message fails, such as due to a disconnected internet connection or an error in the server hook, this callback will not be invoked. If it is invoked, it will be passed a single argument of a lua table that the Server_GameCustomMessage hook provided as a return value.		# '''callback''': A function you provide which will be called back when the message is complete. If the message fails, such as due to a disconnected internet connection or an error in the server hook, this callback will not be invoked. If it is invoked, it will be passed a single argument of a lua table that the Server_GameCustomMessage hook provided as a return value.
			* '''HighlightTerritories''': A function that will highlight territories on the map, to alert the player about them. Arguments:
			# ''Array<[[Mod API Reference:TerritoryID\|TerritoryID]]>>'': The IDs of the territories you wish to highlight.
			* '''CreateLocatorCircle''': A function that will highlight an area of the map, to alert the player to it. Pass an X,Y argument to determine the location. You can get the coordinates of territories by looking at a [[Mod API Reference:TerritoryDetails\|TerritoryDetails]] object. Arguments:
			# ''Number'': The X coordinate.
			# ''Number'': The Y coordinate.
	[[Category:Mod API Reference]]		[[Category:Mod API Reference]]

Fizzer at 16:55, 18 October 2022

2022-10-18T16:55:23Z

← Older revision		Revision as of 16:55, 18 October 2022
Line 11:		Line 11:
	* '''GetStanding''': A function used to get the [[Mod API Reference:GameStanding\|GameStanding]] for any turn of the game. Pass this function two arguments: first, an integer representing what turn to get (0 for the start of the game, 1 for the second turn, 2 for the third turn, etc.) Second, pass a callback function that will get called with the [[Mod API Reference:GameStanding\|GameStanding]]. In the event of an error, such as lack of an internet connection, your callback will not be called and instead the player will get a "Could not connect" message.		* '''GetStanding''': A function used to get the [[Mod API Reference:GameStanding\|GameStanding]] for any turn of the game. Pass this function two arguments: first, an integer representing what turn to get (0 for the start of the game, 1 for the second turn, 2 for the third turn, etc.) Second, pass a callback function that will get called with the [[Mod API Reference:GameStanding\|GameStanding]]. In the event of an error, such as lack of an internet connection, your callback will not be called and instead the player will get a "Could not connect" message.
	* '''GetTurn''': A function used to get the [[Mod API Reference:GameTurn\|GameTurn]] for any turn of the game. Identical to GetStanding in every way, except that it calls back your function with a [[Mod API Reference:GameTurn\|GameTurn]].		* '''GetTurn''': A function used to get the [[Mod API Reference:GameTurn\|GameTurn]] for any turn of the game. Identical to GetStanding in every way, except that it calls back your function with a [[Mod API Reference:GameTurn\|GameTurn]].
	* '''Orders''' ''~~List~~<[[Mod API Reference:GameOrder\|GameOrder]]>'': Allows you to read and write the orders that the player is building up in the orders list for the current turn. You can call this property to see the orders, or assign a list of orders to it to replace the player's orders with your list.		* '''Orders''' ''Array<[[Mod API Reference:GameOrder\|GameOrder]]>'': Allows you to read and write the orders that the player is building up in the orders list for the current turn. You can call this property to see the orders, or assign a list of orders to it to replace the player's orders with your list.
	* '''CreateDialog''': A function used to create a new dialog on the screen for players to interact with. Pass a single function callback as a argument to CreateDialog. Your function callback will be passed the same arguments as the the Client_PresentMenuUI hook, documented at [[Mod Hooks]]		* '''CreateDialog''': A function used to create a new dialog on the screen for players to interact with. Pass a single function callback as a argument to CreateDialog. Your function callback will be passed the same arguments as the the Client_PresentMenuUI hook, documented at [[Mod Hooks]]
	* '''SendGameCustomMessage''': A function used to send a message to the server, which will be handled by the Server_GameCustomMessage hook as documented at [[Mod Hooks]]. Note that this message is rate-limited to 5 calls every 5 seconds per client to avoid extra tax on the server. Arguments:		* '''SendGameCustomMessage''': A function used to send a message to the server, which will be handled by the Server_GameCustomMessage hook as documented at [[Mod Hooks]]. Note that this message is rate-limited to 5 calls every 5 seconds per client to avoid extra tax on the server. Arguments:

Fizzer at 19:04, 17 October 2022

2022-10-17T19:04:20Z

← Older revision		Revision as of 19:04, 17 October 2022
Line 9:		Line 9:
	* '''LatestStanding''' ''[[Mod API Reference:GameStanding\|GameStanding]]'': The latest state of the game.		* '''LatestStanding''' ''[[Mod API Reference:GameStanding\|GameStanding]]'': The latest state of the game.
	* '''GetDistributionStanding''': A function used to get the [[Mod API Reference:GameStanding\|GameStanding]] during the picking phase of this game. Pass this function your own callback function which takes a [[Mod API Reference:GameStanding\|GameStanding]] as an argument. For example: <code>game.GetDistributionStanding(function(standing) print('got ' .. standing) end)</code>. Your function will be called with nil if the distribution standing is not available, for example if it's an automatic distribution game. In the event of an error, such as lack of an internet connection, your callback will not be called and instead the player will get a "Could not connect" message.		* '''GetDistributionStanding''': A function used to get the [[Mod API Reference:GameStanding\|GameStanding]] during the picking phase of this game. Pass this function your own callback function which takes a [[Mod API Reference:GameStanding\|GameStanding]] as an argument. For example: <code>game.GetDistributionStanding(function(standing) print('got ' .. standing) end)</code>. Your function will be called with nil if the distribution standing is not available, for example if it's an automatic distribution game. In the event of an error, such as lack of an internet connection, your callback will not be called and instead the player will get a "Could not connect" message.
	* '''GetStanding''': A function used to get the [[Mod API Reference:GameStanding\|GameStanding]] for any turn of the game. Pass this function two arguments: first, an integer ~~represneting~~ what turn to get (0 for the start of the game, 1 for the second turn, 2 for the third turn, etc.) Second, pass a callback function that will get called with the [[Mod API Reference:GameStanding\|GameStanding]]. ~~See GetDistributionStanding for~~ an ~~example~~.		* '''GetStanding''': A function used to get the [[Mod API Reference:GameStanding\|GameStanding]] for any turn of the game. Pass this function two arguments: first, an integer representing what turn to get (0 for the start of the game, 1 for the second turn, 2 for the third turn, etc.) Second, pass a callback function that will get called with the [[Mod API Reference:GameStanding\|GameStanding]]. In the event of an error, such as lack of an internet connection, your callback will not be called and instead the player will get a "Could not connect" message.
	* '''GetTurn''': A function used to get the [[Mod API Reference:GameTurn\|GameTurn]] for any turn of the game. Identical to GetStanding in every way, except that it calls back your function with a [[Mod API Reference:GameTurn\|GameTurn]].		* '''GetTurn''': A function used to get the [[Mod API Reference:GameTurn\|GameTurn]] for any turn of the game. Identical to GetStanding in every way, except that it calls back your function with a [[Mod API Reference:GameTurn\|GameTurn]].
	* '''Orders''' ''List<[[Mod API Reference:GameOrder\|GameOrder]]>'': Allows you to read and write the orders that the player is building up in the orders list for the current turn. You can call this property to see the orders, or assign a list of orders to it to replace the player's orders with your list.		* '''Orders''' ''List<[[Mod API Reference:GameOrder\|GameOrder]]>'': Allows you to read and write the orders that the player is building up in the orders list for the current turn. You can call this property to see the orders, or assign a list of orders to it to replace the player's orders with your list.

Fizzer at 19:03, 17 October 2022

2022-10-17T19:03:43Z

← Older revision		Revision as of 19:03, 17 October 2022
Line 8:		Line 8:
	* '''Settings''' ''[[Mod API Reference:GameSettings\|GameSettings]]'': The settings this game uses.		* '''Settings''' ''[[Mod API Reference:GameSettings\|GameSettings]]'': The settings this game uses.
	* '''LatestStanding''' ''[[Mod API Reference:GameStanding\|GameStanding]]'': The latest state of the game.		* '''LatestStanding''' ''[[Mod API Reference:GameStanding\|GameStanding]]'': The latest state of the game.
	* '''GetDistributionStanding''': A function used to get the [[Mod API Reference:GameStanding\|GameStanding]] during the picking phase of this game. Pass this function your own callback function which takes a [[Mod API Reference:GameStanding\|GameStanding]] as an argument. For example: <code>game.GetDistributionStanding(function(standing) print('got ' .. standing) end)</code>. Your function will be called with nil if the distribution standing is not available, for example if it's an automatic distribution game. In the event of an error, such as lack of an internet connection, your callback will not be called.		* '''GetDistributionStanding''': A function used to get the [[Mod API Reference:GameStanding\|GameStanding]] during the picking phase of this game. Pass this function your own callback function which takes a [[Mod API Reference:GameStanding\|GameStanding]] as an argument. For example: <code>game.GetDistributionStanding(function(standing) print('got ' .. standing) end)</code>. Your function will be called with nil if the distribution standing is not available, for example if it's an automatic distribution game. In the event of an error, such as lack of an internet connection, your callback will not be called and instead the player will get a "Could not connect" message.
	* '''GetStanding''': A function used to get the [[Mod API Reference:GameStanding\|GameStanding]] for any turn of the game. Pass this function two arguments: first, an integer represneting what turn to get (0 for the start of the game, 1 for the second turn, 2 for the third turn, etc.) Second, pass a callback function that will get called with the [[Mod API Reference:GameStanding\|GameStanding]]. See GetDistributionStanding for an example.		* '''GetStanding''': A function used to get the [[Mod API Reference:GameStanding\|GameStanding]] for any turn of the game. Pass this function two arguments: first, an integer represneting what turn to get (0 for the start of the game, 1 for the second turn, 2 for the third turn, etc.) Second, pass a callback function that will get called with the [[Mod API Reference:GameStanding\|GameStanding]]. See GetDistributionStanding for an example.
	* '''GetTurn''': A function used to get the [[Mod API Reference:GameTurn\|GameTurn]] for any turn of the game. Identical to GetStanding in every way, except that it calls back your function with a [[Mod API Reference:GameTurn\|GameTurn]].		* '''GetTurn''': A function used to get the [[Mod API Reference:GameTurn\|GameTurn]] for any turn of the game. Identical to GetStanding in every way, except that it calls back your function with a [[Mod API Reference:GameTurn\|GameTurn]].

Fizzer at 22:57, 11 January 2022

2022-01-11T22:57:56Z

← Older revision		Revision as of 22:57, 11 January 2022
Line 13:		Line 13:
	* '''Orders''' ''List<[[Mod API Reference:GameOrder\|GameOrder]]>'': Allows you to read and write the orders that the player is building up in the orders list for the current turn. You can call this property to see the orders, or assign a list of orders to it to replace the player's orders with your list.		* '''Orders''' ''List<[[Mod API Reference:GameOrder\|GameOrder]]>'': Allows you to read and write the orders that the player is building up in the orders list for the current turn. You can call this property to see the orders, or assign a list of orders to it to replace the player's orders with your list.
	* '''CreateDialog''': A function used to create a new dialog on the screen for players to interact with. Pass a single function callback as a argument to CreateDialog. Your function callback will be passed the same arguments as the the Client_PresentMenuUI hook, documented at [[Mod Hooks]]		* '''CreateDialog''': A function used to create a new dialog on the screen for players to interact with. Pass a single function callback as a argument to CreateDialog. Your function callback will be passed the same arguments as the the Client_PresentMenuUI hook, documented at [[Mod Hooks]]
	* '''SendGameCustomMessage''': A function used to send a message to the server, which will be handled by the Server_GameCustomMessage hook as documented at [[Mod Hooks]]. Note that this message is rate-limited to 5 calls every 30 seconds per client to avoid extra tax on the server. Arguments:		* '''SendGameCustomMessage''': A function used to send a message to the server, which will be handled by the Server_GameCustomMessage hook as documented at [[Mod Hooks]]. Note that this message is rate-limited to 5 calls every 5 seconds per client to avoid extra tax on the server. Arguments:
	# '''waitText''': A string identifying what wait message will be displayed to the player as they're waiting for the server to reply.		# '''waitText''': A string identifying what wait message will be displayed to the player as they're waiting for the server to reply.
	# '''payload''': Data that will be delivered to the Server_GameCustomMessage hook. Must be a lua table.		# '''payload''': Data that will be delivered to the Server_GameCustomMessage hook. Must be a lua table.
	# '''callback''': A function you provide which will be called back when the message is complete. If the message fails, such as due to a disconnected internet connection or an error in the server hook, this callback will not be invoked. If it is invoked, it will be passed a single argument of a lua table that the Server_GameCustomMessage hook provided as a return value.		# '''callback''': A function you provide which will be called back when the message is complete. If the message fails, such as due to a disconnected internet connection or an error in the server hook, this callback will not be invoked. If it is invoked, it will be passed a single argument of a lua table that the Server_GameCustomMessage hook provided as a return value.
	[[Category:Mod API Reference]]		[[Category:Mod API Reference]]

DanWL60 at 17:02, 4 December 2018

2018-12-04T17:02:59Z

← Older revision		Revision as of 17:02, 4 December 2018
Line 17:		Line 17:
	# '''payload''': Data that will be delivered to the Server_GameCustomMessage hook. Must be a lua table.		# '''payload''': Data that will be delivered to the Server_GameCustomMessage hook. Must be a lua table.
	# '''callback''': A function you provide which will be called back when the message is complete. If the message fails, such as due to a disconnected internet connection or an error in the server hook, this callback will not be invoked. If it is invoked, it will be passed a single argument of a lua table that the Server_GameCustomMessage hook provided as a return value.		# '''callback''': A function you provide which will be called back when the message is complete. If the message fails, such as due to a disconnected internet connection or an error in the server hook, this callback will not be invoked. If it is invoked, it will be passed a single argument of a lua table that the Server_GameCustomMessage hook provided as a return value.
			[[Category:Mod API Reference]]

Fizzer at 19:16, 2 June 2017

2017-06-02T19:16:16Z

← Older revision		Revision as of 19:16, 2 June 2017
Line 13:		Line 13:
	* '''Orders''' ''List<[[Mod API Reference:GameOrder\|GameOrder]]>'': Allows you to read and write the orders that the player is building up in the orders list for the current turn. You can call this property to see the orders, or assign a list of orders to it to replace the player's orders with your list.		* '''Orders''' ''List<[[Mod API Reference:GameOrder\|GameOrder]]>'': Allows you to read and write the orders that the player is building up in the orders list for the current turn. You can call this property to see the orders, or assign a list of orders to it to replace the player's orders with your list.
	* '''CreateDialog''': A function used to create a new dialog on the screen for players to interact with. Pass a single function callback as a argument to CreateDialog. Your function callback will be passed the same arguments as the the Client_PresentMenuUI hook, documented at [[Mod Hooks]]		* '''CreateDialog''': A function used to create a new dialog on the screen for players to interact with. Pass a single function callback as a argument to CreateDialog. Your function callback will be passed the same arguments as the the Client_PresentMenuUI hook, documented at [[Mod Hooks]]
			* '''SendGameCustomMessage''': A function used to send a message to the server, which will be handled by the Server_GameCustomMessage hook as documented at [[Mod Hooks]]. Note that this message is rate-limited to 5 calls every 30 seconds per client to avoid extra tax on the server. Arguments:
			# '''waitText''': A string identifying what wait message will be displayed to the player as they're waiting for the server to reply.
			# '''payload''': Data that will be delivered to the Server_GameCustomMessage hook. Must be a lua table.
			# '''callback''': A function you provide which will be called back when the message is complete. If the message fails, such as due to a disconnected internet connection or an error in the server hook, this callback will not be invoked. If it is invoked, it will be passed a single argument of a lua table that the Server_GameCustomMessage hook provided as a return value.

← Older revision		Revision as of 00:59, 3 January 2026
Line 5:		Line 5:
	* '''Us''' ''[[Mod API Reference:GamePlayer\|GamePlayer]]'': Details about the player who is playing. Note that this will be '''nil''' when a spectator views this game, so be sure to test your mod as spectators if you use this field.		* '''Us''' ''[[Mod API Reference:GamePlayer\|GamePlayer]]'': Details about the player who is playing. Note that this will be '''nil''' when a spectator views this game, so be sure to test your mod as spectators if you use this field.
	* '''Game''' ''[[Mod API Reference:GameWL\|GameWL]]'': Details about the game.		* '''Game''' ''[[Mod API Reference:GameWL\|GameWL]]'': Details about the game.
	* '''Map''' ''[[Mod API Reference:MapDetails\|MapDetails]]'': Details about the map for this game.
	* '''Settings''' ''[[Mod API Reference:GameSettings\|GameSettings]]'': The settings this game uses.		* '''Settings''' ''[[Mod API Reference:GameSettings\|GameSettings]]'': The settings this game uses.
	* '''LatestStanding''' ''[[Mod API Reference:GameStanding\|GameStanding]]'': The latest state of the game.		* '''LatestStanding''' ''[[Mod API Reference:GameStanding\|GameStanding]]'': The latest state of the game.

← Older revision		Revision as of 20:43, 7 November 2024
Line 9:		Line 9:
	* '''LatestStanding''' ''[[Mod API Reference:GameStanding\|GameStanding]]'': The latest state of the game.		* '''LatestStanding''' ''[[Mod API Reference:GameStanding\|GameStanding]]'': The latest state of the game.
	* '''GetDistributionStanding''': A function used to get the [[Mod API Reference:GameStanding\|GameStanding]] during the picking phase of this game. Pass this function your own callback function which takes a [[Mod API Reference:GameStanding\|GameStanding]] as an argument. For example: <code>game.GetDistributionStanding(function(standing) print('got ' .. standing) end)</code>. Your function will be called with nil if the distribution standing is not available, for example if it's an automatic distribution game. In the event of an error, such as lack of an internet connection, your callback will not be called and instead the player will get a "Could not connect" message.		* '''GetDistributionStanding''': A function used to get the [[Mod API Reference:GameStanding\|GameStanding]] during the picking phase of this game. Pass this function your own callback function which takes a [[Mod API Reference:GameStanding\|GameStanding]] as an argument. For example: <code>game.GetDistributionStanding(function(standing) print('got ' .. standing) end)</code>. Your function will be called with nil if the distribution standing is not available, for example if it's an automatic distribution game. In the event of an error, such as lack of an internet connection, your callback will not be called and instead the player will get a "Could not connect" message.
	* '''GetStanding''': A function used to get the [[Mod API Reference:GameStanding\|GameStanding]] for any turn of the game. Pass this function three arguments: The first argument is an integer representing what turn to get (0 for the start of the game, 1 for the second turn, 2 for the third turn, etc.) The second argument is ~~currently not used, so always pass~~ 0. Third, pass a callback function that will get called with the [[Mod API Reference:GameStanding\|GameStanding]]. In the event of an error, such as lack of an internet connection, your callback will not be called and instead the player will get a "Could not connect" message.		* '''GetStanding''': A function used to get the [[Mod API Reference:GameStanding\|GameStanding]] for any turn of the game. Pass this function three arguments: The first argument is an integer representing what turn to get (0 for the start of the game, 1 for the second turn, 2 for the third turn, etc.) The second argument is how many orders you want from that turn applied into the standing (specify 0 to get the start of the turn). Third, pass a callback function that will get called with the [[Mod API Reference:GameStanding\|GameStanding]]. In the event of an error, such as lack of an internet connection, your callback will not be called and instead the player will get a "Could not connect" message.
	* '''GetTurn''': A function used to get the [[Mod API Reference:GameTurn\|GameTurn]] for any turn of the game. Identical to GetStanding in every way, except that it calls back your function with a [[Mod API Reference:GameTurn\|GameTurn]].		* '''GetTurn''': A function used to get the [[Mod API Reference:GameTurn\|GameTurn]] for any turn of the game. Identical to GetStanding in every way, except that it calls back your function with a [[Mod API Reference:GameTurn\|GameTurn]].
	* '''Orders''' ''Array<[[Mod API Reference:GameOrder\|GameOrder]]>'': Allows you to read and write the orders that the player is building up in the orders list for the current turn. You can call this property to see the orders, or assign a list of orders to it to replace the player's orders with your list.		* '''Orders''' ''Array<[[Mod API Reference:GameOrder\|GameOrder]]>'': Allows you to read and write the orders that the player is building up in the orders list for the current turn. You can call this property to see the orders, or assign a list of orders to it to replace the player's orders with your list.

← Older revision		Revision as of 20:41, 7 November 2024
Line 9:		Line 9:
	* '''LatestStanding''' ''[[Mod API Reference:GameStanding\|GameStanding]]'': The latest state of the game.		* '''LatestStanding''' ''[[Mod API Reference:GameStanding\|GameStanding]]'': The latest state of the game.
	* '''GetDistributionStanding''': A function used to get the [[Mod API Reference:GameStanding\|GameStanding]] during the picking phase of this game. Pass this function your own callback function which takes a [[Mod API Reference:GameStanding\|GameStanding]] as an argument. For example: <code>game.GetDistributionStanding(function(standing) print('got ' .. standing) end)</code>. Your function will be called with nil if the distribution standing is not available, for example if it's an automatic distribution game. In the event of an error, such as lack of an internet connection, your callback will not be called and instead the player will get a "Could not connect" message.		* '''GetDistributionStanding''': A function used to get the [[Mod API Reference:GameStanding\|GameStanding]] during the picking phase of this game. Pass this function your own callback function which takes a [[Mod API Reference:GameStanding\|GameStanding]] as an argument. For example: <code>game.GetDistributionStanding(function(standing) print('got ' .. standing) end)</code>. Your function will be called with nil if the distribution standing is not available, for example if it's an automatic distribution game. In the event of an error, such as lack of an internet connection, your callback will not be called and instead the player will get a "Could not connect" message.
	* '''GetStanding''': A function used to get the [[Mod API Reference:GameStanding\|GameStanding]] for any turn of the game. Pass this function ~~two~~ arguments: first, an integer representing what turn to get (0 for the start of the game, 1 for the second turn, 2 for the third turn, etc.) ~~Second~~, pass a callback function that will get called with the [[Mod API Reference:GameStanding\|GameStanding]]. In the event of an error, such as lack of an internet connection, your callback will not be called and instead the player will get a "Could not connect" message.		* '''GetStanding''': A function used to get the [[Mod API Reference:GameStanding\|GameStanding]] for any turn of the game. Pass this function three arguments: The first argument is an integer representing what turn to get (0 for the start of the game, 1 for the second turn, 2 for the third turn, etc.) The second argument is currently not used, so always pass 0. Third, pass a callback function that will get called with the [[Mod API Reference:GameStanding\|GameStanding]]. In the event of an error, such as lack of an internet connection, your callback will not be called and instead the player will get a "Could not connect" message.
	* '''GetTurn''': A function used to get the [[Mod API Reference:GameTurn\|GameTurn]] for any turn of the game. Identical to GetStanding in every way, except that it calls back your function with a [[Mod API Reference:GameTurn\|GameTurn]].		* '''GetTurn''': A function used to get the [[Mod API Reference:GameTurn\|GameTurn]] for any turn of the game. Identical to GetStanding in every way, except that it calls back your function with a [[Mod API Reference:GameTurn\|GameTurn]].
	* '''Orders''' ''Array<[[Mod API Reference:GameOrder\|GameOrder]]>'': Allows you to read and write the orders that the player is building up in the orders list for the current turn. You can call this property to see the orders, or assign a list of orders to it to replace the player's orders with your list.		* '''Orders''' ''Array<[[Mod API Reference:GameOrder\|GameOrder]]>'': Allows you to read and write the orders that the player is building up in the orders list for the current turn. You can call this property to see the orders, or assign a list of orders to it to replace the player's orders with your list.

← Older revision		Revision as of 19:04, 17 October 2022
Line 9:		Line 9:
	* '''LatestStanding''' ''[[Mod API Reference:GameStanding\|GameStanding]]'': The latest state of the game.		* '''LatestStanding''' ''[[Mod API Reference:GameStanding\|GameStanding]]'': The latest state of the game.
	* '''GetDistributionStanding''': A function used to get the [[Mod API Reference:GameStanding\|GameStanding]] during the picking phase of this game. Pass this function your own callback function which takes a [[Mod API Reference:GameStanding\|GameStanding]] as an argument. For example: <code>game.GetDistributionStanding(function(standing) print('got ' .. standing) end)</code>. Your function will be called with nil if the distribution standing is not available, for example if it's an automatic distribution game. In the event of an error, such as lack of an internet connection, your callback will not be called and instead the player will get a "Could not connect" message.		* '''GetDistributionStanding''': A function used to get the [[Mod API Reference:GameStanding\|GameStanding]] during the picking phase of this game. Pass this function your own callback function which takes a [[Mod API Reference:GameStanding\|GameStanding]] as an argument. For example: <code>game.GetDistributionStanding(function(standing) print('got ' .. standing) end)</code>. Your function will be called with nil if the distribution standing is not available, for example if it's an automatic distribution game. In the event of an error, such as lack of an internet connection, your callback will not be called and instead the player will get a "Could not connect" message.
	* '''GetStanding''': A function used to get the [[Mod API Reference:GameStanding\|GameStanding]] for any turn of the game. Pass this function two arguments: first, an integer ~~represneting~~ what turn to get (0 for the start of the game, 1 for the second turn, 2 for the third turn, etc.) Second, pass a callback function that will get called with the [[Mod API Reference:GameStanding\|GameStanding]]. ~~See GetDistributionStanding for~~ an ~~example~~.		* '''GetStanding''': A function used to get the [[Mod API Reference:GameStanding\|GameStanding]] for any turn of the game. Pass this function two arguments: first, an integer representing what turn to get (0 for the start of the game, 1 for the second turn, 2 for the third turn, etc.) Second, pass a callback function that will get called with the [[Mod API Reference:GameStanding\|GameStanding]]. In the event of an error, such as lack of an internet connection, your callback will not be called and instead the player will get a "Could not connect" message.
	* '''GetTurn''': A function used to get the [[Mod API Reference:GameTurn\|GameTurn]] for any turn of the game. Identical to GetStanding in every way, except that it calls back your function with a [[Mod API Reference:GameTurn\|GameTurn]].		* '''GetTurn''': A function used to get the [[Mod API Reference:GameTurn\|GameTurn]] for any turn of the game. Identical to GetStanding in every way, except that it calls back your function with a [[Mod API Reference:GameTurn\|GameTurn]].
	* '''Orders''' ''List<[[Mod API Reference:GameOrder\|GameOrder]]>'': Allows you to read and write the orders that the player is building up in the orders list for the current turn. You can call this property to see the orders, or assign a list of orders to it to replace the player's orders with your list.		* '''Orders''' ''List<[[Mod API Reference:GameOrder\|GameOrder]]>'': Allows you to read and write the orders that the player is building up in the orders list for the current turn. You can call this property to see the orders, or assign a list of orders to it to replace the player's orders with your list.

← Older revision		Revision as of 19:03, 17 October 2022
Line 8:		Line 8:
	* '''Settings''' ''[[Mod API Reference:GameSettings\|GameSettings]]'': The settings this game uses.		* '''Settings''' ''[[Mod API Reference:GameSettings\|GameSettings]]'': The settings this game uses.
	* '''LatestStanding''' ''[[Mod API Reference:GameStanding\|GameStanding]]'': The latest state of the game.		* '''LatestStanding''' ''[[Mod API Reference:GameStanding\|GameStanding]]'': The latest state of the game.
	* '''GetDistributionStanding''': A function used to get the [[Mod API Reference:GameStanding\|GameStanding]] during the picking phase of this game. Pass this function your own callback function which takes a [[Mod API Reference:GameStanding\|GameStanding]] as an argument. For example: <code>game.GetDistributionStanding(function(standing) print('got ' .. standing) end)</code>. Your function will be called with nil if the distribution standing is not available, for example if it's an automatic distribution game. In the event of an error, such as lack of an internet connection, your callback will not be called.		* '''GetDistributionStanding''': A function used to get the [[Mod API Reference:GameStanding\|GameStanding]] during the picking phase of this game. Pass this function your own callback function which takes a [[Mod API Reference:GameStanding\|GameStanding]] as an argument. For example: <code>game.GetDistributionStanding(function(standing) print('got ' .. standing) end)</code>. Your function will be called with nil if the distribution standing is not available, for example if it's an automatic distribution game. In the event of an error, such as lack of an internet connection, your callback will not be called and instead the player will get a "Could not connect" message.
	* '''GetStanding''': A function used to get the [[Mod API Reference:GameStanding\|GameStanding]] for any turn of the game. Pass this function two arguments: first, an integer represneting what turn to get (0 for the start of the game, 1 for the second turn, 2 for the third turn, etc.) Second, pass a callback function that will get called with the [[Mod API Reference:GameStanding\|GameStanding]]. See GetDistributionStanding for an example.		* '''GetStanding''': A function used to get the [[Mod API Reference:GameStanding\|GameStanding]] for any turn of the game. Pass this function two arguments: first, an integer represneting what turn to get (0 for the start of the game, 1 for the second turn, 2 for the third turn, etc.) Second, pass a callback function that will get called with the [[Mod API Reference:GameStanding\|GameStanding]]. See GetDistributionStanding for an example.
	* '''GetTurn''': A function used to get the [[Mod API Reference:GameTurn\|GameTurn]] for any turn of the game. Identical to GetStanding in every way, except that it calls back your function with a [[Mod API Reference:GameTurn\|GameTurn]].		* '''GetTurn''': A function used to get the [[Mod API Reference:GameTurn\|GameTurn]] for any turn of the game. Identical to GetStanding in every way, except that it calls back your function with a [[Mod API Reference:GameTurn\|GameTurn]].