Avatar-Kontextmenü

Das Avatar-Kontextmenü (ACM) erleichtert es Nutzern, miteinander zu interagieren. Wenn das ACM in deinem Spiel aktiviert ist, kann ein Nutzer zu dem Charakter eines anderen Nutzers gehen und auf ihn klicken, um ein kleines Menü mit mehreren Standardoptionen zu öffnen. Der Spieler kann eine Freundschaftsanfrage senden, einen privaten Chat beginnen, das Profil des Nutzers ansehen oder winken.

Nachdem du das ACM aktiviert hast, kannst du das ACM auf folgende Weise anpassen:

• Programmgesteuert das ACM für bestimmte Nutzer öffnen und schließen.
• Benutzerdefinierte Optionen hinzufügen und vorhandene Optionen entfernen zum ACM.
• Das Erscheinungsbild des ACM anpassen, um eine einzigartige Benutzeroberfläche zu schaffen.

Aktivieren des Avatar-Kontextmenüs

Das Avatar-Kontextmenü muss mit der Option StarterGui:SetCore() "AvatarContextMenuEnabled" in einem LocalScript aktiviert werden. Das ACM eignet sich am besten für Spiele, in denen es kein vordefiniertes Verhalten gibt, wenn man auf andere Nutzer klickt.

Verwende das folgende Codebeispiel, um das ACM in einem LocalScript zu aktivieren:

-- In einem LocalScript ausführen, idealerweise innerhalb von "StarterPlayerScripts"
local StarterGui = game:GetService("StarterGui")
StarterGui:SetCore("AvatarContextMenuEnabled", true)

Wenn du überprüfen musst, ob das ACM aktiviert ist, kannst du den folgenden Code verwenden, um einen Booleschen Wert über den aktuellen Status des ACM zurückzugeben:

---Gibt einen Booleschen Wert zurück, der angibt, ob das ACM derzeit aktiviert ist.
StarterGui:GetCore(AvatarContextMenuEnabled)

ACM öffnen und schließen

Sobald das ACM aktiviert ist, kannst du es programmgesteuert mit StarterGui öffnen und schließen.

Um das ACM programmgesteuert zu öffnen, verwende den folgenden Code:

-- Verwende StarterGui:SetCore, wobei targetPlayer ein gültiges Spielerobjekt ist
StarterGui:SetCore("AvatarContextMenuTarget", targetPlayer)

Um das ACM programmgesteuert zu schließen, verwende den folgenden Code:

StarterGui:SetCore("AvatarContextMenuTarget", nil)

Menüoptionen

Durch das Skripting kannst du Aktionen hinzufügen und entfernen. Standardmäßig hat das Menü die folgenden Optionen:

Sobald das ACM geöffnet ist, kann der Benutzer scrollen und andere Nutzer im Karussell zur Charakterauswahl auswählen. Charaktere werden basierend auf der Entfernung zum ausgewählten Charakter sortiert. Das Menü aktualisiert sich nur beim Öffnen, und die Liste der verfügbaren Nutzer wird beim Scrollen wiederholt.

Menüoptionen hinzufügen

Sobald es aktiviert ist, können spielspezifische Aktionen zum ACM hinzugefügt werden. Zum Beispiel könnte ein Spiel Handelsanfragen, Optionen zum Hinzufügen zur Gruppe oder andere spezielle Interaktionen erlauben.

Das folgende Beispiel zeigt, wie eine benutzerdefinierte Aktion zum Avatar-Kontextmenü hinzugefügt wird:

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

-- Verbinde eine Funktion mit einem "BindableEvent"
local bindableEvent = Instance.new("BindableEvent")
local function onCustomACMAction(targetPlayer)
	-- An diesem Punkt könntest du InvokeServer() auf einer RemoteFunction aufrufen, um den Server über die Auswahl zu informieren
	print("ACM-Ereignis ausgewählt von " .. player.Name .. " auf " .. targetPlayer.Name)
end
bindableEvent.Event:Connect(onCustomACMAction)

-- Füge die ACM-Option mit SetCore() und "AddAvatarContextMenuOption" hinzu
local options = {"Benutzerdefinierte ACM-Aktion", bindableEvent}
StarterGui:SetCore("AddAvatarContextMenuOption", options)

Menüoptionen entfernen

Du kannst benutzerdefinierte und die Standardoptionen Freund hinzufügen, Chat, Ansicht und Winken aus dem ACM entfernen, indem du den Namen der benutzerdefinierten Aktion oder das Standard-Enum.AvatarContextMenuOption-Enum referenzierst.

Verwende den folgenden Code, um eine Standard- und benutzerdefinierte Menüoption zu entfernen:

-- Entferne die Option "Benutzerdefinierte ACM-Aktion"
StarterGui:SetCore("RemoveAvatarContextMenuOption", "Benutzerdefinierte ACM-Aktion")

-- Entferne die Standardoption "Freund", indem du das Enum AvatarContextMenuOption.Friend referenzierst
StarterGui:SetCore("RemoveAvatarContextMenuOption", Enum.AvatarContextMenuOption.Friend)

Menüaussehen anpassen

Um das Erscheinungsbild des Avatar-Kontextmenüs zu ändern, rufe StarterGui:SetCore() mit der Option "AvatarContextMenuTheme" auf und übergebe eine Tabelle von Parametern und Werten, um das Menüaussehen anzupassen.

Die Benutzeroberfläche des ACM umfasst die folgenden Abschnitte:

A. Namensschild: Der Benutzername des Charakters, mit dem interagiert wird.

B. Schaltflächenrahmen: Enthält alle ACM-Schaltflächen.

C. Schaltflächen: Einzelne Schaltflächen für die Standard- oder benutzerdefinierten ACM-Aktionen.

Erscheinungsbildparameter

Dies sind die Anpassungsparameter des ACM:

Hintergrund

Namensschild

Schaltflächenrahmen

Schaltfläche

Text

Verschiedene Bilder

Ausgewählter Charakter

Größe und Position

Beispielanpassung

Das folgende Codebeispiel passt das ACM-Thema mit einigen grundlegenden Parametern an:

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