Tab Deco
TabDeco v1.1.0
I have decided to discontinue this plugin due to some reasons. But many developers requested the source, and as promised, you can find the source here: https:github.com/TheCyberBrick/TabDeco/ This means that everyone is allowed to update the plugin and hopefully you'll find someone else that continues this plugin. If you decide to continue and update the plugin, please send me a PM so I can add a link to it on this post, thanks!
The latest download of the plugin (R: TabDeco v1.1.0 for CB 1.5.2-R0.1 Jun 07, 2013) still works for Minecraft 1.6.x!
This plugin allows you to add various information/decoration to the player list. There are multiple options to decorate your menu. The menu can be edited in the config file of the plugin. TabDeco also offers a really easy to use API! It allows you to add new settings that then can be used in the configuration and new sorting systems. The only thing you have to do is to write a class that contains the sorting method/a method that returns the text for the slot.
Features
- UTF-8 Symbol support
- Ingame updating of text (Could be used for time & date)
- World specific player list
- Sorted player list (by time on server, KDR, world name and much more)
- Detailed player information by adding more than 1 slot per player
How to install the plugin
- Download the plugin
- Drag & Drop the plugin in your plugins folder
- Start your server
- Edit the created config.yml file of the plugin
- Restart your server (Important: Do not just reload)
How to configure the plugin
- Important: Size of the list doesn't matter at all. You can also set it up with only one column!
- Adding a new line starting with "-" adds a new object to the player list.
- Do not use space in front of the "-". Use tab instead
- Use the prefix "&" for color codes
- Use "#" at the start of a line to add a comment to the config
- Add "[@]" after the "-" to mark a line as "to be updated"
- Add "[@]" after "[nextslot]" to mark the following text as "to be updated". "[nextslot]" Can only be used for a custom player layout
- For everything else you need to know: Have a look at the example configurations on this page: http:dev.bukkit.org/server-mods/tab-deco/pages/example-configurations/
The configuration explains all the functions.
- Don't use any words longer than 16, otherwise they will be shortened
If you want further explanation, watch this amazing video by VariationVault
Commands
- /td debug - Enables debug mode. Shows useful information in the server log.
Pictures
A little example of what you can do with it. Would be really useful for any PvP Server:
(Remember, it doesn't matter how many slots you have. This plugin works for every number of slots, you just won't have as much space and the configuration might look different)
To-Do-List
- Ping function
- Graphical xp bar
- Different configurations for worlds
Known Bugs
- Possibly conflicts with plugins using the packet "Packet201PlayerInfo"
- Conflicts with plugins using TabAPI
- Currently not compatible with every plugin that uses player.setPlayerListName(name); Will be fixed in the next version
Reporting a bug
Please do not post any bugs in the comment section. Send me a ticket called "Bug report" using the component "Bug report" and fill in all required (*) fields, so I can help you.
Download
Make sure you are downloading the right version. These informations here could be updated before the file is approved by an administrator, the current files might not have all features mentioned on this site yet!
Plugins that use the API
- TabDecoExpansions - A plugin that adds various new settings to TabDeco for other plugins
If you make a plugin that uses my API, feel free to inform me. I'll add it to this list.
API
The API is really easy to use. The only thing you have to do, is to write a function that returns the string for the slot in the tab menu. TabDeco does the rest for you! If you want to learn how to make a plugin using this API, have a look at this. It shows two example plugins which explain everything you need to know to make a plugin using this API. There is a simple one and an advanced one that has a setting with an argument in the configuration (take [rint(x,y)] as an example). The advanced one teaches you how to add a setting which displays the x coordinate of a player that you can add as an argument. In the configuration it looks like this for example: [playerPosX(playername)]. The simple one just shows how you add a setting that shows the player name and the health. The API also allows to write totally custom player list sorters. Here you can find the two example plugins: https://github.com/TheCyberBrick/TabDeco-API-Example
Can you make it so only players in the same world as you are displayed and that option could be enabled through the config. i know it is possible.
@dotapurex1
You can use the 1.4.7 versions, they all should still work ;)
Update to 1.5?
@Icefuzion
Sure, just do that:
- &1
- Text
- &2
The two color codes won't show up on the menu, because there is nothing behind them. Also make sure that you use two different color codes.
Is it possible to change the alignment? Like centered text in the middle column (when using 3 columns)
@SmashboxGaming
Already answered, look at post #128 ;)
@MoPlants
Possible to add world support for KDR feature?
@S1lverK3y
Yeah, pretty much everything that you can't write with your keyboard :P
@MoPlants with UTF-8 characters you mean symbols like hearts, bars and stars right?
@levisn1
I didn't change anything in the plugin, so I guess spigot has changed something :) To your question: The plugin fully supports UTF-8 characters (maybe you won't see them in the editor correctly, but ingame they should show up correct). Could it be that you used the wrong format to save the file? I recommend using Notepadplusplus (replace plus with the plus symbol) and then set the format to UTF-8 :)
With the last raccomanded build seems works with Spigot. Now i have a question..how to add illegal characters? i have "????????" in the slot where i pasted the character. And how to add empty slot?
@TheFitSoldier
Yeah, that would need another function (something similar like [@]) to make text world specific. I might try it, but it makes things a lot more complicated. I can't promise that this will be in the next version, but I'll at least try it ;)
Nice, all I ask for is in the config a choice to pick global k/d or a multiverse k/d so if im in the lobby then I have 0 k and 0 d. But when I enter pvp world it says the kills in that region.
Stil doesn't works with spigot? :(
I have a little tip for those who have servers with three colums: You can use this text to make lines with a custom color that even perfectly fills the slot.
&1▔▔▔▔▔▔▔▔▔▔▔&1
The first color code is the color of the line, you can choose every color you want. The last color code is to make the text unique, make sure that you use a different one if you want to add a second line with the same color.
@TheFitSoldier
Yes, that is possible ;) Just add those three lines:
The color codes are to make the text in the slot unique, because the client won't show two slots with the same text (of course you won't see anything in those two slots because there is no text behind the color codes. Also, you can take every color code you want, they just have to be different)
Thanks for your response sir, is there anyway you could make it so that it says your Server's name in the middle top?
@LockedCraft
Well, it's not my problem that spigot works differently, this is made for bukkit (also, I didn't know spigot before people asked for compatibility) :P Anyways, packet handling of spigot seems to work different. I'll give my best to make it compatible with spigot ;)
@TheFitSoldier
1. Yeah, in the next version there will be an option to have different player lists for different worlds (I don't think there will be a seperate prefix for every line like "[W]" to make it world specific. But I might try to do that to make it even better) 2. If you mean that you want to color your player tags with this plugin: No, I don't think I will add that because it doesn't really have to do with this, does it? (if it does, tell me what you mean with it ;)) And I think it should work with TagAPI, but not totally sure.
If they get killed in MultiVerse world will it all tally up to one tab? Or for each world you can set a separate tab? Also, can this work like TagAPI where your actual "gamertag" is colored? If the "gamertag" (username above your head) is not colored with this plugin, do you know another one I could use by any chance?
The fact that it doesn't work with Spigot kills this plugin. Please add support for Spigot ASAP!