Barra de Emoção

Emotes são um componente central de qualquer experiência social.O módulo EmoteBar visa fornecer aos jogadores uma maneira acessível e personalizável de facilitar a interação social significativa.

Uso do módulo

Instalação

Para usar o módulo EmoteBar em uma experiência:

1. Da aba Ver, abra a Caixa de Ferramentas e selecione a aba Loja do Criador .

   

2. Certifique-se de que a classificação Modelos está selecionada, então clique no botão Ver Todos para Categorias .

   

3. Localize e clique no tijolo Dev Modules .

   

4. Localize o módulo Barra de Emotes e clique nele, ou arraste-e-solte-o para a ver3D.

   

5. Na janela Explorer, mova todo o modelo Barra de Emoção para Serviço de Script de Servidor .Ao executar a experiência, o módulo se distribuirá a vários serviços e começará a funcionar.

   

Configuração

O módulo é pré-configurado com 7 emotes e pode ser facilmente personalizado com seus próprios emotes e opções de exibição.Além disso, se o jogador possui quaisquer emotes de eventos anteriores do Roblox, como Lil Nas X, Royal Blood ou Twenty One Pilots, esses emotes serão automaticamente adicionados à lista de emotes disponíveis.

1. Em Serviço de Script de Servidor , crie um novo Script e renomeie-o Configurar Emotes .

   

2. Cole o seguinte código no novo script ConfigurarEmotes .A configuração useDefaultEmotes de false substitui os emotes padrão e permite que você defina emotes personalizados através da função setEmotes.

   Script - Configurar Emotes
   local ReplicatedStorage = game:GetService("ReplicatedStorage")
   
   local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))
   
   EmoteBar.configureServer({
   	useDefaultEmotes = false,
   })
   
   EmoteBar.setEmotes({
   	{
   		name = "Hello",
   		animation = "rbxassetid://3344650532",
   		image = "rbxassetid://7719817462",
   		defaultTempo = 1,
   	},
   	{
   		name = "Applaud",
   		animation = "rbxassetid://5915693819",
   		image = "rbxassetid://7720292217",
   		defaultTempo = 2,
   	},
   })

Emoções mega

Um mega emote é formado quando vários jogadores na mesma área executam o mesmo emote ao mesmo tempo.À medida que mais e mais jogadores se juntam, o mega emote cresce mais.À medida que os jogadores param de executar o emote, o mega emote diminui até que, finalmente, desaparece.

Tempo

O tempo de um emote é a velocidade em que ele toca quando seu botão é tocado uma vez .A velocidade padrão de um emote é determinada por seu defaultTempo.A velocidade de um emote pode ser aumentada ou diminuída ao tocar no botão mais rápido ou mais lento.

Referência da API

Tipos

Emoção

Cada emote é representado por um dicionário com os seguintes pares de chave-valor:

Enumas

Tipo de EmoteBar.Gui

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))

EmoteBar.configureClient({
	guiType = EmoteBar.GuiType.EmoteWheel,
})

Funções

configurarServidor

Substitui as opções de configuração padrão do lado do servidor através das seguintes chaves/valores na tabela config.Essa função só pode ser chamada a partir de um Script e as alterações serão automaticamente replicadas para todos os clientes.

Script
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))

EmoteBar.configureServer({
	emoteMinPlayers = 2,
	playParticles = false,
})

configurarCliente

Substitui as opções de configuração padrão do lado do cliente através das seguintes chaves/valores na tabela config.Essa função só pode ser chamada a partir de um LocalScript .Dependendo do valor de guiType, as opções nas abas observadas também se aplicam.

LocalScript - Barra de Emoção
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))

EmoteBar.configureClient({
	guiType = EmoteBar.GuiType.EmoteBar,
	maxEmotesPerPage = 6,
	nextPageKey = Enum.KeyCode.Z,
	prevPageKey = Enum.KeyCode.C,
})

LocalScript - Roda de Emoções
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))

EmoteBar.configureClient({
	guiType = EmoteBar.GuiType.EmoteWheel,
})

setarEmotes

Define os emotes personalizados a usar.Estes serão adicionados aos padrões se useDefaultEmotes for true, ou substituir os padrões se useDefaultEmotes for false.Essa função só pode ser chamada a partir de um Script e as alterações serão automaticamente replicadas para todos os clientes.

Veja Emote para a estrutura de cada emote passado para esta função.

Script - Configurar Emotes
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))

EmoteBar.configureServer({
	useDefaultEmotes = false,
})

EmoteBar.setEmotes({
	{
		name = "Hello",
		animation = "rbxassetid://3344650532",
		image = "rbxassetid://7719817462",
		defaultTempo = 1,
	},
	{
		name = "Applaud",
		animation = "rbxassetid://5915693819",
		image = "rbxassetid://7720292217",
		defaultTempo = 2,
	},
})

definirGuiVisibilidade

Mostra ou oculta a Interface gráfica do usuáriode emotes. Essa função só pode ser chamada de um LocalScript em um cliente específico.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))

EmoteBar.setGuiVisibility(false)

pegarEmote

Obtém um Emote por nome.Retorna nil se o emote não puder ser encontrado.Essa função só pode ser chamada de um LocalScript em um cliente específico.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))

local shrug = EmoteBar.getEmote("Shrug")

jogarEmote

Reproduz o emote dado Emote e dispara o evento emotePlayed no servidor, se conectado.Essa função só pode ser chamada de um LocalScript em um cliente específico.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))

local shrug = EmoteBar.getEmote("Shrug")
EmoteBar.playEmote(shrug)

bloquearEmote

Bloqueia o Emote com o nome dado. Esta função só pode ser chamada de um LocalScript no cliente.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))

EmoteBar.lockEmote("Applaud")

desbloquearEmote

Desbloqueia o Emote com o nome dado. Esta função só pode ser chamada de um LocalScript no cliente.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))

EmoteBar.unlockEmote("Applaud")

Eventos

emoteJogado

Incêndios quando qualquer cliente toca um emote. Este evento só pode ser conectado em um LocalScript .

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))

EmoteBar.emotePlayed:Connect(function(player, emote)
	print(player.Name, "played", emote.name)
end)

lockedEmoteAtivado

Incêndios quando um cliente clica em um emote bloqueado. Este evento só pode ser conectado em um LocalScript .

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local Players = game:GetService("Players")

local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))

EmoteBar.lockedEmoteActivated:Connect(function(emote)
	print(Players.LocalPlayer, "clicked", emote.name)
end)