DSMPTitle

DSMPTitle is a custom title plugin for Paper servers. Players can purchase custom titles, while administrators can grant, remove and manage titles for players. Each title stores its text, color and priority separately.

The plugin provides a GUI title storage system for viewing, switching and managing purchased titles. Title prefixes are stored directly in LuckPerms PrefixNodes, allowing titles to be displayed in chat and the player tab list.

Required Dependencies

1. LuckPerms (Required, stores title prefixes)
2. Vault (Optional, used for economy payments when use-item is empty)
3. Any economy plugin compatible with Vault, when using Vault economy

LuckPerms is required for DSMPTitle to work. Vault is a soft dependency. Vault is only required when using economy payment. If use-item is configured, players can purchase titles using items without Vault.

Commands

Player Commands

• /dt buy - Purchase a custom title
• /dt cancel - Cancel the current title creation process
• /dt gui - Open your title storage
• /dt menu - Open your title storage

Administrator Commands

• /dt gui <player> - View another player's title storage
• /dt menu <player> - View another player's title storage
• /dt set <player> <title> <color> <weight> - Grant a title to a player
• /dt remove <player> <title> - Remove a title from a player
• /dt removebyindex <player> <index> - Remove a title by its index
• /dt reload - Reload the plugin configuration, language and data

Permissions

• dsmptitle.admin - Access administrative commands
• dsmptitle.reload - Reload plugin configuration and data
• dsmptitle.set - Grant titles to players
• dsmptitle.remove - Remove titles from players
• dsmptitle.gui.others - View another player's title storage

config.yml

• price: Amount required to purchase a title
• use-item: Item used to purchase a title, for example acacia_log
  • Leave empty ("") to use Vault economy
  • When configured, the specified item is consumed instead of using Vault
• prefix-weight: Default weight (priority) for player-purchased titles
• default-title: Default title for the default group
• default-title-weight: Fixed weight for the default title
• default-title-color: Color of the default title
• default-buy-title-color: Default color for newly purchased titles
• title-prefix-wrap: Prefix text placed before a title
• title-suffix-wrap: Suffix text placed after a title
• separator-color: Color applied after the title so the following player name uses the configured color
• default-chat: Chat format, using %title% for the player's current title
• min-char: Minimum title length
• max-char: Maximum title length
• wait-seconds: Maximum time allowed for entering a title
• language: Language file to use, such as zh_CN or en_US
• gui: Settings for the title storage GUI
• banned-words: Forbidden word list. Title creation will be rejected if the input contains a banned word.

Use spaces only for YAML indentation. Do NOT use tab characters.

Payment

When use-item is empty:

price: 60000
use-item: ""

The plugin uses Vault to charge the configured economy amount.

When use-item is configured:

price: 32
use-item: "acacia_log"

The player must have 32 acacia_log to purchase the title. Vault is not required in this mode.

Language Files

Language files are stored in:

plugins/DSMPTitle/lang/

Available language files include:

• zh_CN.yml
• en_US.yml

The currency name is configured inside the language file:

currency-name: "金币"

English:

currency-name: "coin"

Plugin messages use %prefix% for the plugin prefix and %currency% for the configured currency name.

For example:

purchase-success: "%prefix%&a购买成功, 花费 %price% %currency%"

Color Format

DSMPTitle supports Minecraft legacy & color codes.

Examples:

&aGreen
&6Gold
&x&F&F&0&0&0&0Custom Color

MiniMessage formatting can also be used where title colors are entered directly, for example:

<rainbow>

Title GUI

The title storage GUI allows players to:

• View purchased titles
• Switch between owned titles
• View purchase time
• Navigate between pages
• View an empty-title placeholder when no titles are owned

Administrators can open another player's title storage in read-only mode.

data.yml

This file saves all player title data persistently.

If you want to edit this file manually, after edits, run /dt reload data to apply the changes.

Example data structure:

UUID: PlayerUuid
  name: PlayerName
  titles:
    - title: "Title text1"
      color: "&6"
      weight: 610
      time: timestamp
    - title: "Title text2"
      color: "<rainbow>"
      weight: 670
      time: timestamp
     active-index: byindex for active title

Notes

• LuckPerms is required because title prefixes are stored as LuckPerms PrefixNodes.
• Vault is a soft dependency and is only needed for Vault economy payments.
• If an item payment method is configured, Vault can be absent.
• Title data is stored persistently in data.yml.
• Player-purchased titles use the configured purchase price and default title color.
• Administrative title management can be performed through /dt set, /dt remove and /dt removebyindex.