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
@MoPlants
thank you so much, i did not know this :3
Does the 0.0.5 kills and deaths count player kills? or mob kills?
Also my config now: http://pastebin.com/Z1zFmwG8
this doesnt show up correct.
@M4ttIAm
Yes that is possible. That's what the playerLayout setting in the configuration will be used for (It's not finished yet, so I recommend to set it to false for now).
will it be possible in the future for you to add permission nodes, so for one group their name would be in one colour and another group have a different colour depending on the permission node they have?
First successful test with my API: I wrote a little plugin that displays the player name with "Test " in front of it. Of course you could write a lot more in that function, basically whatever you want!
I used this class: http://pastebin.com/SncvDtLv
And this function to register the class:
The first argument is the name of the setting in the configuration, in this case it is "[apitest]". The second argument is your own class which is extending the class TabDecoSetting. It contains the function that tells TabDeco what it should do. The update function "[@]" is already built in, so you can even make dynamic text!
@philippexe
Close enough, I'm Swiss :P
Are you german
@philippexe
I'll do that, that's a good idea The setting in the config will look like this: "[onlinestatus(playername)]" The plugin will check if playername is online and then return Online or Offline.
can you make a player online status like Owner: TheKiller Online/Offline
The API is now in work. It will add the ability to create a new setting for the configuration and then also write the function how it should display on the tab menu (Everything is possible, you could make a slot that reads information from the internet, or add a countdown, whatever you want. The only thing you have to do is to write the function how it should diplay and tell the plugin what the setting should be called for the configuration). You'll also be able to just use the normal functions to add/remove slots.
@semirotta
That's not my plugin, that's mChatSuite. You can fix that in the configuration of mChatSuite by changing "tabbedList: +p+dn+s" to "tabbedList: +dn".
Can i in the 0.0.5 version, change the tab so the RANK of user wont show , it would only show the name? because right now i am a bit pissed off because the ranks kind a go over the names so you see half of the rank name or just few letters of the rank name but not the player name.
@JordiAB
I can't provide any links of unapproved files, it shouldn't take too long.
please give me the link to the 0.0.5
File for version 0.0.5 is uploaded (Has to be approved). It adds 4 new features:
@untergrundbiber
TabAPI does the exact same thing, it sends the packet "Packet201PlayerInfo" (using ProtocolLib if I'm not wrong). I don't see why TabAPI is bad, it just makes it easier to make a plugin like this because you can just use the functions of TabAPI to send the packets, etc.
I tried TabAPI, but it's a mess.
@semirotta
You just have to change playerLayoutEnabled to false. That feature is not fully finished yet :P
@Bobacadodl
This plugin is in beta, there is still a lot to come ;) I'll add as many configuration settings as I can, so I might try to add that. And @everyone, if you have an idea that I could add, just say it!
@untergrundbiber
I may make an API for this plugin, but I'll also make a version of this plugin that uses the TabAPI.
Please can you create an API?
I think you make the Tab-handling much smarter than TabAPI.
Would be very nice. ;)
@MoPlants
What ?! TABS? i have always been told that DO NOT USE TABULATOR in configs. Always SPACE... I HAVE BEEN LIVING IN A LIE!! 1 Issue remaining, friend joined in -> could not see him in the tab, just myself. He said he can see my name in the tab list though.
Config: http://pastebin.com/JwfB47K5
Is there a way to add more columns without increasing the player slot cap? Sorry if I missed that, I've looked through this whole page.