Emoções

Emotes são animações expressivas de personagens que são acessíveis usando comandos de chat ("/e cheer") ou acessando o menu de emotes no topo direito de qualquer experiência.Todos os usuários têm acesso a emotes padrão, como dança , ponto e alegria .Emotes de avatar adicionais podem ser comprados e equipados a partir do Mercado.

Na sua experiência, você pode realizar as seguintes personalizações de emote:

• Abrir e fechar um programa de menu de emotes de um usuário programaticamente.
• Adicionar ou remover opções de emotes do menu de um usuário.
• Desabilite o acesso ao menu.
• Jogue um emote, direcionando um personagem de usuário específico.

Menu de emoções

Você pode abrir e fechar o menu de emotes de um usuário manualmente, personalizar o menu para exibir emotes específicos ou desativar o menu completamente.

Abrir e fechar

Para abrir ou fechar manualmente o menu de emotes de um jogador, chame GuiService:SetEmotesMenuOpen() com um valor booleano de verdadeiro ou falso.

O seguinte exemplo de código abrirá o menu de emotes para o usuário:

-- Abra o menu de emotes
local GuiService = game:GetService("GuiService")
GuiService:SetEmotesMenuOpen(true)

Se você precisar detectar se o menu de emotes está aberto, chame GuiService:GetEmotesMenuOpen(). Isso retorna um booleano que indica o estado atual do menu.

Adicionar e remover emotes

Personalize o menu de emotes definindo emotes do catálogo e depois equipando emotes para um Humanoid .Defina emotes com o método HumanoidDescription:SetEmotes() e equipe até 8 emotes para o menu de emotes usando HumanoidDescription:SetEquippedEmotes().

Use o seguinte exemplo de código em um dentro da pasta para definir e equipar emotes em sua experiência:

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

-- Defina emotes personalizados dentro de uma tabela
local emoteTable = {
  ["Hello"] = {3576686446},
  ["Stadium"] = {3360686498},
  ["Tilt"] = {3360692915},
  ["Shrug"] = {3576968026},
  ["Salute"] = {3360689775},
  ["Point"] = {3576823880}
}
humanoidDescription:SetEmotes(emoteTable)

-- Equipar emotes em uma ordem específica
local equippedEmotes = {"Hello", "Stadium", "Tilt", "Shrug", "Salute", "Point"}
humanoidDescription:SetEquippedEmotes(equippedEmotes)

Desativar

Desabilite o menu de emotes com StarterGui:SetCoreGuiEnabled() . Desabilitar o menu de emotes não impedirá que os emotes sejam executados com um comando de chat.

O seguinte código de amostra desabilitará o menu de emotes:

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

Além de desabilitar o menu, você pode desabilitar o carregamento de emotes de propriedade do usuário definindo a propriedade StarterPlayer.UserEmotesEnabled dentro de StarterPlayer > Personagem para falso .Essa propriedade específica só pode ser definida no Studio e não pode ser definida por scripts.

Jogar emotes

Para tocar manualmente um emote que um personagem tem em seu HumanoidDescription, chame Humanoid:PlayEmote(), passando o nome da string do emote.Essa chamada retornará verdadeiro para indicar que o emote foi tocado com sucesso, ou falso caso contrário.

Use o seguinte exemplo de código para reproduzir o emote Shrug:

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

humanoid:PlayEmote("Shrug")