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 30" would be
printed.


PointsService.PointsAwarded

userId

pointsAwarded

userBalanceInGame

userTotalBalance

PointsService:GetAwardablePoints

The below example would attempt to award 5 points to the Roblox account. If
the account had been awarded 10 points before, it would print "The user was
awarded 5 points. They have now a total of 15 points in this game.".


PointsService:AwardPoints

amount

PointsService:GetGamePointBalance

PointsService:GetPointBalance

PointsService

Demonstrates detecting changes to an instance's ancestry by connecting to the `Class.Instance.AncestryChanged` event.

The ChangingPart's Parent is set to different values overtime. The parent of the part is the part's ancestor, so the `Class.Instance.AncestryChanged` event will fire whenever it changes.


Instance.AncestryChanged

child

parent

Instance.AttributeChanged

attribute

This snippet prints the names of objects as they are added to the Workspace:


Instance.ChildAdded

This snippet prints the names of objects as they are removed from the
Workspace:


Instance.ChildRemoved

This following example will print the name of any object that is added to the
Workspace:


Instance.DescendantAdded

descendant

The following example prints the name of any descendant as it is being removed
from the Workspace:


Instance.DescendantRemoving

This sample demonstrates how, when using Immediate signal behavior, an Instance being destroyed remains in place until the connected function yields.


This sample demonstrates how, when using Deferred signal behavior,
an Instance is destroyed before the signal fires.


Instance.Destroying

Instance.childAdded

Instance:AddTag

This example creates a Part and adds a few sparkle objects to the part. Then
it calls Part:ClearAllChildren() to remove all of the children.


Instance:ClearAllChildren

Demonstrates cloning a model using `Class.Instance:Clone()`.

Instance:Clone

Demonstrates destroying a Part using the `Class.Instance:Destroy()` function.

This function is the correct way to dispose of objects that are no longer required.


Instance:Destroy

Instance:FindFirstAncestor

name

Instance:FindFirstAncestorOfClass

className

Instance:FindFirstAncestorWhichIsA

The below would look in Workspace for an object name "Brick". If found, it
will change the name of the object to "Foo".


Instance:FindFirstChild

recursive

Instance:FindFirstChildOfClass

Instance:FindFirstChildWhichIsA

Instance:FindFirstDescendant

Instance:GetActor

Instance:GetAttribute

Instance:GetAttributeChangedSignal

Instance:GetAttributes

The below would print the name of all objects currently in Workspace when ran.


Instance:GetChildren

Instance:GetDebugId

scopeLength

GetDescendants is often used to do something to all the descendants that are a
particular type of object. The code in this example uses GetDescendants and
`Class.Instance:IsA()` to find all of the parts in the workspace and turns
them green.


Instance:GetDescendants

This code sample demonstrates the behavior of `Class.Instance:GetFullName()`.
It shows how the function behaves when called on an object not in the
`DataModel` hierarchy, and it also shows how the return value does not escape
special characters.


This code sample re-implements the `Class.Instance:GetFullName()` function in
Lua.


Instance:GetFullName

Instance:GetStyled

Instance:GetTags

Instance:HasTag

Demonstrates determining if one instance is the ancestor of another using `Class.Instance:IsAncestorOf()`

Workspace and SpawnLocation are ancestors of the SpawnLocation's decal.
Workspace is an ancestor of SpawnLocation.

SpawnLocation and its decal are descendants of Workspace, not ancenstors.
Decal is a descendant to SpawnLocation, not an ancestor.


Instance:IsAncestorOf

Instance:IsDescendantOf

ancestor

The following code demonstrates how a part can be re-added to the DataModel
after being removed:


Instance:Remove

Instance:RemoveTag

Instance:SetAttribute

value

The following code waits for an instance named "Part" to be added to
Workspace.


Instance:WaitForChild

childName

timeOut

Instance:children

Instance:clone

Instance:destroy

Instance:findFirstChild

Instance:getChildren

Instance:isDescendantOf

Instance:remove

Instance

Instance.Archivable

Instance.Capabilities

Instance.Name

Instance.Parent

Instance.RobloxLocked

Instance.Sandboxed

Instance.UniqueId

Instance.archivable

This sample demonstrates the subtleties of the Changed event on normal objects
and "-Value" objects.


