PlayerTitlePrefix

A Paper plugin that allows players to earn, manage, and display titles before their names.

✨ Features

🏷 Title System

• Display a title before the player's name
• Players can freely select from the titles they own
• Titles are defined in config.yml
• Symbols before and after a title can change in config.yml

🔑 Permission-based Titles

• Each title can have its own permission
• Suitable for:
  • Quest completion
  • Item acquisition
  • Achievements
  • Rank progression

🛡 Admin-only Titles

• Titles can be marked as Admin-only
• Separate control from normal permission-based titles

🧭 In-game Management

• Add / remove titles directly in-game
• No server restart required
• Includes a clear and intuitive GUI

📊 Collection Progress

• Players can see how many titles they own
• Displays the percentage of collected titles
• Encourages competition and long-term play

💾 Player Data Storage

• Data for all players is automatically saved
• Stored per-player in the plugin’s data folder
• Safe and persistent across restarts

📦 Installation

1. Download the plugin jar
2. Place it into your server's plugins folder
3. Start or restart the server

⚙ Configuration (config.yml)

Example:

Titles:
  Beginner:
    name: "Beginner"
    permission: "none"
    color: yellow
    isAdmin: false

  Admin:
    name: "Admin"
    permission: "PlayerTitlePrefix.admin"
    color: red
    isAdmin: true

• name: Display name of the title
• permission: Permission required to unlock the title
• color: Display color of the title
• isAdmin: Marks the title as admin-only
• Titles can be freely added or removed

📜 Commands

| Command | Permission | Description |
| ------------------------------------ | ---------- | --------------------------------------------------------- |
| /playertitleprefix reload | OP | Reloads the config and language files |
| /playertitleprefix config | OP | Opens a GUI to add or remove titles in-game |
| /playertitleprefix lang <language> | OP | Changes the plugin language in-game (Default: en, ja) |
| /playertitleprefix change | | Opens a GUI to view, equip, or unequip titles |

🔹 Alias

• /playertitleprefix can also be used as /ptp

🎮 In-game GUI

• Easy-to-use GUI for:
  • Selecting titles
  • Managing available titles
• Designed to be understandable even for new players

🧩 Requirements

• Paper 1.21+ or Purpur 1.21+
• Java 21+

⚠ Notes

• This is a personal project
• No guarantee of support or future updates
• Use at your own risk

📄 License

MIT License