PlayerTitle
Basic

FAQ

# 1. Can items in the title shop be translated?

1.13+ versions will automatically translate based on the configured language type.

Supports all language translations, e.g.: zh_CN, zh_TW and other locale codes.

Configuration:

Modify the language: locale_code setting in config.yml
Create a language file in the languages folder, named: locale_code.yml

For other versions, configure in item.json. Follow the JSON format and configure as needed. Configured items will be automatically translated; unconfigured ones won't. Please ensure every English word is correct. (Recommended: only localize items you actually use, add them here, then reload the config)

Example: { "NAME_TAG": "Name Tag", "PAPER": "Paper" }

Validate your JSON format: Click here (opens new window)

# 2. Garbled text or unusable on version 1.7 or 1.8

Plugin defaults to UTF-8. Please convert to ANSI encoding yourself.

# 3. Tab title or name tag title not working

The isTab feature for tab titles and name tags conflicts with scoreboard plugins. Solution: Disable isTab in config.yml and use a plugin compatible with variables (e.g., TAB) for display.
4.12.0 removes the isTab toggle, replaced by isTabPrefix and isTabSuffix (requires PlayerScoreboard)

# 3.1 TAB plugin configuration for title variables

 # This is in the TAB plugin's group.yml config file
_DEFAULT_:
  # Tab prefix
  tabprefix: "%playerTitle_use%"
  # Player name tag prefix
  tagprefix: "%playerTitle_use%"
  # Tab display name
  customtabname: "%player%"
  # Player name tag name
  customtagname: "%player%"
  # Tab suffix
  tabsuffix: ""
  # Player name tag suffix
  tagsuffix: ""

# 4. Modified prefix and suffix in config but it didn't take effect

The prefix and suffix are bound at the time the title is generated, so changes won't affect previously created titles. They will take effect for titles created afterwards. It's recommended to decide on the desired prefix and suffix before first use.

# 5. I purchased a title and it disappeared from the shop — is it one-time only? How can others buy it?

Title shop display optimization: purchased titles are only hidden for that player, and don't affect other players viewing or purchasing.

# 6. How to delete a player's title

/plt view open [player name]

# 7. Deleted the title plugin but tab and name tag still show titles — fixed in 2.7.7+

Install a scoreboard plugin to resolve the conflict, e.g., TabListPro. After resolving, delete it.

# 8. Can a title have multiple purchase conditions?

Yes, combine with a menu plugin, or use shop exchange for title cards, etc.

# 9. How to delete or change the price of a title

/plt view shop command

# 10. Can the lore in the title shop and storage be modified?

Absolutely, modify the corresponding lore in the language file.

# 11. Particle effects not showing

Check if prerequisites are loaded correctly — currently SuperTrails, SuperTrailsPro, or PlayerParticles
Check if the client has particle display enabled
Plugin completely prohibits any form of hot-reloading, please restart
After adding particles, check if the title description already shows them
After adding particles, re-equip the title for it to take effect
Particles are tested on Spigot and Paper, test other cores yourself
Check if your commands match the documentation
Don't use the same color for all three wing colors
Check backend for errors and provide them if any
Check if version is latest and particle plugin version is correct

# 12. isTab enabled but display is abnormal, e.g., missing right bracket

For servers on 1.12 and below, titles exceeding 16 characters will be truncated.
For servers on 1.13+, titles exceeding 64 characters will be truncated.
Color codes also count toward the length — this is a Minecraft mechanism with no workaround.

# 13. Is item purchase type compatible with mod items?

Test yourself. Most mods are compatible. But a very small number of special mods may not be compatible — feedback is welcome.

# 14. Item localization not working correctly on servers below 1.13

For example, clownfish becoming pufferfish (no fix, as they share the FISH material and cannot be distinguished). Please avoid using such items, or guide players to right-click to view required items.

# 15. Deleted a title but player still shows it

For better performance, title names are cached. Players will see it disappear after rejoining.

# 16. How to directly give a player a title

Add a new title and give it to the player for 30 days (creates a hidden title) /plt player addTitle xiongliu &eNew title for player 30
Set an existing title with ID 1 and give it to the player for 30 days (sets an existing title) /plt player setTitle xiongliu 1 30

# 17. How to change a permission title

Delete the existing one in /plt view shop, then add a new one.

# 18. How to convert between mysql and sqlite data

When using sqlite, configure the mysql connection info. Execute /plt convert MySQL and restart.

When using mysql: Execute /plt convert SQLite and restart.

# 19. How to disable the feature that splits titles into three types

Set enable: false in select.yml.

# 20. How to create a mysql database

CREATE DATABASE mydatabase DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

mydatabase is the database name. Specifies the character set as utf8mb4. Specifies the collation as utf8mb4_unicode_ci.

# Custom buttons — you can infinitely extend with any buttons you want, format same as this example
# 1. command: "plm open menu" Execute command as normal player (recommended)
# 2. command: "[op] plm open menu" Execute command as OP (not recommended)
# 3. command: "[console] plm open menu" Execute command as console (recommended)
# 4. command: "[close]" Close current menu
custom:
  # Back button
  back:
    enable: true
    index: 50
    name: "   &8[&aBack&8]"
    material: BARRIER
    isEnchant: false
    lore:
      - '&f- &7Click to go back'
    custom-model-data: 0
    # Command to execute
    command: "plm open menu"

# 22. How to disable the custom title feature

Find it in shop.yml and change enable to false. Same applies to disabling other GUI features.

# Custom title
titleCustom:
  enable: false
  index: 46
  name: "    &8[&aCustom Title&8]"
  lore:
    - "&f- &7Click to go to custom title"
  # Material
  material: CHEST
  isEnchant: false
  custom-model-data: 0

# 23. How to link Vault

Install both Vault and any Vault-compatible economy plugin, such as Essentials or CMI.

# 24. How to support gradient RGB colors

You can use RGBPlaceholders (opens new window)

← Image Gallery Purchase Notice→

FAQ