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
@xBooBoo
In the configuration you sent you didn't use tab, did you?
@MoPlants
I did use tab, which is why I'm so confused..
@xBooBoo
Just replace all space in front of the dash with tab, then it should work :)
I'm currently working on the configuration to make it less sensitive, even though it does say it in the tutorial:
Do not use space in front of the "-". Use tab instead
It's not working for me.. I have it all set up right, I think, and it's not popping up when I press tab. Here's my config. -> http://pastie.org/7946374
@cam7763
Download the JRE for Mac and it should work for you! Worked for me! https://jdk7.java.net/download.html
@cam7763
Hmm I'll see what I can do, maybe I can copile the next version also for an older java version.
@SnowGears
Yeah, as I said, there will be a public function for developers which toggles the custom player list for a player, e.g. like this toggleList(playername);
Btw, is there a way to directly include a (youtube) video in the op?
@MoPlants
Okay cool thanks. Could you also add this method in the form of the API and not just by command? I would really appreciate it. Once you finish the API for that I would love to know because then I can finally implement it into my plugin. Thanks for doing this. I know what its like to have a bunch of different projects going on at once so no rush. Just let me know when it is done and I will check back on this page once in a while to see how its coming. Thanks!
well darn i have an older mac and i cant update to java 7 :( Noo tab deco for meh :'(
@cam7763
If I'm not mistaken, unsupported class version means that you aren't using the correct java version. No clue what this plugin is compiled for though since I've rarely had this problem, perhaps you need to update to Java7.
This is pretty cool, I love it and am going to use it. However, the fact that you had tabs in the yml really confused me at first. xD
@cam7763
Are you using bukkit or anything else (e.g. like Spigot)? If so, that could be the problem. Otherwise I need a detailed error report ;)
@SnowGears
Yeah, this is added to my todo list. The player will be able to toggle custom player list (if they have the permission to do so). For now you could use the API and write a custom handler that only sends the custom packets if it should, otherwise just send normal packets. But as I said, I'm going to implement that as a command and function which makes it a lot easier for developers as they don't have to totally rewrite the handler.
Also sorry for my absence, just don't have that much time atm
It does not work for my server it says "unsupported class version" So it wont load but if it was updated to !.5.2 it would work
Hey I like what you are doing with this plugin and I love the fact that it does not require protocollib like TabAPI does. I have a quick question though. Is there a quick way to reset the tab list for a player to the default "players online" tab?
I need to show the custom tab for a while but after I need to reset it back to normal. Hope you can help me with this! I would really like to use this in my plugin Battleground!
@cam7763
The plugin works here using 1.5.2, you must have configured it wrong.
Hey i love your plugin i have never had it but i i rely want it but it wont work so when will the "1.5.2" patch be out for it plz tell me :)
next version? 1 month past
@mohawkguy360
Yeah, because your configuration is wrong. You have to use tab instead of space, you can have a look at the example configurations
The plugin just outright doesn't work. Here is my config: http://pastie.org/7814350 Yes the plugin is installed. Latest plugin version on Bukkit 1.5.2.
@mormaii2
Sorry for the delay, should be really out soon. Don't have much time at the moment :/
@peti446
I don't really understand your question, but if you ask for making the player list bigger, it's currently not possible without changing the amount of slots (I am working on it and it already works, but it's pretty buggy because sometimes it can kick the player or it just won't show up)
Why can i add mor slot in my tab list because i have a server from 20 slot but i will have more slot in the tab list why can i do it ?