profiles gui profiles - magemonkeystudio/divinity GitHub Wiki

๐Ÿงฉ gui.profiles.yml

This file defines the Profile List GUI, which displays all available player profiles. It allows switching, setting defaults, deleting, and creating new profiles.


๐Ÿ“‚ File Location

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


๐Ÿ“˜ Default Layout

title: '&8&m            &8&l[ &9&lProfiles &8&l]&8&m            '
size: 36
profiles:
  icon:
    material: 'PLAYER_HEAD'
    name: '&b%profile% Profile'
    lore:
      - '&a%class-name%&7, &fLv. %class-level%'
      - ''
      - '&7Default: &f%default%'
      - '&7Active: &f%active%'
      - ''
      - '&aLeft-Click to Switch'
      - '&2Right-Click set Default'
      - '&cShift+Right to Delete'
  slots: 0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26

content:
  next-page:
    material: 'ENDER_PEARL'
    name: '&dNext Page'
    type: NEXT
    slots: 35

  prev-page:
    material: 'ENDER_PEARL'
    name: '&dPrevious Page'
    type: BACK
    slots: 27

  exit:
    material: 'BARRIER'
    name: '&c&lReturn'
    type: RETURN
    slots: 30

  create_profile:
    material: 'ANVIL'
    name: '&b&lNew Profile'
    type: PROFILE_CREATE
    slots: 32

โš™๏ธ Settings Explained

Key Description
title Title of the GUI shown at the top. Supports color codes.
size Total size of the GUI inventory in slots (must be a multiple of 9).
profiles Defines how each profile appears in the menu (repeated per profile).
content Static buttons like next/previous page, exit, and create profile actions.

๐Ÿ”ณ profiles.icon Fields

Field Description
material The material used for the profile icon. Typically PLAYER_HEAD.
name Display name of the profile. %profile% is replaced with the profileโ€™s name.
lore Tooltip shown for each profile, with placeholders for class and status info.
slots A list of slots in the inventory where profiles are rendered (reused for pagination).

Supported %placeholders% in name or lore:

  • %profile% โ€“ profile name
  • %class-name% โ€“ the class assigned to the profile
  • %class-level% โ€“ class level
  • %default% โ€“ whether this profile is marked as default
  • %active% โ€“ whether this profile is currently active

๐ŸŽฎ content Buttons

ID Description
next-page Goes to the next page of profiles.
prev-page Goes to the previous page.
exit Closes the GUI or returns to the previous menu.
create_profile Creates a new profile.

Each content button includes:

  • material: The icon to display
  • name: The label shown in the GUI
  • type: Action performed when clicked (NEXT, BACK, RETURN, PROFILE_CREATE)
  • slots: The inventory slot where the item appears

๐Ÿ’ก Tips

  • You can increase the number of profiles shown by adjusting the slots list under profiles.icon and increasing size.
  • Be careful not to overlap static content slots with profiles slots.
  • Color and formatting codes like &a, &c, &l (bold) are supported in name and lore.

Restart the server or use /divinity reload to apply changes.