4 Player Profiles

4 - Player Profiles

Profiles let one player keep separate character-like states for classes, builds, or play styles.

Files

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

Settings to know

Key	Effect
profile.select-on-join	asks for a profile when a player joins
profile.change-cooldown	prevents rapid profile switching
profile.name-regex	validates profile names
profiles-amount	profile count by permission group; -1 means unlimited

profiles/settings.yml — real profile settings

profile:
  select-on-join: false
  change-cooldown: 60
  name-regex: '[a-zA-Z0-9_]*'

profiles-amount:
  default: 1
  vip: 2
  admin: -1

Keep GUI slots and click types stable unless you test every action after changing them.

Administrator notes

• Back up player data before enabling profiles on an established server or changing storage.
• Permission suffixes under profiles-amount are group names. Confirm the effective permission setup with a non-operator test account.
• admin: -1 grants unlimited profiles to that group; do not copy it to broad player groups unintentionally.
• Tighten name-regex if profile names appear in chat, commands, scoreboards, or integrations.
• Test profile creation, switching, deletion, default selection, logout, reconnect, and class/progression isolation before production rollout.