Skip to content

4 Player Profiles

Jump to bottom
MaksyKun edited this page Jul 25, 2026 · 3 revisions

Profiles

Profiles let one player keep separate character-like states. They are useful for different classes, builds, or play styles without requiring separate Minecraft accounts.

What this page is for

Use this page when you need to change how many profiles a player can have, when profiles can be switched, or how the profile menus look. Profile rules and profile GUI layout are separate concerns.

Files:

  • profiles/settings.yml — enablement, switching rules, name format, and profile limits.
  • profiles/gui.profile.yml — the single-profile menu.
  • profiles/gui.profiles.yml — the profile list and creation menu.
  • profiles/gui.settings.yml — profile settings menu.

Important settings

  • profile.select-on-join chooses whether a player selects a profile on login.
  • profile.change-cooldown prevents rapid switching.
  • profile.name-regex restricts profile names.
  • profiles-amount controls the number of profiles by permission group; -1 means unlimited.

The profile GUI supports switching, setting a default, deleting, and creating profiles. Keep GUI slot layouts stable unless you are also testing every click action.

Clone this wiki locally