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

Dieser Dienst steuert das Punktsystem, das verwendet wird, um die Erfolge und Teilnahme eines Spieler:inin Roblox anzuzeigen.

Ein `Class.Actor` ist ein Container für Code, der sicher in seinem eigenen Thread aufgeteilt werden kann.

Class

Actor

Luau

Array

Dictionary

Halten Sie den Konstruktor für Instanzen.

Data Type

Ein Objekt, das bei einem bestimmten Ereignis verbundene Funktionen ausführt.

RBXScriptSignal

Tuple

Variant

Datentyp mit einem Wert von "wahr" oder "falsch".

bool

Eine doppelte Präzisionsschwimmkomma-Zahl.

number

Eine Reihe von Zeichen, wie Buchstaben, Zahlen und Symbole.

string

void

Übersicht

Anleitungen

Tutorials

Referenz

Ressourcen

Kunst

Design

Engine

Avatar

Legacy

Cloud

Diese Methode ist asynchron und gibt eine `Operation` zurück, die den aktuellen Status der Operation darstellt. Sie enthält einen Endpunktpfad, den du abfragen kannst, um die tatsächliche Antwort und die entsprechenden Metadaten zu erhalten. Weitere Informationen findest du in der [Dokumentation]({longRunningOperationsLink}).

Die folgenden Abschnitte beschreiben die Antwort- und Metadatenobjekte, die bereitgestellt werden, wenn eine Operation abgeschlossen ist.

Beta-Endpunkte sind bereit für die öffentliche Nutzung. Bahnbrechende Änderungen sind möglich, aber selten.

Dieses Feld kann beim Erstellen einer Ressource festgelegt werden, kann jedoch durch spätere Anfragen nicht geändert werden.

Dieses Feld kann in Anfragen zur Verfügung gestellt werden, wird aber niemals in Antworten enthalten sein.

Pro API-Schlüssel: {maxInPeriod} Anfoderungen pro {periodInSeconds} Sekunden pro IP-Adresse

Dieses Feld kann in Antworten zur Verfügung gestellt werden, wird aber bei Anfragen ignoriert.

Die folgenden API-Schlüssel-Berechtigungen werden benötigt, um diesen Endpunkt aufzurufen. Für weitere
Informationen zur Erzeugung korrekter Schlüssel siehe [API-Schlüssel verwalten]({apiKeyReferenceDocLink}).

Die folgenden Endpunkte sind bei Pfaden relativ zur Basis-URL verfügbar.

