dsTitle
dsTitle
Description
Players can set their own title. Titles can be associated with permissions, so you can change available titles per rank or player.
Features
- Create as many titles as you want. These titles can contain colors, styles etc.
- Players can set their own prefix and suffix (or clear 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.
- Works with vault, so every big permission plugin is supported
- Possibility to automaticly 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 here (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:
- Add [titleprefix] and [titlesuffix] to plugins/MChat/locale.yml: format.chat
- 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
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. 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 :P' suffixes: vip: chattag: '&6KING' headtag: '&8[&6K&8]' permission: 'title.vip' description: 'Only for VIPs :P'
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
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 (link)
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
- (1.5.0) Test database storage method by Kaltiz
- (1.5.0) Add an option to set a default prefix and/or suffix
- (1.5.0) Make sure title is invisible when player is invisible
- (1.5.0) Fix some bugs
- Maybe: Make an option to change title color instead of making 16 different titles
Maybe: Seperate prefix and suffix, so you can set both independantlySince 1.3.0Add the option of a suffix to a titleNew in v1.1.0Add a /title grant <name> <title> commandNew in v1.1.0Add vault support for permissionsNew in v1.1.0
Please comment if you have any suggestion.
Other plugins
dsPvPtop - Keeps track of number of kills an deaths in PvP and grants permissions.
PlayerHealth - Shows health below name to players who have the right permissions.
Contribute
The source can be found on github by clickin on the button.
If you like my work, feel free to donate something for my labour:
@ThisUsernameIsMine
Hello,
As you can see in your exception, the error occurs in the GroupManager plugin and because of that my plugin does not do what it is intended to do. Try contacting the maker(s) of GroupManager.
About the bug: It seems 1 of two things happen: 1. The title isn't correctly saved or 2. it is unable to load the current title on joining. Which data storage method do you use?
@THEREALbabyeater
Thanks.
Based on your reaction, it seems to me you have another plugin running which uses the scoreboard for something. Have you tried using TagAPI?
Can anyone answer?... When a player a headtag title and he logout from the server and log in again the title is gone, and he has to use the command again, how can i make the title persist even if they logout?... (logout: disconnect from server and connect again)
When trying to assign a prefix/suffix to a player using /title grant, a console error: null / Unhandled Exception (NPE) occurs under Spigot 1.7.9-R0.1 build 1443:
http://dev.bukkit.org/paste/9803/
My titleConfig.yml looks like this:
Found a nasty bug: When having a prefix and suffix set and doing /title reload, both my prefix/suffix disappear. When relogging only my prefix is restored.
Whenn only restarting the server it *always* removes the suffix and you have to re-assign it (this possibly also counts for the players that are online at the time of the reload).
I've also noticed that when joining the server vanished (invisible) using Vanish No Packet, dsTitle throws a Could not pass event PlayerJoinEvent to dsTitle v1.5.0 exception
ps: It would also be nice if you could set a prefix/suffix right away i.e. on-the-fly, without having to add a title for it.
edit: uh oh... denniss17's Last login: Feb 15, 2014 =/
Hey Denniss17!
This is the perfect plugin for our community it seems. The only thing I cant get to work is the headtags. Any tips on getting that to work? We can see the chattags in chat just fine using HeroChat and essentials chat for the list formatting. Also using plugin version 1.5.0 on 1.6.4 MCPC/forge server. If you need anything else from me let me know! We would really like to get the Headtags working though for our player ranks and jobs. :)
Thanks in advance! -B
Having issues. I can use and see all of the commands, but no titles show up on my name in chat or in my nametag. I've tried this on a bare server with no other plugins and also with PermissionsEx, it didn't work in either case.
Hello good sir, I was wondering if this plugin will work with TownyChat, the chat system used by Towny.
Version 1.5.0 will be online as soon as the Bukkit team approves it.
@virresss @Onewingseraphim @Adragondil
I was not able to reproduce this bug in version 1.5.0. I removed all permissions from myself, and was still able to set titles. Note that there should be no need to add "ds_title.player", as this is by default added to every player. Please reply if you still have any trouble, maybe with more details about which permission plugins you use.
@Kyurem55
Thanks for the report. It was indeed caused by creating a new title with /title add. The title in titleConfig.yml did on this point not contain an chattag attribute, which resulted in null in the chat. It is fixed in 1.5.0
Hello everybody,
Currently I'm looking into the bugs reported. Thanks for all reports! The next update will also include other methods to save the titles of player, like in the database (thanks to Kaltiz), and I will look into an option to set a default prefix and suffix.
Expect some changes soon
@HadrienCubic
Yes. You can grant titles with the same command in a commandblock (I don't see any reason why not). You can also grant titles via signs, but not with this plugin. I recommend using a plugin like serversigns to do this.
Is it possible to grant title to players with commandblock or signs ? I use groupmanager Thanks!
I have a problem, the prefix and the suffix don't see in the head tag I have NameTag and essentials chat
@Onewingseraphim
@Adragondil
i have same problem :/
@Onewingseraphim
I have this problem too, staff has to set people's prefixes. We have a problem where setting another person's prefix is inpossible without OP, and you need the perm to set other's in order to set your own.
@Kyurem55
It's because the titles aren't set up correctly. I suspect you have just done /title add prefix member. This seems logical, but with this plugin you need to edit the values too. do /title edit prefix member <headtag|chattag> [Member]. Headtag is the tag in the name above your head, chattag is your tag in the chat.
Having issues giving players permissions apparently, gave default group ds_title.player, but they still can't set their title, I also gave them title.member, but still no luck, I can set their title for them but it becomes a hassle, any ideas? :/
Also any way to automatically give a title to all players? I'd like everyone to have the same title unless I assign them a different one.
EDIT: Turns out the permission to give yourself a prefix isn't working correctly, the only way I could get it to work is to give permissions to allow changing for yourself and others. :/ Hopefully no one will take the time to figure that out lol
Whenever I try to set a prefix or suffix it comes out as null(playername)null. Why is it doing this?
@denniss17
Ah, we do have a plugin that affects score. Thanks for the help :)
@Adragondil
If it is set to true, it should work. There could however be another plugin on your server which does things with score/teams. This could mess up the nametags, but the chattags still work.
We seem to be having trouble with displaying the nametags, it's set to true so that's not the problem. Do we need a plugin for that?
@Adragondil
I'm sorry it took so long, I had some difficulties changing to the new Servermods API of Bukkit for update checking and the file got rejected a few times because of that (they do great work to protect server admins). I fixed it, and the file will be online soon.
How long does it take for a file to be approved by the Bukkit team?