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. |
type
Values
🎮 Supported 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
ifsize: 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.