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:
When it without chattag .then when the player chat it will look like [ Peternull xxxmsgxxx]
@RetroHoboGames
Ok thats strange, it shouldnt do that. Nonetheless, you can fix it by adding &r to the end of the prefix. &r resets all color codes and style codes.
Hey! I was wondering, whenever i do a prefix, it would make my whole name the color and font of that prefix, for example, in the config if i did &4&lOwner for the prefix, it would make it so my whole name would be (pretend it is colored red) OwnerRetroHoboGames if u can tell me how to fix this that would be great! thank you!
@denniss17
Thanks denniss17! I got it !
On the other hand, i want to report the /title reload . When i started the server then i have to edit the titleconfig.yml and changing the headtag color code .After editing i type /title reload and /title prefix set admin but the color seem writtten to memory no change . However , in the preview version it can change it immediately. Hope you can help us . Thank you so much!
@lanceryy
No its "/title grant prefix lanceryy vip". This will add the permission needed for the vip prefix to lanceryy (you)
@broluigi
What do you mean exactly? That if a player is in a group called "vip", the prefix/suffix "vip" wil automaticly be set?
In the website you say using ใ/title grant <prefix|suffix> <player> <title>ใ
In-game you say using ใ/title grant <suffix|prefix> <player> <title>ใ
a little bit confuse
can list some example?
is it correct ?
/title grant vip vip lanceryy vip ???
is there some way to automate this? I want all vip ranks to have vip suffixes nest to their names
@lanceryy
Thanks for the reply, I fixed the bug in the latest version (1.3.1). There was an index wrong which caused the permission being added to a player called "prefix" or "suffix", depending on which you granted.
Ow and you did notice /title grant <player> <title> changed to /title grant <prefix|suffix> <player> <title>? If you have just overwritten the .jar, the wrong usage message is still in config.yml. Fix: delete the lines in the config and reload.
OH ! the latest one fail to /title grant player ....
@denniss17
denniss17 , Thank you for your help and share the great plugin for us. Will you develop more plugins ? Oh! yup ! We will support you.
@lanceryy
My fault, will fix it in the next update which will come soon. Anyways thanks for reporting!
@Typical_Name
Hello,
First of all: Thanks for your reply.
I think dsTitle currently doesn't work with Herochat, because Herochat uses {sender} in the format, while dsTitle trys to paste in the titles before and after "%1$s", which in the default chatformat of MineCraft is replaced by the players name.
I will take a look at it, as well to other chat plugins.
2013-08-23 13:52:49 [INFO] [dsTitle] Enabling dsTitle v1.2.1 2013-08-23 13:52:49 [SEVERE] Error occurred while enabling dsTitle v1.2.1 (Is it up to date?) java.lang.StringIndexOutOfBoundsException: String index out of range: -1 at java.lang.String.substring(String.java:1875) at denniss17.dsTitle.TeamManager.cleanUpTeams(TeamManager.java:103) at denniss17.dsTitle.DS_Title.onEnable(DS_Title.java:53) at org.bukkit.plugin.java.JavaPlugin.setEnabled(JavaPlugin.java:217) at org.bukkit.plugin.java.JavaPluginLoader.enablePlugin(JavaPluginLoader.java:457) at org.bukkit.plugin.SimplePluginManager.enablePlugin(SimplePluginManager.java:382) at org.bukkit.craftbukkit.v1_6_R2.CraftServer.loadPlugin(CraftServer.java:286) at org.bukkit.craftbukkit.v1_6_R2.CraftServer.enablePlugins(CraftServer.java:268) at net.minecraft.server.v1_6_R2.MinecraftServer.l(MinecraftServer.java:319) at net.minecraft.server.v1_6_R2.MinecraftServer.f(MinecraftServer.java:296) at net.minecraft.server.v1_6_R2.MinecraftServer.a(MinecraftServer.java:256) at net.minecraft.server.v1_6_R2.DedicatedServer.init(DedicatedServer.java:164) at net.minecraft.server.v1_6_R2.MinecraftServer.run(MinecraftServer.java:397) at net.minecraft.server.v1_6_R2.ThreadServerApplication.run(SourceFile:582)
@Typical_Name
I just read around this page and it turns out you can either use the default chat format from dsTitle, or you can use the chat format from essentials chat, which lets you use more customization. But it seems for now no other chat system is supported.
Would you mind allowing us to change the format a bit more. We can change what is inside of the < brackets > but i like to use [ these brackets ] and when i change them to those brackets, the entire format resets... also, putting : outside of the brackets seems to reset it too.
[EDIT]: I figured out how to set it up properly with essentials chat, and all is well now.
A couple of suggestions:
I strongly approve of the idea of separating the prefix and the suffix. It would be very useful to me. Additionally, being able to set the color of one's title (without having to make a title for each possible color) would be nice, although a lower priority.
Thanks
EDIT: Also, I can't seem to get any titles to show without setting overwrite_format to true (if I set it to false, dstitle appears to have no effect on chat). I am using Herochat. Do you know if this is a bug of some sort? Am I supposed to be able to see titles without having it overwrite the format of other chat plugins? Herochat should be able to pick up any titles I set.
@C0nd3mn3d
Ok I uploaded 1.2.1, it now needs approval from the Bukkit team
@denniss17
Fantastic, thankyou. :)
Ok there seem to be a couple of bugs, ill look at it now. Srry for late reaction, I have been on vacation.
@C0nd3mn3d
Happens to me too, I use essentials chat
@denniss17 help fix this!