Barra de emotes

Los emotes son un componente central de cualquier experiencia social. El módulo de desarrolladores EmoteBar tiene como objetivo proporcionar a los jugadores una forma accesible y personalizable para facilitar una interacción social significativa.

Uso del módulo

Instalación

Sigue estos pasos para usar el módulo EmoteBar en una experiencia:

1. En la pestaña Ver, abre la Caja de herramientas y selecciona la pestaña Mercado.

   

2. Asegúrate de que la clasificación de Modelos esté seleccionada y, a continuación, haz clic en el botón Ver todo para las Categorías.

   

3. Busca y haz clic en el mosaico MÓDULOS DE DESARROLLADORES.

   

4. Busca el módulo Barra de emotes y haz clic en él o arrástralo y suéltalo en la vista 3D.

   

5. En la ventana del Explorador, mueve todo el modelo de EmoteBar a ServerScriptService. Al ejecutar la experiencia, el módulo se distribuirá a varios servicios y comenzará a ejecutarse.

   

Configuración

El módulo está preconfigurado con 7 emotes y se puede personalizar fácilmente con tus propios emotes y opciones de visualización. Además, si el jugador posee algún gesto de eventos anteriores de Roblox, como Lil Nas X, Royal Blood o Twenty One Pilots, esos emotes se añadirán automáticamente a la lista de emotes disponibles.

1. Dentro de ServerScriptService, crea un nuevo Scripty cámbiale el nombre a ConfigureEmotes.

   

2. Pega el siguiente código en el script nuevo ConfigureEmotes. La useDefaultEmotesconfiguración falsede reemplaza los emoticones predeterminados y te permite definir emoticones personalizados con la función 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,
   	},
   })

Emoticones Mega

Se forma un mega emote cuando varios jugadores en la misma área ejecutan el mismo emote al mismo tiempo. A medida que más y más jugadores se unen, el mega emote crece. A medida que los jugadores dejan de usar el emote, este se hace más pequeño hasta que finalmente desaparece.

Tempo

El tempo de un emote es la velocidad a la que se reproduce cuando se toca su botón una vez. La velocidad predeterminada de un emote está determinada por su defaultTempo. La velocidad de un emote se puede aumentar o disminuir al tocar su botón más rápido o más lento.

Referencia API

Tipos

Emote

Cada emote está representado por un diccionario con los siguientes pares clave-valor:

Enumeraciones

EmoteBar.GuiType

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

Funciones

configureServer

configureServer(config:table):nil

Reemplaza las opciones de configuración predeterminadas del lado del servidor a través de los siguientes claves/valores de la configtabla . A esta función solo se puede acceder desde unScript y los cambios se replicarán automáticamente en todos los clientes.

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

configureClient

configureClient(config:table):nil

Invalida la configuración predeterminada del lado del cliente mediante los siguientes claves/valores de la configtabla. A esta función solo se puede acceder desde unLocalScript. Dependiendo del valor de guiType, también se aplican las opciones en las pestañas señaladas.

General

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
local ReplicatedStorage = game: GetService("ReplicatedStorage")
local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))
EmoteBar.configureClient({
    guiType = EmoteBar. GuiType.EmoteWheel,
})

setEmotes

setEmotes(emotes:table):nil

Establece los emotes personalizados que se van a usar. Estos se añadirán a los valores predeterminados si useDefaultEmoteses true, o reemplazarán los valores predeterminados si useDefaultEmoteses false. A esta función solo se puede acceder desde unScript y los cambios se replicarán automáticamente en todos los clientes.

Consulta Emote para ver la estructura de cada emote pasado a esta función.

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

Muestra u oculta la GUI de los emotes. A esta función solo se puede acceder desde un LocalScripten un cliente específico.

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

getEmote

getEmote(emoteName:string):table

Obtiene un Emote por nombre. Retorna nilsi el emote no se puede encontrar. A esta función solo se puede acceder desde un LocalScripten un cliente específico.

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

playEmote

playEmote(emote:Emote):nil

Reproduce el Emote dado y dispara el evento emotePlayed en el servidor, si está conectado. A esta función solo se puede acceder desde un LocalScripten un 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

Desbloquea el Emote con el nombre dado. A esta función solo se puede acceder desde un LocalScripten el cliente.

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

unlockEmote

unlockEmote(emoteName:string):nil

Bloquea el Emote con el nombre dado. A esta función solo se puede acceder desde un LocalScripten el cliente.

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

Eventos

emotePlayed

emotePlayed(player:Player, emote:Emote): RBXScriptSignal

Se dispara cuando cualquier cliente juega un emote. Este evento solo se puede conectar en un 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)

lockedEmoteActivated

lockedEmoteActivated(emote:Emote): RBXScriptSignal

Se dispara cuando un cliente hace clic en un emote bloqueado. Este evento solo se puede conectar en un 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)