PrefixesPro

💡 Features

• ✅ Prefixes with color & formatting support (& color codes)
• 🏷️ Two prefix categories: Free (anyone can activate) and Pay (admin-assigned)
• ⏳ Expiration system — assign prefixes with a duration (30d, 1h, 30m, etc.)
• 🛡️ Permission-based access control
• 🧠 Per-player session management (active prefix, owned prefixes)
• 📦 Full GUI interface via FormAPI for prefix selection and creation
• 🔁 Auto-save system with configurable interval
• 🏷️ Nametag update support (optional)
• 📝 Fully customizable chat format with {prefix}, {name}, and {message} placeholders
• ⚡ Lightweight and optimized for PocketMine-MP API 5.x

---

🛠️ Installation

1. 📥 Download the .phar file
2. 🔌 Drag it into your server's /plugins/ folder
3. 🚀 Restart your server
4. ✅ Use /prefixes in-game to open the GUI menu

---

📚 Commands

💡 Most subcommands have aliases: add → give, assign | remove → take | create → new | list → all

---

⏳ Time Format

When assigning prefixes with /prefix add, you can specify an optional duration:

Example: /prefix add Steve VIP 30d — assigns the prefix VIP to Steve for 30 days.

---

🏷️ Prefix Categories

Prefixes have two categories that control how players can obtain them:

• Free — any player with the right permission node can activate it from the GUI (/prefixes).
• Pay — must be manually assigned by an admin using /prefix add. Ideal for donor or purchased ranks.

You can set the category when creating a prefix via the in-game form (/prefix create).

---

🔑 Permissions

---

⚙️ Configuration

# config.yml

# Maximum length of the prefix name (without colors)
prefix-max-name-length: 10

# Maximum length of the prefix format (with color codes)
prefix-max-format-length: 30

# Time (in seconds) between each auto-save
autosave-interval: 300

# Chat format — placeholders: {prefix} {name} {message}
chat-format: "{prefix} §7{name}§r: {message}"

# Apply the active prefix to the player's nametag
update-nametag: false

---

📁 File Structure

plugin_data/
└── PrefixesPro/
    ├── prefixes/
    │   └── <prefix>.yml
    ├── sessions/
    │   └── <uuid>.yml
    ├── messages.yml
    └── config.yml

---

📖 License

This plugin is open source and licensed under the MIT License. Feel free to fork, contribute, or open issues and pull requests.

---

Made with ❤️ by AndresD3us

---