dsTitle


Description
Similar to DeluxeTags, players can set their own title. Titles can be associated with permissions, so you can change available titles per rank or player. Has database and placeholder support.

Features

• Create as many titles as you want. These titles can contain colors, styles etc.
  
  
• Players can set their own prefix and suffix (or reset it).
  
  
• Associate titles with permissions. Players can only set these titles if they if the right permissions. This can be used for rank dependant titles or as rewards.
  
  
• Prefixes and suffixes can be set seperatly, or only one of them Since 1.3.0
  
  
• Nametag support. Show the titles also in the tag above a players head! Since 1.2.0
  
  
• Ingame adding and editing of titles Since 1.4.0
  
  
• Supports YAML, H2, mySQL, Postgre and SQLite storage methods. Since 1.5.0
  
  
• It is possible to set a default prefix and/or suffix for ne players Since 1.5.0
  
  
• Can be used next to another chat plugin. Title can be inserted into existing chatformat (on the position of "[titleprefix]/[titlesuffix]"), this plugin can overwrite the chatformat or titles can simply be inserted before and after the playername. See the installation section for more info
  
  
• Like all my plugins, every single message (confirm messages, error messages etc) is fully configurable. Even the menu! So no longer these annoying pluginname tags or ugly colors.
  
  
• Registers Placeholders into PlaceholderAPI for dsTitle Suffixes/Prefixes. Use these in PlaceholderAPI by using %dsTitle_prefix% for prefix or %dsTitle_suffix% for suffix Since 1.5.3
  
  
• Registers PlaceHolders into mvdwPlaceholderAPI for dsTitle Suffixes/Prefixes. Use these in any mvdw plugin if you have mvdwPlaceholderAPI installed by using {dstitle_prefix} Since 1.5.3
  
  
• Ability to set a default prefix and default suffix (required now) Since 1.5.3
  
  
• Able to set prefix/suffix just by clicking on the prefix/suffix in the titles list (Json style messages) Since 1.5.3
  
  
• Ability to use Hex Colors in chatTag and description of titles. Use them like <#2AA8F2> and <gradient:#2AA8F2:#8BD448> Since 2.0.3
  
  
• Fixed a few bugs, including the invisible players still having their nametags shown when dsTitle is handling nametags Since 1.5.3
  
  
• Works with vault, so every big permission plugin is supported
  
  
• Possibility to automatically check for updates (but no auto update)

Example


Example of title used in chat



Example of a nametag

The config of these images can be found under 'Config' down below (it is both the 'vip' prefix and the 'vip' suffix).

Installation
Simply put the dsTitle.jar in the plugins folder of your Bukkit server

If you use a chat plugin next to dsTitles, there is a change you may need to change some config files. For some chat plugins, the changes are listed down here. If your plugin is not listed here, check first if it works without editing anything. If titles aren't displayed, try to add [titleprefix] and [titlesuffix] to the chatformat of the chat plugin. If this still doesnt work, try to change general.chat_format_player_tag in plugins/dsTitle/config.yml to the playername tag used in the chat plugin. If after all of this it still doesn't work, pm me. I don't check the comments daily, but if you send a pm i get an email.

No other chat plugin
No changes needed

HeroChat
Works for me without editing anything.

mChat
Two options:

1. Add [titleprefix] and [titlesuffix] to plugins/MChat/locale.yml: format.chat
   
   
2. Change general.chat_format_player_tag in plugins/dsTitle/config.yml to '+dn' or '+n' (depending on MChat config) and dont overwrite the chatformat

ChatManager (PermissionsEx)
Change general.use_deprecated_listener in plugins/dsTitle/config.yml to true Add [titleprefix] and [titlesuffix] to message-format in /plugins/ChatManager/config.yml

EssentialsChat
Add [titleprefix] and [titlesuffix] to chat.format in /plugins/Essentials/config.yml

DeluxeChat

Download PlaceholderAPI by clip, install it, then reboot the server. The placeholders will be installed by dsTitles next reboot.

PlaceholderAPI

Download PlaceholderAPI by clip, install it, then reboot the server. The placeholders will be installed by dsTitles next reboot.

MvdwPlaceholderAPI

Download MvdwPlaceholderAPI by Maximvdw, install it, then reboot the server. The placeholders will be installed by dsTitles next reboot.

Commands

• /title prefix - List all prefixes
  
  
• /title prefix set <name> <player> - Set your own prefix or the one of an other player to the prefix with this name
  
  
• /title suffix - List all suffixes
  
  
• /title suffix set <name> <player> - Set your own suffix or the one of an other player to the suffix with this name
  
  
• /title list - Show all (or only available) titles
  
  
• /title clear <player> - Clear your or somebody elses current title
  
  
• /title add <prefix|suffix> <name> - Create a new prefix or suffix
  
  
• /title edit <prefix|suffix> <name> <field> <value> - Edit a field of an existing prefix or suffix. Valid fields are: chattag, headtag, permission and description. Example: /title prefix member chattag &3Member Group
  
  
• /title grant <prefix|suffix> <name> <title> - Grant a prefix/suffix to somebody (needs Vault installed and ds_title.admin permission)
  
  
• /title ungrant <prefix|suffix> <name> <title> - Revoke a prefix/suffix from somebody (needs Vault installed and ds_title.admin permission)
  
  
• /title reload - Reload the configuration (needs ds_title.admin permission)

