Emotes

Emotes zijn expressieve karakter animaties die toegankelijk zijn door chatopdrachten te gebruiken ("/e cheer") of door toegang te krijgen tot het emotes-menu rechtsboven in elk spel. Alle gebruikers hebben toegang tot standaard emotes, zoals dance, point en cheer. Extra avatar emotes kunnen worden gekocht en uitgerust vanuit de Marketplace.

In jouw spel kun je de volgende emote-aanpassingen uitvoeren:

• Open en sluit het emotes-menu van een gebruiker programmatically.
• Voeg toe of verwijder emote-opties uit het menu van een gebruiker.
• Schakel de toegang tot het menu uit.
• Speel een emote, gericht op een specifieke gebruikerskarakter.

Emotes-menu

Je kunt het emotes-menu van een gebruiker handmatig openen en sluiten, het menu aanpassen om specifieke emotes weer te geven, of het menu volledig uitschakelen.

Open en sluit

Om het emotes-menu van een speler handmatig te openen of te sluiten, roep je GuiService:SetEmotesMenuOpen() aan met een boolean waarde van true of false.

De volgende codevoorbeeld opent het emotes-menu voor de gebruiker:

-- Open het emote-menu
local GuiService = game:GetService("GuiService")
GuiService:SetEmotesMenuOpen(true)

Als je moet detecteren of het emotes-menu open is, roep je GuiService:GetEmotesMenuOpen() aan. Dit retourneert een boolean die de huidige staat van het menu aangeeft.

Voeg emotes toe en verwijder ze

Pas het emotes-menu aan door emotes uit de catalogus in te stellen en vervolgens emotes uit te rusten op een Humanoid. Stel emotes in met de HumanoidDescription:SetEmotes() methode en rust tot 8 emotes uit in het emotes-menu met HumanoidDescription:SetEquippedEmotes().

Gebruik de volgende codevoorbeeld in een LocalScript binnen de StarterCharacterScripts map om emotes in jouw spel in te stellen en uit te rusten:

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

-- Stel aangepaste emotes in binnen een tabel
local emoteTable = {
  ["Hello"] = {3576686446},
  ["Stadium"] = {3360686498},
  ["Tilt"] = {3360692915},
  ["Shrug"] = {3576968026},
  ["Salute"] = {3360689775},
  ["Point"] = {3576823880}
}
humanoidDescription:SetEmotes(emoteTable)

-- Rust emotes uit in een specifieke volgorde
local equippedEmotes = {"Hello", "Stadium", "Tilt", "Shrug", "Salute", "Point"}
humanoidDescription:SetEquippedEmotes(equippedEmotes)

Uitschakelen

Schakel het emotes-menu uit met StarterGui:SetCoreGuiEnabled(). Het uitschakelen van het emotes-menu voorkomt niet dat emotes worden uitgevoerd met een chatopdracht.

De volgende voorbeeldcode schakelt het emotes-menu uit:

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

Naast het uitschakelen van het menu, kun je het laden van door gebruikers bezette emotes uitschakelen door de StarterPlayer.UserEmotesEnabled eigenschap binnen StarterPlayer ⟩ Character in te stellen op false. Deze specifieke eigenschap kan alleen in Studio worden ingesteld en kan niet door scripts worden ingesteld.

Speel emotes

Om handmatig een emote te spelen die een karakter in zijn HumanoidDescription heeft, roep je Humanoid:PlayEmote(), waarbij je de stringnaam van de emote doorgeeft. Deze aanroep retourneert true om aan te geven dat de emote succesvol is afgespeeld, of false anders.

Gebruik de volgende codevoorbeeld om de Shrug-emote te spelen:

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

humanoid:PlayEmote("Shrug")