Dieser String ist als [FieldMask](/cloud/reference/types#fieldmask) formatiert.

Ein JSON-Wert kann `null`, `boolean`, `string`, `number`, `array` oder `object` sein.

Um diesen Endpunkt nutzen zu können, werden folgende Anwendungsbereiche für deine OAuth 2.0 App benötigt. Weitere Informationen zur Registrierung einer OAuth 2.0-App findest du unter [App Registration and Review]({oauth2ReferenceDocLink}).

Die folgenden Objekte beschreiben Nutzlasten, die akzeptiert oder zurückgegeben werden. Die einzelnen Endpunkte zeigen weitere Informationen darüber an, wann diese Objekte verwendet werden.

Dieser String ist als [Zeitstempel](/cloud/reference/types#timestamp) formatiert.

Dies ermöglicht das Anzeigen von Informationen über deine Objekte.

Dies ermöglicht das Hochladen und Aktualisieren von Objekten auf Roblox.

Bietet die Möglichkeit, die Abzeichen des Nutzers zu aktualisieren.

Dies ermöglicht das Anzeigen von Informationen über deine Handelsartikel.

Dies ermöglicht das Bearbeiten deiner Kommerzhändlerverbindungen.

Hiermit kannst du Informationen zu deinen Creator-Store-Produkten ansehen.

Hiermit kannst du Informationen zu deinen Creator-Store-Produkten ändern.

Dies ermöglicht das Anzeigen von Informationen über deine Gruppen.

Damit kannst du Gruppenbeitrittsanfragen für dein Konto verwalten.

Dies ermöglicht das Anzeigen von Informationen über dein Inventar.

Gewährt Zugriff auf die Verwaltung deiner Abzeichen.

Gewährt Zugriff auf die Verwaltung deiner Abzeichen und das Ausgeben von Robux.

Gewährt Zugriff auf die Verwaltung deiner Entwicklerprodukte.

Gewährt Zugriff zum Lesen von Informationen über die Erlebnisse, denen du folgst.

Gewährt Zugriff zum Folgen und Entfolgen von Erlebnissen in deinem Namen.

Gewährt Zugriff auf die Verwaltung deiner Pässe.

Gewährt Zugriff auf die Verwaltung deiner Gruppen.

Gewährt die Erlaubnis, Gruppeninformationen zu lesen.

Gewährt Gruppenverwaltungsberechtigungen.

Gewährt Zugriff zum Lesen und Schreiben deiner Lokalisierungstabellen

Gewährt Zugriff auf die Verwaltung der Teamzusammenarbeit für alle deine Erlebnisse.

Gewährt Zugriff auf die Verwaltung deiner Erlebnisse und bestimmte Informationen, die mit deinem Erlebnis verbunden sind (z.B. Lokalisierungsinformationen).

Gewährt Zugriff zum Lesen der Lokalisierungsinformationen deiner Erlebnisse.

Gewährt Zugriff zum Ändern der Lokalisierungspräferenzen deiner Erlebnisse.

Gewährt Zugriff auf die Verwaltung deines Nutzerkontos.

Gewährt Zugriff zum Ändern der Lokalisierungspräferenzen des Nutzers.

Dies gewährt die Fähigkeit, Nachrichten im Namen von Nutzern zu veröffentlichen.

Damit können Benachrichtigungen an Nutzer von deinem Erlebnis aus gesendet werden.

Damit kannst du Geheimnisse auflisten, die mit deinem Erlebnis verbunden sind.

Damit kannst du Geheimnisse erstellen und aktualisieren, die mit deinem Erlebnis verbunden sind.

Ermöglicht den Zugriff auf deine Abonnementprodukte.

Gewährt die Fähigkeit, Ortsinformationen zu lesen.

Gewährt die Fähigkeit, Ortsinformationen zu bearbeiten.

Dieser Vorgang ermöglicht den Zugriff, neue Versionen von Erlebnissen auf Roblox zu veröffentlichen.

Gewährt die Fähigkeit, Erlebnisinformationen zu lesen.

Gewährt die Fähigkeit, Erlebnisinformationen zu bearbeiten.

Ermöglicht es dir, Benutzerbeschränkungen im Erlebnis zu sehen.

Ermöglicht es dir, Benutzerbeschränkungen im Erlebnis zu bearbeiten.

Gewährt die Fähigkeit, den Premium- und Verifizierungs-Status der Nutzer zu lesen.

Hiermit kannst du die sozialen Konten von Nutzern ansehen.

Dies aktiviert Single Sign-On-Funktionalität.

Dies gewährt Zugriff auf das Lesen deiner Profilinformationen.

Standardwert: {defaultValueStart}{defaultValueEnd}

Ein Array ist eine geordnete Liste von Werten. Arrays sind nützlich, um Sammlungen von Daten zu speichern.

Eine Reihe von Schlüsselwertpaaren, bei denen die Schlüssel eine beliebige Zahl, eine Zeichenkette oder ein Objekt sein können.

Diese Funktion gibt, wenn möglich, sofort zurück, kann aber den Thread anhalten, der ihn aufgerufen hat, bis er einen Wert zurückgeben kann.

{nameStart}Name{nameEnd} wird nicht mehr von Roblox unterstützt oder gewartet.

Diese mathematische Operation wird von Roblox nicht mehr unterstützt oder gewartet.

Dieses Mitglied erscheint nicht im Objektbrowser und ist nicht für den weitverbreiteten Gebrauch bestimmt.

Dieses Mitglied ist nur über die Befehlsleiste zugänglich. Der Versuch, auf dieses Mitglied über Skripte zuzugreifen, verursacht einen Fehler.

Diese Funktion kann den Lua-Thread nicht pausieren, der ihn aufgerufen hat.

Der Versuch, auf dieses Mitglied in Skripten zuzugreifen, führt zu einem Fehler. Möglicherweise hast du Zugriff auf dieses Mitglied über Roblox Studios Eigenschaftenfenster.

Dieses Mitglied erscheint nicht im Objektbrowser von Roblox Studio.

Du kannst keine Instanz dieser Klasse mit dem Instance.new Konstruktor erstellen.

Roblox repliziert dieses Mitglied nicht über seine Server-Client-Grenze.

Der Lua-Code kann nicht auf dieses Mitglied zugreifen. Möglicherweise kannst du seinen Wert von dem Eigenschaftenfenster von Roblox Studio aus ändern.

Dieses Mitglied ist über OpenCloud-Luau-Ausführungsaufgaben zugänglich.

Das Replikationsverhalten dieses Objekts hängt vom Spieler bzw. der Spielerin ab, der oder die es besitzt.

Dieses Mitglied ist über die Befehlsleiste und über Plugins zugänglich. Der Versuch, auf dieses Mitglied über Skripte zuzugreifen, verursacht einen Fehler.

Dieses Mitglied kann nur gelesen werden. Der Versuch, an dieses Mitglied zu schreiben, verursacht einen Fehler.

Diese Eigenschaft ist schreibgeschützt und kann sicher in nicht synchronisierten Threads gelesen werden. Der Versuch, darauf zu schreiben, verursacht einen Fehler.

Dieses Mitglied ist nur in CoreScripts zugänglich.

Nur Roblox-CoreScripts können auf dieses Mitglied zugreifen und es ist für Spieler nicht verwendbar.

Du kannst diese Eigenschaft sicher aus mehreren Threads lesen und darauf schreiben.

Diese Klasse ist ein Top-Level-Singleton. Rufe eine Instanz dieser Klasse mit der GetService-Funktion ab.

Mehrere Threads können möglicherweise in diese Eigenschaft schreiben, so dass es unsicher ist, aus nicht synchronisierten Threads zu lesen.

Diese Funktion pausiert den Lua-Thread, der ihn aufgerufen hat, bis er ein Ergebnis zurückgibt. Dies unterbricht keine anderen Skripts.

PointsService

Zusammenfassung

Eigenschaften

Methoden

Ereignisse

Eigenschaften

Methoden

Ereignisse

PointsAwarded

Parameter

Code-Beispiele