Permissions
This plugin has two major permissions:

• ds_title.player - Basic permission to use /title prefix, /title prefix set, /title suffix, /title suffix set and /title clear
  
  
• ds_title.admin - Permission to use all commands

Next to that, every command has its own permission.

• ds_title.title - Permission to use the /title command. Included in ds_title.player
  
  
• ds_title.prefix.list - Gives access to list the prefixes. Included in ds_title.player
  
  
• ds_title.suffix.list - Gives access to list the suffixes. Included in ds_title.player
  
  
• ds_title.prefix.self - Gives access to changing prefix of yourself. Included in ds_title.player
  
  
• ds_title.suffix.self - Gives access to changing suffix of yourself. Included in ds_title.player
  
  
• ds_title.prefix.other - Gives access to changing prefix of somebody else
  
  
• ds_title.suffix.other - Gives access to changing suffix of somebody else
  
  
• ds_title.prefix - Gives access to changing prefix of both yourself and somebody else
  
  
• ds_title.suffix - Gives access to changing suffix of both yourself and somebody else
  
  
• ds_title.add - Permission to add a new title
  
  
• ds_title.edit - Permission to edit a title
  
  
• ds_title.clear.self - Permission to clear your title. Included in ds_title.player
  
  
• ds_title.clear.other - Permission to clear somebodys title
  
  
• ds_title.clear - Permission to clear title of yourself or somebody else
  
  
• ds_title.reload - Permission to reload the titles from config
  
  
• ds_title.grant - Permission to grant titles
  
  
• ds_title.ungrant - Permission to ungrant titles

The permissions needed per title (if any) can be configured by yourself

Config
There are two config files. config.yml contains the basic config. titleConfig.yml contains the titles a player can set. Permissions and commands can also be found in the plugin.yml. To see more information about these files, click on the links.

Here is an example of titleConfig.yml:

prefixes:
member:
chattag: '&3Member'
permission: 'title.member'
description: 'Title for members'
vip:
chattag: '&4&lVIP'
headtag: '&4&lVIP&r '
permission: 'title.vip'
description: 'Only for VIPs '
suffixes:
vip:
chattag: '&6KING'
headtag: '&8[&6K&8]'
permission: 'title.vip'
description: 'Only for VIPs '
This config creates two prefixes and one suffixes. Players can only set these titles if they have the corresponding permissions.

The result of the vip title can be found under 'Example'.

Known issues

• In the config.yml of plugins of version 1.1.2 or lower is a character (§) which some Linux systems don't accept. You can remove it by editing the jar or by updating to the latest version.
  
  
• It seems titles dont work with some chat plugins without overriding the chat format. Should be fixed in 1.3.0

Found a bug? Create a ticket (top right of this page) or create an issue here.

Changelog
2.0.4

• Utilize HikariCP to fix database connection issues.

2.0.3

• Ability to use Hex Colors in chatTag and description of titles. Use them like <#2AA8F2> and <gradient:#2AA8F2:#8BD448> . Fixed
  some bugs.

2.0.0

• Added placeholder hooks, fixed bugs, updated for newer Java versions/ Spigot versions, code optimizations

1.5.0

• You can now save the titles of players in YAML, mySQL, h2, Postgre or SQLite: Can be changed in config.yml/storage
  
  
• You can now set a default prefix and/or suffix by setting default_prefix and default_suffix in titleConfig.yml
  
  
• Bug fix (#1 title displaying "null")

1.4.0

• /title add and /title edit added. With these commands, you can add and edit titles ingame.
  
  
• You are now able to set titles of other players:

- /title suffix set <title> <player>

- /title prefix set <title> <player>

- /title clear <player>

• Added extra permissions. Every command now has its own permission.
  
  
• Added an option in config to disable all chattags.

1.3.0

• Seperated titleprefix and titlesuffix
  
  
• Added permissions for changing prefix and suffix
  
  
• Added some extra config items which make it able to adapt to chatplugins.
  
  
• Fixed a bug reported by lanceryy

1.2.1

• {titleprefix} and {titlesuffix} replaced by [titleprefix] and [titlesuffix] to be compatible with EssentialsChat.
  
  
• Added some length checks to avoid exceptions.
  
  
• Integrated both normal and ChatManager versions into one. Set general.use_deprecated_listener in config.yml to true for ChatManager.
  
  
• Changed priority of listeners, they now insert titles after all other plugins.

1.2.0

• Added nametag support. Use 'headprefix' and 'headsuffix' in titleConfig.yml to use it.
  
  
• Fixed a bug when loading the plugin on some Linux systems
  
  
• Some little tweaks

1.1.2
Version 1.1.1, compiled and tested with Bukkit 1.5 R0.1

1.1.1
Added update checker, can be disabled/edited in the config

1.1.0

• /title grant added
  
  
• /title ungrant added
  
  
• Titles can now have both a prefix and a suffix. Use {titleprefix} and {titlesuffix} in your chatformat if you have your own format (instead of only {title})

1.0.0
Initial release

To do

• Create an optional GUI for the plugin
  
  
• Maybe: Make an option to change title color instead of making 16 different titles

Please comment if you have any suggestion.

Other plugins

PiggyBack – Allows you to carry your friends!

Elytra – Boost with Elytras!

Contribute
The source can be found on github by clickin on the button.