MadelineProtoDocs/docs/API_docs/methods/messages.setGameScore.md

title	description	image	redirect_from
messages.setGameScore	Use this method to set the score of the specified user in a game sent as a normal message (bots only).	https://docs.madelineproto.xyz/favicons/android-chrome-256x256.png	/API_docs/methods/messages_setGameScore.html

Method: messages.setGameScore

Back to methods index

Use this method to set the score of the specified user in a game sent as a normal message (bots only).

Parameters:

Name	Type	Description	Required
edit_message	Bool	Set this flag if the game message should be automatically edited to include the current scoreboard	Optional
force	Bool	Set this flag if the high score is allowed to decrease. This can be useful when fixing mistakes or banning cheaters	Optional
peer	Username, chat ID, Update, Message or InputPeer	Unique identifier of target chat	Optional
id	int	Identifier of the sent message	Yes
user_id	Username, chat ID, Update, Message or InputUser	User identifier	Optional
score	int	New score	Yes

Return type: Updates

Can bots use this method: YES

MadelineProto Example (now async for huge speed and parallelism!):

if (!file_exists('madeline.php')) {
    copy('https://phar.madelineproto.xyz/madeline.php', 'madeline.php');
}
include 'madeline.php';

$MadelineProto = new \danog\MadelineProto\API('session.madeline');
$MadelineProto->start();

$Updates = $MadelineProto->messages->setGameScore(['edit_message' => Bool, 'force' => Bool, 'peer' => InputPeer, 'id' => int, 'user_id' => InputUser, 'score' => int, ]);

Or, if you're into Lua:

Updates = messages.setGameScore({edit_message=Bool, force=Bool, peer=InputPeer, id=int, user_id=InputUser, score=int, })

Errors

Code	Type	Description
400	MESSAGE_ID_INVALID	The provided message id is invalid
400	PEER_ID_INVALID	The provided peer id is invalid
400	USER_BOT_REQUIRED	This method can only be called by a bot