This code sample demonstrates the Changed event firing within a parent object.


Object.Changed

property

This code sample demonstrates how to save a value before a changed event fires
on it in order to get more information about a change.


This code sample demonstrates the equivalence of the `Changed` event and event
returned by `GetPropertyChangedSignal`.


Object:GetPropertyChangedSignal

Demonstrates determining the class of Workspace using `Class.Instance:IsA()`

Workspace is of class 'Workspace', so the first statement is true.
Workspace is not of class 'BasePart', so the second statement is false.
Workspace inherits from Instance and therefore is of class 'Instance', so the third statement is true.


Object:IsA

Object:isA

Object

Object.ClassName

Object.className

/reference/engine/classes/PointsService.yaml

Bu hizmet, bir oyuncunun başarılarını ve katılımlarını Roblox'un boyunca göstermek için kullanılan puan ödüllendirme sistemini kontrol eder.

Bir `Class.Actor`, kendi içindeki kodları güvenli bir şekilde bölümlere ayırabilen bir kod konteynır.

Class

Actor

Luau

Array

Dictionary

Data Type

Belirli bir olaya bağlı işlevleri yürütmeye çalışan bir nesne.

RBXScriptSignal

Tuple

Variant

Açık veya kapalı bir değer olan veri tipi.

bool

number

Harfler, sayılar ve semboller gibi karakterlerin bir dizi.

string

void

Genel Bakış

Kılavuzlar

Öğreticiler

Referans

Kaynaklar

Sanat

Tasarım

Motor

Avatar

Eski

Bulut

Eş zamansız olan bu yöntem, işlemin geçerli durumunu temsil eden bir `Operation` döndürür Gerçek yanıtı ve uygulanabilir üst verileri elde etmek için yoklayabileceğin bir uç nokta yolu içerir. Daha fazla bilgi için uzun süreli işlemlerle ilgili [dokümantasyonu]({longRunningOperationsLink}) incele.

Aşağıdaki kısımlar, bir işlem tamamlandığında sağlanan yanıt ve üst veri nesnelerini tanımlar.

Beta uç noktaları herkesin kullanımına açıldı. Kesme değişiklikleri mümkün olsa da nadir görülür.

Bu alan, kaynak oluşturulurken ayarlanabilir ama sonraki taleplerde düzenlenemez.

Bu alan, taleplerde sağlanabilir ancak yanıtlara asla dâhil edilmez.

API Anahtarı başına: Her {periodInSeconds} saniyede IP adresi başına {maxInPeriod} talep

Bu alan, yanıtlar için ayarlanabilir ancak isteklerde göz ardı edilir.

Bu uç noktasının çağrılması için aşağıdaki API anahtarı izinleri gerekir. Doğru anahtar üretimi hakkında daha fazla bilgi için [API Anahtarı Yönetimi]({apiKeyReferenceDocLink}) sayfasını incele.

Şu uç noktaları, taban URL'ye göre belirlenen yollarda mevcut.

