MadelineProto/docs/TD_docs/methods/setGameScore.md

---
title: setGameScore
description: Bots only. Updates game score of the specified user in the game
---
## Method: setGameScore  
[Back to methods index](index.md)


YOU CANNOT USE THIS METHOD IN MADELINEPROTO


Bots only. Updates game score of the specified user in the game

### Parameters:

| Name     |    Type       | Required | Description |
|----------|---------------|----------|-------------|
|chat\_id|[int53](../types/int53.md) | Yes|Chat a message with the game belongs to|
|message\_id|[int53](../types/int53.md) | Yes|Identifier of the message|
|edit\_message|[Bool](../types/Bool.md) | Yes|True, if message should be edited|
|user\_id|[int](../types/int.md) | Yes|User identifier|
|score|[int](../types/int.md) | Yes|New score|
|force|[Bool](../types/Bool.md) | Yes|Pass True to update the score even if it decreases. If score is 0, user will be deleted from the high scores table|


### Return type: [Message](../types/Message.md)
HUGE bugfixes and code reorganization, implemented secret chats and a lua wrapper 2017-03-11 19:54:51 +01:00			`---`
			`title: setGameScore`
			`description: Bots only. Updates game score of the specified user in the game`
			`---`
			`## Method: setGameScore`
			`[Back to methods index](index.md)`


Add TD warnings 2017-06-06 18:39:21 +02:00			`YOU CANNOT USE THIS METHOD IN MADELINEPROTO`


HUGE bugfixes and code reorganization, implemented secret chats and a lua wrapper 2017-03-11 19:54:51 +01:00			`Bots only. Updates game score of the specified user in the game`

Documentation rework (#349) * Documentation rework * Apply fixes from StyleCI * Documentation fixes * Login as bot through web/cli API, allow using invite links in joinChannel, full invite links in importChatInvite and checkChatInvite, non-invite links in importChatInvite * Apply fixes from StyleCI * Logging fixes * Build docs * Add methods to modify start template, bugfix to logging and keyboard conversion * Add TL documentator * Document MTProto methods * Documenting methods... * 7% documented * Bugfixes * Update docs * Update docs * Simplify file management * Implement automatic object conversion for media, and more awesome stuff * Implement automatic object conversion for media, and more awesome stuff * Implement event update handler and file upload/download callback * Auto-detect mime type, duration, width and height of media * Update docs * Document new file functions * Fix links * Fix links * Update bot.php to use event loop * Implement webhook update handler and forking in main loop * Build docs * Better docs * Fixes to secret chats * Almost finished updating docs * Bugfixes, implemented infinite loop for loop() method, almost finished docs * Finish writing docs * Add automatic documentation builder script * Finished writing docs 2018-03-20 12:48:05 +01:00			`### Parameters:`
HUGE bugfixes and code reorganization, implemented secret chats and a lua wrapper 2017-03-11 19:54:51 +01:00
			`\| Name \| Type \| Required \| Description \|`
AMP fixes 2017-08-20 11:05:56 +02:00			`\|----------\|---------------\|----------\|-------------\|`
docufix 2017-09-29 15:50:59 +02:00			`\|chat\_id\|[int53](../types/int53.md) \| Yes\|Chat a message with the game belongs to\|`
Update TD scheme 2017-08-25 15:05:53 +02:00			`\|message\_id\|[int53](../types/int53.md) \| Yes\|Identifier of the message\|`
HUGE bugfixes and code reorganization, implemented secret chats and a lua wrapper 2017-03-11 19:54:51 +01:00			`\|edit\_message\|[Bool](../types/Bool.md) \| Yes\|True, if message should be edited\|`
			`\|user\_id\|[int](../types/int.md) \| Yes\|User identifier\|`
			`\|score\|[int](../types/int.md) \| Yes\|New score\|`
			`\|force\|[Bool](../types/Bool.md) \| Yes\|Pass True to update the score even if it decreases. If score is 0, user will be deleted from the high scores table\|`


			`### Return type: [Message](../types/Message.md)`