Zum Hauptinhalt springen

Ein GUI-Menü verstehen

Ein Open GUI-Entry enthält alles, was ein Menü braucht: den Fenstertyp, den Titel, einen Pool von Layouts und die Optionen der Session. Diese Seite erklärt das Vokabular und die Reihenfolge, in der du ein Menü aufbaust.

Vokabular​

BegriffBedeutung
layoutPoolDie benannten Layouts des Menüs.
mainLayoutIdDie id des Layouts, das zuerst gezeichnet wird (die Wurzel).
LayoutEine Regel, die Slots platziert: Raster, Reihen, Seiten, Scrollbereich, Frames oder Ebenen.
ItemDie Beschreibung eines Slots: Item, Name, Lore, Position, Berechtigungen und Klick-Aktionen.
InteractionWas bei einem Klicktyp geschieht: Befehle, Trigger, Schließen oder Zurückgehen.
SessionDer Zustand eines geöffneten Menüs für einen Spieler: Verlauf, aktuelle Seite, Scrollposition und aktive View.
ViewportDer aktuell sichtbare Teil eines scrollbaren Layouts.

Reihenfolge beim Aufbau​

  1. Erstelle den Open-GUI-Entry und wähle dann guiType, size und title.
  2. Füge ein simple-Layout mit einer id hinzu und trage diese id in mainLayoutId ein.
  3. Füge zuerst dekorative Items hinzu (Rahmen, Hintergründe), dann die Buttons.
  4. Füge den Buttons interactionList-Einträge hinzu.
  5. Erst danach ergänzt du frame, scrollable, paginated oder views.

Slot-Wiederholung​

count, direction, gap und repeatY wiederholen ein Item. Ein einzelnes Item mit count 9 und direction right füllt eine Reihe. Diese Felder platzieren Slots; sie verändern nie die Stapelgröße des Items. gap ist eine Schrittweite: 1 platziert benachbarte Slots und 2 lässt zwischen den Kopien einen leeren Slot. Ohne direction werden die drei Felder ignoriert und es wird ein Slot platziert.

Slots, die außerhalb des Rasters landen würden, werden verworfen und in der Konsole mit der Layout-id und den Koordinaten aufgelistet.

Sichtbarkeit und Klicks​

  • criteria blendet den Slot für Spieler aus, die nicht passen.
  • viewPermission blendet den Slot für Spieler ohne die Berechtigung aus.
  • clickPermission zeichnet den Slot, macht ihn aber wirkungslos.
  • allowPickup erlaubt dem Spieler, das Item aus dem Menü zu nehmen; standardmäßig ist es aus.

Alle sind optional, und eine leere Berechtigung sperrt nichts.

Öffnen, Zurück und Schließen​

  • Jeder Entry, der eine Action auslösen kann, kann das Open GUI auslösen.
  • executeReturn bei einer Interaction geht zum vorherigen Menü der Session zurück.
  • closeMenu bei einer Interaction schließt das Fenster.
  • Das Schließen mit Escape beendet die Session.

Nächste Schritte​