DSMPTitle

DSMPTitle is a custom title management plugin for Paper servers. Players can purchase and manage their own custom titles, while administrators can grant, remove and manage titles for players.

Each title stores its text, color and priority independently. Title prefixes are stored through LuckPerms PrefixNodes, allowing titles to be displayed in chat and the player tab list.

Features

• Custom title purchasing system
• Multiple payment methods
• LuckPerms prefix integration
• Persistent title storage
• Title management GUI
• Title switching
• Title pagination
• Administrative title management
• Configurable title colors and prefix formatting
• Multi-language support
• Configurable banned words
• Configurable title length and input timeout
• Group-based titles

Required Dependencies

LuckPerms

Required

DSMPTitle uses LuckPerms to store and manage title prefixes.

Vault

Optional

Vault is only required when using the economy payment method.

If an item or experience payment method is configured, Vault is not required.

Economy Plugin

When using the Vault economy payment method, you also need an economy plugin compatible with Vault.

Commands

Player Commands

Command	Description
/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
/dt clear	Clear your equipped title

Administrative Commands

Command	Description
/dt gui <player>	Open another player's title storage
/dt menu <player>	Open another player's title storage
/dt clear <player>	Clear another player's equipped title
/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
/dt reload data	Reload title data
/dt reload config	Reload the main configuration
/dt reload lang	Reload language files
/dt reload group	Reload group title configuration

Permissions

Player Permissions

• dsmptitle.buy - Purchase custom titles
• dsmptitle.cancel - Cancel the current title creation process
• dsmptitle.clear - Clear your equipped title
• dsmptitle.menu - Open your title storage

Administrative Permissions

• dsmptitle.clear.other - Clear another player's equipped title
• dsmptitle.menu.other - Open another player's title storage
• dsmptitle.reload - Reload plugin configuration
• dsmptitle.reload.data - Reload title data
• dsmptitle.reload.config - Reload the main configuration
• dsmptitle.reload.lang - Reload language files
• dsmptitle.reload.group - Reload group title configuration
• dsmptitle.remove - Remove titles from players
• dsmptitle.set - Grant titles to players

Wildcard Permission

• dsmptitle.* - Access all DSMPTitle permissions

Configuration

The main configuration file is:

plugins/DSMPTitle/config.yml

Important options include:

• price - Purchase price
• use-item - Payment method
• prefix-weight - Default priority for purchased titles
• default-buy-title-color - Default color for newly purchased titles
• title-prefix-wrap - Text placed before a title
• title-suffix-wrap - Text placed after a title
• separator-color - Color applied after the title
• default-chat - Chat format using %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
• gui - Title GUI settings
• banned-words - Forbidden words for title creation

YAML indentation must use spaces. Do not use tab characters.

Payment Methods

DSMPTitle supports multiple payment methods through use-item.

Economy

price: 60000
use-item: "economy"

The configured economy amount is deducted through Vault.

Vault and a Vault-compatible economy plugin are required for this method.

Experience

price: 10
use-item: "xp"

The player must have at least 10 experience levels to purchase the title.

The configured price represents the number of experience levels to deduct.

Vault is not required.

Item

price: 32
use-item: "acacia_log"

The player must have 32 acacia_log items to purchase the title.

The configured price represents the number of items to consume.

Vault is not required.

Language Files

Language files are stored in:

plugins/DSMPTitle/lang/

Available language files include:

• zh_CN.yml
• en_US.yml

The language is selected through:

language: zh_CN

The currency name can be configured in the language file:

currency-name: "金币"

English:

currency-name: "coin"

Plugin messages can use %prefix%, %currency% and other supported placeholders.

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

Title colors can also use MiniMessage formatting where supported by the title configuration.

Example:

<✨>

Title GUI

The title storage GUI allows players to:

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

Administrators can open another player's title storage through the corresponding administrative permission.

Group Titles

Group titles are configured in:

plugins/DSMPTitle/group.yml

A group can define a title, color and priority.

Example:

default:
  title: 萌新
  color: '&7'
  weight: 1

If a group does not have a configured title, no group title is applied for that group.

Title Data

Player title data is stored persistently in:

plugins/DSMPTitle/data.yml

The data contains player titles, colors, priorities, purchase times and active title information.

Example:

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

If you manually edit the data file, use:

/dt reload data

to reload the title data.

Title Creation

When purchasing a title, the player must enter the title in chat within the configured time limit.

The minimum and maximum title length are controlled by:

min-char: 2
max-char: 9

Titles can also be rejected when they contain configured banned words or forbidden characters.

Notes

• LuckPerms is required for DSMPTitle to operate.
• Vault is only required for the economy payment method.
• Experience and item payment methods do not require Vault.
• Title data is stored persistently in data.yml.
• Purchased titles use the configured purchase price and default title color.
• Each title has its own text, color and priority.
• Administrative title management is controlled by the corresponding permission nodes.