Bu dizi [FieldMask](/cloud/reference/types#fieldmask) olarak biçimlendirilmiş.

JSON değeri `null`, `boolean`, `string`, `number`, `array` ya da `object` olabilir.

Bu uç noktasının kullanılması adına OAuth 2.0 uygulaman için aşağıdaki kapsamlar gerekir. OAuth 2.0 uygulamanı nasıl kaydettireceğin hakkında daha fazla bilgi için [Uygulama Kaydı ve İncelemesi]({oauth2ReferenceDocLink}) sayfasını incele.

Şu nesneler kabul edilen veya döndürülen yükleri tanımlar. Bu nesnelerin ne zaman kullanıldığı hakkında daha fazla bilgi için tüm uç noktalara bak.

Bu dizi [Timestamp](/cloud/reference/types#timestamp) olarak biçimlendirilmiş.

This allows viewing information about your assets.

This allows uploading and updating assets to Roblox.

Grants the ability to update badges owned by the user.

This allows viewing information about your commerce items.

This allows editing of your commerce merchant connections.

This allows you to view information about your Creator Store products.

This allows you to modify information about your Creator Store products.

This allows viewing information about your communities.

This allows you to manage community join requests and role updates for your account.

This allows viewing information about your inventory.

Grants access to mange your badges and spend robux.

Grants access to manage your developer products.

Grants access to read information about the experiences you follow.

Grants access to follow and unfollow experiences on your behalf.

Grants access to manage your communities.

Grants permission to read community information.

Grants access to read and write your localization tables

Grants access to manage team collaboration for all experiences you own.

Grants access to manage your experiences and certain information associated with your experiences (e.g. localization information).

Grants access to read your experiences' localization information.

Grants access to modify your experiences' localization preferences.

Grants access to manage your user account.

Grants access to modify user localization preferences.

This grants the ability to publish messages on behalf of users.

This allows sending notifications from your experience to users.

This allows listing secrets associated with your experience.

This allows creating and updating secrets associated with your experience.

Grants access to read about your subscription products.

Grants the ability to read place information.

Grants the ability to edit place information.

This operation grants access to publish new versions of experiences to Roblox.

Grants the ability to read experience information.

Grants the ability to edit experience information.

Allows you to view user restrictions in the experience.

Allows you to edit user restrictions in the experience.

Grants the ability to read user's premium and verified status.

This allows you to view a user's social accounts.

This enables Single Sign-On functionality.

This grants access to read your profile information.

Varsayılan değer: {defaultValueStart}{defaultValueEnd}

Dizi, değerlerin sıralandığı bir listedir. Diziler veri koleksiyonlarını depolamakta kullanışlıdır.

Anahtarların herhangi bir sayı, dizi ya da nesne olabileceği anahtar ve değer çiftleri seti.

Bu işlev, mümkünse anında döndürür ama kendisini çağıran iş parçacığını değer döndürene kadar bekletebilir.

{nameStart}ad{nameEnd} artık Roblox tarafından desteklenmiyor ve sürdürülmüyor.

Bu matematik işlemi artık Roblox tarafından desteklenmiyor ve sürdürülmüyor.

Bu üye, nesne tarayıcısında görünmüyor ve genel kullanım için değil.

Bu üyeye yalnızca komut çubuğu üzerinden erişilebilir. Üyeye betiklerden erişmeye çalışmak hataya yol açar.

Bu işlev kendisini çağıran Lua iş parçacığını duraklatamaz.

Bu üyeye betiklerden erişmeye çalışmak hataya yol açar. Üyeye Roblox Studio'nun özellikler penceresinden erişmen mümkün olabilir.

Bu üye, Roblox Studio'nun Nesne Tarayıcısı'nda görünmüyor.

Instance.new yapılandırıcısıyla bu sınıfın yeni bir örneğini yaratamazsın.

Roblox, bu üyeyi sunucu istemci sınırında çoğaltmaz.

Lua kodu bu üyeye erişemiyor. Üyenin değerini Roblox Studio'nun özellik penceresinden değiştirmen mümkün olabilir.

Bu üyeye OpenCloud Luau yürütme görevlerinden erişilebilir.

Bu nesnenin çoğalma davranışı, sahibi olan oyuncuya bağlı.

Bu üyeye komut çubuğu ve eklentiler üzerinden erişilebilir. Üyeye betiklerden erişmeye çalışmak hataya yol açar.

Bu üye salt okunur. Üyeye yazmaya çalışmak hataya yol açar.

Bu özellik salt okunurdur ve senkronizasyonsuz iş parçacıklarında bu özelliğin okunması güvenlidir. Özelliğe yazmaya çalışmak hataya yol açar.

Bu üyeye yalnızca CoreScripts üzerinden erişilebilir.

Bu üyeye yalnızca Roblox CoreScripts erişebilir ve üye, Oyuncular tarafından kullanılamaz.

Bu özelliğin birden fazla iş parçacığından güvenli bir şekilde okunması ve üzerine yazılması mümkündür.

Bu sınıf en üst düzey bir tekil. GetService işleviyle bu sınıfın bir örneğini al.

Çoklu iş parçacıkları bu özelliğe yazabileceğinden senkronizasyonsuz iç parçacıklarından okumak güvenli değildir.

Bu işlev, kendisini çağıran iş parçacığını değer döndürene kadar duraklatabilir. Bu, diğer betiklerin işleyişini durdurmaz.

PointsService

Özet

Özellikler

Yöntemler

Etkinlikler

Özellikler

Yöntemler

Etkinlikler

PointsAwarded

Parametreler

Kod Örnekleri