Menu de Contexto do Avatar

O Menu de Contexto do Avatar (MCA) facilita a interação entre os usuários. Quando o MCA é habilitado em seu jogo, um usuário pode se aproximar do personagem de outro usuário e clicar nele para abrir um pequeno menu com várias opções padrão. O jogador pode enviar um pedido de amizade, iniciar um chat privado, visualizar o perfil do usuário ou acenar.

Após habilitar o MCA em seu jogo, você pode personalizá-lo das seguintes maneiras:

• Programaticamente abrir e fechar o MCA para usuários específicos.
• Adicionar opções personalizadas e remover opções existentes do MCA.
• Personalizar a aparência do MCA para criar uma interface de usuário única.

Habilitar o Menu de Contexto do Avatar

O Menu de Contexto do Avatar deve ser habilitado usando a opção StarterGui:SetCore() "AvatarContextMenuEnabled" em um LocalScript. O MCA é melhor utilizado em jogos onde não há um comportamento predefinido para clicar em outros usuários.

Use o seguinte exemplo de código para habilitar o MCA em um LocalScript:

-- Execute em um LocalScript, idealmente dentro de "StarterPlayerScripts"
local StarterGui = game:GetService("StarterGui")
StarterGui:SetCore("AvatarContextMenuEnabled", true)

Se você precisar detectar se o MCA está habilitado, você pode usar o seguinte código para retornar um booleano sobre o status atual do MCA:

---Retorna um booleano indicando se o MCA está atualmente habilitado.
StarterGui:GetCore(AvatarContextMenuEnabled)

Abrir e fechar o MCA

Uma vez habilitado, você pode abrir e fechar o MCA programaticamente com StarterGui.

Para abrir programaticamente o MCA, use o seguinte código:

-- Use StarterGui:SetCore onde targetPlayer é um objeto Player válido
StarterGui:SetCore("AvatarContextMenuTarget", targetPlayer)

Para fechar programaticamente o MCA, use o seguinte código:

StarterGui:SetCore("AvatarContextMenuTarget", nil)

Opções do menu

Você pode adicionar e remover ações através da programação. Por padrão, o menu tem as seguintes opções:

Uma vez que o MCA esteja aberto, o usuário pode rolar e selecionar outros usuários no carrossel de seleção de personagens. Os personagens são ordenados com base na distância do personagem selecionado. O menu só é atualizado quando aberto e a lista de usuários disponíveis irá repetir ao rolar.

Adicionar opções ao menu

Uma vez habilitado, ações específicas do jogo podem ser adicionadas ao MCA. Por exemplo, um jogo pode permitir pedidos de troca, opções de adicionar a festa ou outras interações especiais.

O seguinte exemplo mostra como adicionar uma ação personalizada ao Menu de Contexto do Avatar:

local Players = game:GetService("Players")
local StarterGui = game:GetService("StarterGui")
local player = Players.LocalPlayer

-- Conectar uma função a um "BindableEvent"
local bindableEvent = Instance.new("BindableEvent")
local function onCustomACMAction(targetPlayer)
	-- Neste ponto, você poderia chamar InvokeServer() em um RemoteFunction para alertar o servidor sobre a seleção
	print("Evento MCA selecionado por " .. player.Name .. " em " .. targetPlayer.Name)
end
bindableEvent.Event:Connect(onCustomACMAction)

-- Adicione a opção MCA usando SetCore() com "AddAvatarContextMenuOption"
local options = {"Ação MCA Personalizada", bindableEvent}
StarterGui:SetCore("AddAvatarContextMenuOption", options)

Remover opções do menu

Você pode remover opções personalizadas e as opções padrão Adicionar Amigo, Chat, Visualizar e Acenar do MCA referenciando o nome da Ação personalizada ou o enum padrão Enum.AvatarContextMenuOption.

Use o seguinte código para remover uma opção do menu padrão e personalizada:

-- Remover a opção "Ação MCA Personalizada"
StarterGui:SetCore("RemoveAvatarContextMenuOption", "Ação MCA Personalizada")

-- Remover a opção padrão "Amigo" referenciando o Enum AvatarContextMenuOption.Friend
StarterGui:SetCore("RemoveAvatarContextMenuOption", Enum.AvatarContextMenuOption.Friend)

Personalizar a aparência do menu

Para mudar a aparência do Menu de Contexto do Avatar, chame StarterGui:SetCore() com a opção "AvatarContextMenuTheme", fornecendo uma tabela de parâmetros e valores para ajustar a aparência do menu.

A interface do usuário do MCA inclui as seguintes seções:

A. Etiqueta de Nome: O nome do usuário do personagem com o qual está interagindo.

B. Quadro de Botão: Contém todos os botões do MCA.

C. Botões: Botões individuais para as ações padrão ou personalizadas do MCA.

Parâmetros de aparência

Estes são os parâmetros de personalização do MCA:

Fundo

Etiqueta de nome

Quadro de botão

Botão

Texto

Várias imagens

Personagem selecionado

Tamanho e posição

Exemplo de personalização

O seguinte exemplo de código personaliza o tema do MCA usando alguns parâmetros básicos:

local StarterGui = game:GetService("StarterGui")

StarterGui:SetCore("AvatarContextMenuTheme", {
	BackgroundImage = "",
	BackgroundTransparency = 0.5,
	BackgroundColor = Color3.fromRGB(111, 145, 242),
	NameTagColor = Color3.fromRGB(0, 0, 200),
	NameUnderlineColor = Color3.fromRGB(213, 233, 255),
	ButtonFrameColor = Color3.fromRGB(15, 24, 65),
	ButtonFrameTransparency = 0.2,
	ButtonUnderlineColor = Color3.fromRGB(213, 233, 255),
	Font = Enum.Font.SciFi
})