Barra de emotes

Os emotes são um componente essencial de qualquer experiência social. O módulo de desenvolvedor EmoteBar tem como objetivo proporcionar aos jogadores uma maneira acessível e personalizável de viabilizar interações sociais significativas.

Uso do módulo

Instalação

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

1. Na aba Exibir, abra a Caixa de ferramentas e selecione a aba Mercado.

   

2. Verifique se a ordenação de Modelos está selecionada e, em seguida, clique no botão Exibir Tudo para Categorias.

   

3. Encontre e clique no painel DEV MODULES

   

4. Localize o módulo Barra Emote e clique nele ou arraste e solte-o na visualização 3D.

   

5. Na janela do Explorador, mova todo o modelo EmoteBar para o ServerScriptService. Ao executar a experiência, o módulo será distribuído para vários serviços e começará a ser executado.

   

Configuração

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

1. Dentro do ServerScriptService, crie um novo Class. Script e renomeie-o como ConfigureEmotes.

   

2. Cole o seguinte código dentro do novo script ConfigureEmotes. A useDefaultEmotesconfiguração de falsesubstitui os emotes padrão e permite que você defina emotes personalizados por meio da função setEmotes.

   Script - ConfigureEmotes
   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,
    },
   })

Mega Emotes

Um mega emote é formado quando vários jogadores na mesma área executam o mesmo emote ao mesmo tempo. Quanto mais jogadores participam, mais o mega emote cresce. Quando os jogadores pararem de executar o emote, o mega emote diminui de tamanho até que ele desaparece.

Ritmo

O ritmo de um emote é a velocidade em que ele é executado quando o botão é pressionado uma vez. A velocidade padrão de um emote é determinada por seu defaultTempo. A velocidade de um emote pode ser aumentada ou diminuida pressionando seu botão mais rápido ou mais devagar.

Referência de API

Tipos

Emote

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

Enumeradores

EmoteBar. GuiType

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))
EmoteBar.configureClient({
    guiType = EmoteBar. GuiType. EmoteWheel,
})

Funções

configureServer

configureServer(config:table):nil

Substitui as opções de configuração padrão do cliente por meio das seguintes chaves-valores na tabela config. Essa função só pode ser chamada a partir de um Class. Scripte as alterações serão replicadas automaticamente para todos os clientes.

Script
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))
EmoteBar.configureServer({
    emoteMinPlayers = 2,
    playParticles = false,
})

configureClient

configureClient(config:table):nil

Substitui as opções de configuração do servidor por meio das seguintes chaves-valor na tabela config. Essa função só pode ser chamada a partir de um Class. Scripte as alterações serão replicadas automaticamente para todos os clientes.

Geral

EmoteBar

EmoteWheel

LocalScript - Emote Bar
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 - Emote Wheel
[`Emote`](#emote) `Datatype.RBXScriptSignal`:

setEmotes

setEmotes(emotes:table):nil

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

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

Script - ConfigureEmotes
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,
    },
})

setGuiVisibility

setGuiVisibility(visible:boolean):nil

Exibe ou oculta a interface gráfica dos emotes. Essa função só pode ser chamada a partir de um Class. LocalScript em um cliente específico.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))
EmoteBar.setGuiVisibility(false)

getEmote

getEmote(emoteName:string):table

Bloqueia o Emote com o nome dado. Essa função só pode ser chamada a partir de um Class. LocalScriptno cliente.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))
local shrug = EmoteBar.getEmote("Shrug")

playEmote

playEmote(emote:Emote):nil

Executa o Emote dado e dispara o evento emotePlayed no servidor, caso esteja conectado. Essa função só pode ser chamada a partir de um Class. 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)

lockEmote

lockEmote(emoteName:string):nil

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")

unlockEmote

unlockEmote(emoteName:string):nil

Desbloqueia o emote com o nome dado. Essa função só pode ser chamada a partir de um Class. LocalScriptno cliente.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))
EmoteBar.unlockEmote("Applaud")

Eventos

emotePlayed

emotePlayed(player:Class. Player, EmoteEmote): RBXScriptSignal

Dispara quando qualquer cliente executa um emote. O evento só pode ser conectado a um Class. LocalScript.

LocalScript
Ritmo

lockedEmoteActivated

lockedEmoteActivated(emote:Emote): RBXScriptSignal

Dispara quando um cliente clica em um emote bloqueado. O evento só pode ser conectado a um Class. 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)