profiles gui profile - magemonkeystudio/divinity GitHub Wiki

🧩 gui.profile.yml

This file defines the Profile Selection GUI that appears when a player uses /profiles or interacts with the profile selector. It allows switching profiles, accessing settings, or closing the menu.


📂 File Location

/plugins/Divinity/profiles/gui.profile.yml


📘 Default Layout

title: '&8&m            &8&l[ &9&lProfile &8&l]&8&m            '
size: 9
content:
  change:
    material: 'PLAYER_HEAD'
    name: '&b&lChange Profile'
    lore:
      - '&7Switch active profile.'
    type: PROFILE_CHANGE
    slots: 0

  settings:
    material: 'MAP'
    name: '&6&lSettings'
    lore:
      - '&7Change account settings.'
    type: PROFILE_SETTINGS
    slots: 3

  exit:
    material: 'BARRIER'
    name: '&c&lExit'
    type: EXIT
    slots: 8

⚙️ Settings Explained

Key Description
title The GUI title displayed at the top of the menu. Supports color codes.
size Inventory size in slots. Must be a multiple of 9.
content A list of buttons in the GUI, defined by a unique ID (change, settings, exit, etc).

Each button inside content supports the following fields:

Field Description
material Item material shown in the GUI (e.g., PLAYER_HEAD, MAP, BARRIER).
name Display name of the item. Supports color codes.
lore List of lore lines (tooltips) shown under the name.
type Controls the action taken when clicked. Supported types are listed below.
slots Integer or list of slot positions (0-based). Determines where this item appears in the menu.

🎮 Supported type Values

Type Description
PROFILE_CHANGE Opens the profile switcher GUI
PROFILE_SETTINGS Opens profile-specific settings
EXIT Closes the GUI

💡 Notes

  • You can add more items to the GUI by defining new keys under content, as long as each has a unique name.
  • Slots must be within the defined size (e.g., 0–8 if size: 9).
  • Be sure not to overlap slot positions unless intended.

Restart the server or use /divinity reload after making changes for them to take effect.