On-Screen UI-Container | Dokumentation

Der ScreenGui-Container hält GuiObjects, um sie auf dem Bildschirm eines Spielers anzuzeigen, einschließlich Frames, Labels, Buttons und mehr. Alle On-Screen UI-Objekte und der Code werden auf dem Client gespeichert und geändert.

Beispiel für ScreenGui mit verschiedenen GuiObject-Kindern, einschließlich eines Frames, TextLabels, TextBoxen und ImageButtons.

Um ein ScreenGui und seine Kind-GuiObjects für jeden Spieler, der dem Spiel beitritt, anzuzeigen, platzieren Sie es im StarterGui-Container. Wenn ein Spieler einem Spiel beitritt und sein Charakter zum ersten Mal erscheint, wird das ScreenGui und sein Inhalt in den PlayerGui-Container für diesen Spieler, der sich im Players-Container befindet, geklont.

Diagramm, wie ein ScreenGui von StarterGui in den PlayerGui eines Spielers klont.

Standardmäßig erscheinen GuiObjects innerhalb eines ScreenGui im StarterGui als Overlay des 3D Viewport, das ihr Aussehen und ihre Position in einem laufenden Spiel simuliert. Um alle solchen Bildschirm-Overlays auszublenden, schalten Sie GUI Overlay im Widget der Visualisierungsoptionen in der oberen rechten Ecke des 3D-Viewports aus.

Wenn Players.CharacterAutoLoads deaktiviert ist, werden die Inhalte von StarterGui nicht geklont, bis Player:LoadCharacterAsync() aufgerufen wird.

Wenn ein Spiel im Umfang wächst, benötigen Sie möglicherweise mehrere Bildschirmoberflächen wie einen Titelbildschirm, ein Einstellungsmenü, eine Shop-Oberfläche und mehr. In solchen Fällen können Sie mehrere einzigartige ScreenGui-Container im StarterGui platzieren und die Enabled-Eigenschaft jedes Containers umschalten, je nachdem, ob er sichtbar und aktiv sein soll (wenn false, werden die Inhalte nicht gerendert, verarbeiten keine Benutzereingaben oder aktualisieren sich als Reaktion auf Änderungen).

Explorer-Hierarchie, die mehrere ScreenGui-Container zeigt, von denen einer aktiviert und die anderen deaktiviert sind, um zu steuern, welche zu einem bestimmten Zeitpunkt sichtbar sind.

Die Enabled-Eigenschaft kann zunächst über das Eigenschaften-Fenster umgeschaltet werden und/oder Sie können sie während der Spielzeit von einem clientseitigen Skript aus festlegen, indem Sie auf den PlayerGui des Spielers zugreifen und sie auf true oder false für die gewünschten Container setzen.

Wenn Sie mehrere ScreenGui-Oberflächen verwenden, können Sie sie durch den Z-Index über ihre DisplayOrder-Eigenschaft schichten. Siehe Anzeigereihenfolge für weitere Informationen.

Container-Eigenschaften

Die folgenden Eigenschaften ermöglichen es Ihnen, die Bildschirmränder über mehrere Geräte hinweg, die Anzeigereihenfolge bei der Verwendung mehrerer Bildschirmcontainer und mehr anzupassen.

Bildschirmränder

Moderne Telefone nutzen den gesamten Bildschirm, enthalten jedoch typischerweise Ausschnitte, Schnitte und andere Elemente, die Bildschirmplatz beanspruchen. Jedes Roblox-Spiel enthält auch die Oberleistensteuerungen für den schnellen Zugriff auf das Hauptmenü, Chat, Leaderboard und mehr.

Mobilgerät, das die Roblox-Oberleisten-Schaltflächen und den Ausschnitt des Geräts zeigt.

Um sicherzustellen, dass die Spieler alle UI-Elemente leicht und ohne Behinderung sehen und darauf zugreifen können, bietet Roblox die ScreenInsets-Eigenschaft, die die sicheren Bereich-Abstände für die Inhalte eines ScreenGui steuert.

Der Standardwert von CoreUISafeInsets hält alle abgeleiteten GuiObjects im sicheren Bereich der Kernbenutzeroberfläche, weg von den Schaltflächen der Oberleiste und anderen Bildschirm-Ausschnitten. Diese Einstellung wird empfohlen, wenn das ScreenGui interaktive UI-Elemente enthält.

Mobilgerät, das den sicheren Bereich der Kernbenutzeroberfläche zeigt.

Anzeigereihenfolge

