Emotes

Emotes sind ausdrucksstarke Charakter- Animationen, die durch die Verwendung von Chatbefehlen ("/e cheer") oder durch den Zugriff auf das Emotes-Menü oben rechts in jedem Spiel zugänglich sind. Alle Benutzer haben Zugriff auf Standard-Emotes wie dance, point und cheer. Weitere Avatar-Emotes können im Marketplace erworben und ausgestattet werden.

In Ihrem Spiel können Sie die folgenden Emote-Anpassungen vornehmen:

• Öffnen und Schließen des Emotes-Menüs eines Benutzers programmgesteuert.
• Hinzufügen oder Entfernen von Emote-Optionen aus dem Menü eines Benutzers.
• Deaktivieren des Zugriffs auf das Menü.
• Abspielen eines Emotes, das auf einen bestimmten Benutzercharakter abzielt.

Emotes-Menü

Sie können das Emote-Menü eines Benutzers manuell öffnen und schließen, das Menü anpassen, um spezifische Emotes anzuzeigen, oder das Menü komplett deaktivieren.

Öffnen und Schließen

Um das Emote-Menü eines Spielers manuell zu öffnen oder zu schließen, rufen Sie GuiService:SetEmotesMenuOpen() mit einem booleschen Wert von true oder false auf.

Das folgende Codebeispiel öffnet das Emote-Menü für den Benutzer:

-- Öffne das Emote-Menü
local GuiService = game:GetService("GuiService")
GuiService:SetEmotesMenuOpen(true)

Wenn Sie erkennen müssen, ob das Emotes-Menü geöffnet ist, rufen Sie GuiService:GetEmotesMenuOpen() auf. Dies gibt einen booleschen Wert zurück, der den aktuellen Status des Menüs angibt.

Hinzufügen und Entfernen von Emotes

Passen Sie das Emote-Menü an, indem Sie Emotes aus dem Katalog festlegen und dann Emotes an einem Humanoid ausstatten. Setzen Sie Emotes mit der Methode HumanoidDescription:SetEmotes() und statten Sie bis zu 8 Emotes im Emote-Menü mit HumanoidDescription:SetEquippedEmotes() aus.

Verwenden Sie das folgende Codebeispiel in einem LocalScript im Ordner StarterCharacterScripts, um Emotes in Ihrem Spiel festzulegen und auszustatten:

local Players = game:GetService("Players")
local humanoid = Players.LocalPlayer.Character.Humanoid
local humanoidDescription = humanoid.HumanoidDescription

-- Setze benutzerdefinierte Emotes innerhalb einer Tabelle
local emoteTable = {
  ["Hello"] = {3576686446},
  ["Stadium"] = {3360686498},
  ["Tilt"] = {3360692915},
  ["Shrug"] = {3576968026},
  ["Salute"] = {3360689775},
  ["Point"] = {3576823880}
}
humanoidDescription:SetEmotes(emoteTable)

-- Statte Emotes in einer bestimmten Reihenfolge aus
local equippedEmotes = {"Hello", "Stadium", "Tilt", "Shrug", "Salute", "Point"}
humanoidDescription:SetEquippedEmotes(equippedEmotes)

Deaktivieren

Deaktivieren Sie das Emotes-Menü mit StarterGui:SetCoreGuiEnabled(). Das Deaktivieren des Emotes-Menüs verhindert nicht, dass Emotes über einen Chatbefehl ausgeführt werden.

Das folgende Beispielcode deaktiviert das Emotes-Menü:

local StarterGui = game:GetService("StarterGui")
StarterGui:SetCoreGuiEnabled(Enum.CoreGuiType.EmotesMenu, false)

Zusätzlich zur Deaktivierung des Menüs können Sie das Laden von benutzerbesessenen Emotes deaktivieren, indem Sie die Eigenschaft StarterPlayer.UserEmotesEnabled innerhalb von StarterPlayer ⟩ Character auf false setzen. Diese spezifische Eigenschaft kann nur im Studio festgelegt und nicht durch Skripte geändert werden.

Emotes abspielen

Um ein Emote, das ein Charakter in seiner HumanoidDescription hat, manuell abzuspielen, rufen Sie Humanoid:PlayEmote(), wobei Sie den String-Namen des Emotes übergeben. Dieser Aufruf gibt true zurück, um anzuzeigen, dass das Emote erfolgreich abgespielt wurde, oder false, wenn nicht.

Verwenden Sie das folgende Codebeispiel, um das Shrug-Emote abzuspielen:

local Players = game:GetService("Players")
local humanoid = Players.LocalPlayer.Character.Humanoid

humanoid:PlayEmote("Shrug")