PointsService

Show Deprecated
Not Creatable
Service
Deprecated

The PointsService class controls points.

Points are an award system used to showcase a player's achievements and participation throughout Roblox. How points are awarded through this service is at the discretion of the game's developer.

Summary

Properties

Events

PointsAwarded(userId: number, pointsAwarded: number, userBalanceInGame: number, userTotalBalance: number): RBXScriptSignal  

Fires when points have been successfully awarded to a player, while also passing along the updated balance of points the player has in the current game and all games.

Methods

Properties

Events

PointsAwarded

This event fires when points have been successfully awarded to a player, while also passing along the updated balance of points the player has in the current game and all games.

When a player is awarded points successfully the below example would print the userId and their new point balance. If, for example, the Roblox account was awarded thirty points (and had none to begin with)

User: 1 has now earned 30 (+30) points in the current game, now making their total balance

would be printed.


1local function pointsAwarded(userId, pointsAwarded, userBalanceInGame, userTotalBalance)
2 print("User: " .. userId .. " has now earned " .. userBalanceInGame .. " (+" .. pointsAwarded ..") points in the current game, now making their total balance " .. userTotalBalance)
3end
4
5game:GetService("PointsService").PointsAwarded:Connect(pointsAwarded)
6

Parameters

userId: number
pointsAwarded: number
userBalanceInGame: number
userTotalBalance: number

Code Samples

PointsService.PointsAwarded

1local PointsService = game:GetService("PointsService")
2
3local function onPointsAwarded(userId, pointsAwarded, userBalanceInGame, userTotalBalance)
4 print(
5 "User:",
6 userId,
7 "has now earned",
8 userBalanceInGame,
9 "(+",
10 pointsAwarded,
11 ") points in the current game, now making their total balance",
12 userTotalBalance
13 )
14end
15
16PointsService.PointsAwarded:Connect(onPointsAwarded)

Methods