Bei der Verwendung mehrerer ScreenGui-Oberflächen können Sie sie durch den Z-Index über ihre DisplayOrder-Eigenschaft schichten. Zum Beispiel, um ein modales Einstellungsmenü auf einem ScreenGui vor der Hauptbenutzeroberfläche des Spiels auf einem anderen ScreenGui anzuzeigen, weisen Sie der modalen Oberfläche eine höhere DisplayOrder zu als der darunter liegenden Benutzeroberfläche.

Zurücksetzen beim Spawn

Die ResetOnSpawn-Boolesche Eigenschaft bestimmt, ob das ScreenGui zurückgesetzt wird (sich selbst löscht und erneut in den PlayerGui des Spielers klont), jedes Mal, wenn der Charakter des Spielers neu erscheint.

Bedingung	Zurücksetzt
ResetOnSpawn ist true (Standard).	JA
Das ScreenGui ist ein indirekter Nachkomme von StarterGui; zum Beispiel ist es in einem Folder innerhalb von StarterGui platziert.	JA
ResetOnSpawn ist false und das ScreenGui ist ein direkter Nachkomme von StarterGui.	NEIN

Zugriff auf die Spieler-UI

Wie bereits erwähnt, klont das Eltern eines ScreenGui zu StarterGui es und seine Kind-GuiObjects in den PlayerGui-Container eines Spielers, wenn er dem Spiel beitritt und sein Charakter zum ersten Mal erscheint.

Wenn Sie die UI des Spielers während der Spielzeit steuern müssen, z. B. um ein bestimmtes ScreenGui oder eines seiner Kinder anzuzeigen/auszublenden, greifen Sie wie folgt von einem LocalScript darauf zu:

LocalScript - Zugriff auf die UI eines Spielers

local Players = game:GetService("Players")

local player = Players.LocalPlayer
local playerGui = player.PlayerGui

local titleScreen = playerGui:WaitForChild("TitleScreen")
local settingsMenu = playerGui:WaitForChild("SettingsMenu")

titleScreen.Enabled = false  -- Titelbildschirm ausblenden
settingsMenu.Enabled = true  -- Einstellungsmenü anzeigen

Standard-UI deaktivieren

Alle Roblox-Spiele enthalten mehrere UI-Elemente, die standardmäßig aktiviert sind. Wenn Sie eines dieser Elemente nicht benötigen oder wenn Sie sie durch Ihre eigenen Kreationen ersetzen möchten, können Sie die Methode SetCoreGuiEnabled() in einem clientseitigen Skript mit der zugehörigen Enum.CoreGuiType-Option verwenden.

Standard UI	Zugehöriges Enum
Dynamisch aktualisierte Players-Liste, die häufig als Rangliste verwendet wird.	Enum.CoreGuiType.PlayerList
Die Health-Leiste des Charakters. Wird nicht angezeigt, wenn der Humanoid des Charakters volle Gesundheit hat.	Enum.CoreGuiType.Health
Der Backpack des Charakters, der In-Game-Werkzeuge enthält. Wird nicht angezeigt, wenn keine Tools im Rucksack sind.	Enum.CoreGuiType.Backpack
Das Text-Chat-Fenster.	Enum.CoreGuiType.Chat
Popup-Menü mit Emotes des Charakters.	Enum.CoreGuiType.EmotesMenu
Ein Fenster, das die Perspektive oder Sicht des Spielers auf seinen eigenen Charakter anzeigt. Wird nicht angezeigt, es sei denn, der Spieler hat Selbstansicht im Roblox-Menü aktiviert.	Enum.CoreGuiType.SelfView
Ein Screenshot erheben-Button an der rechten Seite des Bildschirms. Wird nicht angezeigt, es sei denn, der Spieler hat Aufnahmen im Roblox-Menü aktiviert.	Enum.CoreGuiType.Captures
Der Avatar-Wechsler ermöglicht es Benutzern, ihren Plattform-Avatar zu ändern.	Enum.CoreGuiType.AvatarSwitcher

Client Script - Deaktivieren der Standard UI-Elemente

local StarterGui = game:GetService("StarterGui")

-- Deaktivieren der Standard-Gesundheitsanzeige und des Rucksacks
StarterGui:SetCoreGuiEnabled(Enum.CoreGuiType.Health, false)
StarterGui:SetCoreGuiEnabled(Enum.CoreGuiType.Backpack, false)

Zusätzlich beinhalten Geräte mit Touch-Funktionen standardmäßig einen virtuellen Joystick und einen Sprungknopf. Wenn gewünscht, können Sie diese Elemente ausblenden, indem Sie GuiService.TouchControlsEnabled in einem clientseitigen Skript auf false setzen.

UI-Elemente für Touch-fähige Geräte in jedem Roblox-Spiel.

Client Script - Deaktivieren der Touch-Steuerungen

local GuiService = game:GetService("GuiService")

GuiService.TouchControlsEnabled = false