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
@supersean62
Next version
@LihPeu
That's right, every time a player joins the plugin first has to clear the player list and then send all the new data. But in one point you are right, I should add a check if the configuration contains a death counter, because in this version it counts all the time, no matter if the configuration contains a death/kill counter.
@edyzio
Read after the link: (Important: copy from raw data!) You have to copy from the raw data text box, not from the text box above ;)
@MoPlants
That config is the default config you get on first start, you might want to fix that.
Plugin works great thanks. My timings reports show the plugins spending a lot of time on the join event, in my tab deco I do not show the current number of online plays so I'm a little confused why its like that.
http://imgur.com/hQrj97O
So the ability to turn off or onn tab deco have been added or will that be in the next version?
@edyzio
The configuration is wrong, use tab in front of the - That just remembers me, I didn't write that in the "How to configure the plugin" section. Sorry for that :P
@MoPlants
Running CraftBukkit 1.4.7-R1.0 http://gyazo.com/ef7941803aa1916c13f8186c885f3fe6 TabDeco config: http://pastebin.com/C1Fj4KH9
When server starts, nothing at all happens. No errors in console and TAB stays normal, no changes at all. Only thing that works is "/td debug" and when I turn that on I get spammed with this:
[INFO] [TabDeco] Player dutge99 is logging in! Sending packets. [INFO] [TabDeco] Removed from tab:
Have no idea what the problem could be...
@TheFaLLenNight
Open the configuration and change playerLayoutEnabled to true. Then change your playerLayout to this: [@]&2[playername] The &2 is just an exaple color code, you can use whatever you want ;)
I love this plugin but how do you get so your Username gets colored, mine is still white. thx.
@alexandercitt
Could you please send me that error with debug mode on (/td debug)? I try to fix all the bugs, but if I don't have enough information I can't fix it ;) Also, it doesn't look like it was caused by a plugin from what I see in that error log. Which version of craftbukkit are you using? Do you have other plugins installed?
@edyzio
If you want it to work, you'll need to use craftbukkit, not spigot. I'll have a look at that for the next version, but for now there's no other fix than just using craftbukkit.
@alexandercitt
One of most amazing plugins I seen as it has faction plugin options and so on. Sadly I can't get it to work :L
This plugin made my servers crash every 10 minutes after using it for 1 day.. The error:
http://pastebin.com/hhEe38Q2
Bad luck, this plugin was just awesome..
@MoPlants
I fixed that problem for now, but now when I try to run plugin with example config nothing at all happens. No errors and no tab changes, I also use BungeeCord and also have set settings to show tab per server. But still plugin does nothing at all, the debug command works which means plugin does run. I have no idea what is the problem
@MoPlants
Wow, that went quick. It's already working :) In the next version you'll even be able to chose how many slots it should display ingame without changing the actual player slots. You won't be able to see it in the multiplayer menu. Also, server hoster that you have to pay money for slots shouldn't have any problems with it because they are not "real" slots.
@edyzio
There is no fix for it. At least not for this version
@MoPlants
How do I fix that?
Since I see many people that wish to have more slots in the player list (and can't buy a server with more slots for players), I'll try to add a feature that allows you to change the amount of slots :) (just ingame, not actual slots for players)
@edyzio
No, I think it's missing some classes I need for sending the packets.
Does this plugin work with spigot? I am getting this error on start up: http://pastebin.com/DTWZA2T1
@alexandercitt
I'll try to implement that :)
Can you add Special players to be displayed in the Tab list?
Like, everyone with the permission tabdeco.staff will be displayed with [staff] (name). And everyone with the permission tabdeco.group1 will be displayed with [group1].
Whould be great to create 'Donators only' thingy at Tab!