PointsService
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
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
Code Samples
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)