⚙️ profiles/settings.yml

This file defines global settings related to player profile behavior in Divinity, including profile limits, naming rules, and automatic profile selection.

---

📂 File Location

/plugins/Divinity/profiles/settings.yml

---

📘 Default Configuration

enabled: true

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

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

---

⚙️ Settings Explained

🔌 enabled

• Type: boolean
• Description: Enables or disables the entire profile system.
• Default: true

---

👤 profile

Setting	Description
select-on-join	If true, players will be prompted to select a profile every time they join.
change-cooldown	Time (in seconds) a player must wait between switching profiles.
name-regex	Regex pattern that defines valid profile names. Only names matching this pattern will be accepted.

---

🔢 profiles-amount

Controls how many profiles players are allowed to have based on their permission group.

Key	Description
default	Number of profiles for players without special permissions.
vip	Profile limit for players with the divinity.profiles.vip permission.
admin	Profile limit for players with the divinity.profiles.admin permission. -1 means unlimited.

You can define additional groups here as long as corresponding permissions are set up in your permissions plugin.

---

🔐 Required Permissions

Permission	Description
divinity.profiles.vip	Grants the vip profile amount.
divinity.profiles.admin	Grants the admin (unlimited) amount.

---

💡 Tips

• You can expand profiles-amount with custom ranks like legend, premium, etc.
• Regex in name-regex must be a valid Java regex expression.
• Cooldowns apply between any profile switch (not per profile).

Use /divinity reload to apply changes after modifying this file.