Barra Emote

Le emote sono un componente fondamentale di qualsiasi gioco sociale. Il modulo EmoteBar per sviluppatori mira a fornire ai giocatori un modo accessibile e personalizzabile per facilitare interazioni sociali significative.

Utilizzo del modulo

Installazione

Per utilizzare il modulo EmoteBar in un gioco:

1. Dal menu Finestra di Studio o dalla barra degli strumenti della scheda Home, apri il Toolbox e seleziona la scheda Creator Store.

   

2. Assicurati che sia selezionato l'ordinamento Modelli, quindi fai clic sul pulsante Vedi Tutti per Categorie.

   

3. Individua e fai clic sulla tessera Pacchetti.

4. Individua il modulo Emote Bar e fai clic su di esso, oppure trascinalo nella vista 3D.

   

5. Nella finestra Explorer, sposta l'intero modello EmoteBar in ReplicatedStorage. Una volta avviato il gioco, il modulo inizierà a funzionare.

Configurazione

Il modulo è preconfigurato con 7 emote e può essere facilmente personalizzato con le tue emote e opzioni di visualizzazione. Inoltre, se il giocatore possiede emote da eventi Roblox precedenti come Lil Nas X, Royal Blood o Twenty One Pilots, quelle emote verranno automaticamente aggiunte all'elenco delle emote disponibili.

1. In ServerScriptService, crea un nuovo Script e rinominalo ConfigureEmotes.

   

2. Incolla il seguente codice nel nuovo script ConfigureEmotes. L'impostazione useDefaultEmotes di false sovrascrive le emote predefinite e ti consente di definire emote personalizzate tramite la funzione setEmotes.

   Script - ConfigureEmotes

   local ReplicatedStorage = game:GetService("ReplicatedStorage")
   
   local EmoteBar = require(ReplicatedStorage.EmoteBar)
   
   EmoteBar.configureServer({
   	useDefaultEmotes = false,
   })
   
   EmoteBar.setEmotes({
   	{
   		name = "Ciao",
   		animation = "rbxassetid://3344650532",
   		image = "rbxassetid://7719817462",
   		defaultTempo = 1,
   	},
   	{
   		name = "Applausi",
   		animation = "rbxassetid://5915693819",
   		image = "rbxassetid://7720292217",
   		defaultTempo = 2,
   	},
   })

Mega emote

Una mega emote si forma quando più giocatori nella stessa area eseguono la stessa emote contemporaneamente. Man mano che sempre più giocatori partecipano, la mega emote cresce. Quando i giocatori smettono di eseguire l'emote, la mega emote si riduce fino a scomparire.

Tempo

Il tempo di un'emote è la velocità con cui viene riprodotta quando il suo pulsante viene toccato una volta. La velocità predefinita di un'emote è determinata dal suo defaultTempo. La velocità di un'emote può essere aumentata o diminuita toccando il suo pulsante più velocemente o più lentamente.

Riferimento API

Tipi

Emote

Ogni emote è rappresentata da un dizionario con le seguenti coppie chiave-valore:

Enums

EmoteBar.GuiType

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EmoteBar = require(ReplicatedStorage.EmoteBar)

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

Funzioni

configureServer

Sovrascrive le opzioni di configurazione predefinite lato server tramite le seguenti chiavi/valori nella tabella config. Questa funzione può essere chiamata solo da un Script e le modifiche verranno replicate automaticamente a tutti i client.

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EmoteBar = require(ReplicatedStorage.EmoteBar)

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

configureClient

Sovrascrive le opzioni di configurazione predefinite lato client tramite le seguenti chiavi/valori nella tabella config. Questa funzione può essere chiamata solo da un LocalScript. A seconda del valore di guiType, le opzioni nelle schede indicate si applicano anche.

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EmoteBar = require(ReplicatedStorage.EmoteBar)

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

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EmoteBar = require(ReplicatedStorage.EmoteBar)

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

setEmotes

Imposta le emote personalizzate da utilizzare. Queste verranno aggiunte ai predefiniti se useDefaultEmotes è true, o sostituiranno i predefiniti se useDefaultEmotes è false. Questa funzione può essere chiamata solo da un Script e le modifiche verranno replicate automaticamente a tutti i client.

Vedi Emote per la struttura di ogni emote passata a questa funzione.

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EmoteBar = require(ReplicatedStorage.EmoteBar)

EmoteBar.configureServer({
	useDefaultEmotes = false,
})

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

setGuiVisibility

Mostra o nasconde l'interfaccia utente delle emote. Questa funzione può essere chiamata solo da un LocalScript su un client specifico.

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EmoteBar = require(ReplicatedStorage.EmoteBar)

EmoteBar.setGuiVisibility(false)

getEmote

Ottiene un Emote per nome. Restituisce nil se l'emote non può essere trovata. Questa funzione può essere chiamata solo da un LocalScript su un client specifico.

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EmoteBar = require(ReplicatedStorage.EmoteBar)

local shrug = EmoteBar.getEmote("Shrug")

playEmote

Riproduce l'Emote fornita e attiva l'evento emotePlayed sul server, se connesso. Questa funzione può essere chiamata solo da un LocalScript su un client specifico.

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EmoteBar = require(ReplicatedStorage.EmoteBar)

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

lockEmote

Blocca l'Emote con il nome fornito. Questa funzione può essere chiamata solo da un LocalScript sul client.

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EmoteBar = require(ReplicatedStorage.EmoteBar)

EmoteBar.lockEmote("Applausi")

unlockEmote

Sblocca l'Emote con il nome fornito. Questa funzione può essere chiamata solo da un LocalScript sul client.

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EmoteBar = require(ReplicatedStorage.EmoteBar)

EmoteBar.unlockEmote("Applausi")

Eventi

emotePlayed

Si attiva quando qualsiasi client riproduce un'emote. Questo evento può essere connesso solo in un LocalScript.

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EmoteBar = require(ReplicatedStorage.EmoteBar)

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

lockedEmoteActivated

Si attiva quando un client fa clic su un'emote bloccata. Questo evento può essere connesso solo in un LocalScript.

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

local EmoteBar = require(ReplicatedStorage.EmoteBar)

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