# 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');

$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
This site uses cookies, as described in the cookie policy. By clicking on "Accept" you consent to the use of cookies.