BetterTablist icon

BetterTablist -----

Comprehensive tab list and scoreboard plugin with PlaceholderAPI integration

Download Now
38.2 KB .jar


[​IMG]

BetterTablist
A comprehensive tab list and scoreboard plugin featuring an advanced color system, PlaceholderAPI integration, and customizable layouts designed for Minecraft 1.20+ servers.​
✨ Features
  • Advanced Color System - Support for hex, RGB, HSL, gradients, rainbow effects, and glow
  • PlaceholderAPI Integration - Full compatibility with PlaceholderAPI placeholders
  • Customizable Tablist - Header and footer customization with dynamic content
  • Scoreboard Manager - Fully customizable scoreboard with player statistics
  • Bedrock Support - Compatible with Geyser and Floodgate for Bedrock players
  • Real-time Updates - Configurable update intervals for dynamic content
  • Player Sorting - Configurable player sorting system
  • Debug Mode - Advanced debugging tools for administrators
Installation
  1. Download the latest release from SpigotMC
  2. Place the JAR file in your server's plugins/ directory
  3. Restart your server or use /reload
  4. Configure the plugin using the generated config files
Dependencies
Required:
  • Java 21+
  • Spigot/Paper 1.20+
Optional (Soft Dependencies):
⚡ Showcase Video


⚙️ Configuration
Main Configuration (config.yml)
Code (YAML):

# General Settings
tablist:
  enabled : true
scoreboard:
  enabled : true
# Update interval in ticks (20 ticks = 1 second)
update-interval : 20
# Debug mode
debug : false
# Bedrock player support
bedrock-support:
  enabled : true
  different-layout : false
# Color System Settings
color-system:
  advanced-features : true
  legacy-fallback : true
 
Tablist Configuration (tablist.yml)
Code (YAML):

header :
  - ""
  - "<gradient:#FFD700,#FF6B35>✦ YourServer ✦</gradient>"
  - ""
  - "&c&lOnline : &f%server_online%&8/&f%server_max%"
  - "&a&lTime : &f%time%"
  - "&3&lPing : &f%player_ping%ms"
  - ""
footer :
  - ""
  - "<gradient:#FFE4B5,#DDA0DD>Play at:</gradient> &f&nplay.yourserver.com"
  - ""
 
Scoreboard Configuration (scoreboard.yml)
Code (YAML):

title : "&b&lYourMC"
lines :
  - ""
  - "&a$ &fMoney : &a%vault_eco_balance%"
  - "&c$ &fShards : &c%playerpoints_points%"
  - "&e$ &fKills : &e%statistic_player_kills%"
  - "&3$ &fDeaths : &3%statistic_deaths%"
  - "&9$ &fKeyall : &9%yourplugin_keyall%"
  - ""
  - "&7NA East &7(&b69&7)"
 
Advanced Color System
BetterTablist supports a comprehensive color system with multiple formats.
Color Format Examples
Format Example Result
Legacy &aGreen &cRed Standard Minecraft colors
Hex &#FF0000Red &#00FF00Green Modern hex color support
RGB &rgb(255,165,0)Orange RGB color values
HSL &hsl(300,100%,50%)Magenta HSL color space
Gradient <gradient:#FF0000,#00FF00>Text</gradient> Color gradients
Multi-Gradient <gradient:#FF0000,#FFFF00,#00FF00>Text</gradient> Multi-color gradients
Rainbow <rainbow>Amazing Text</rainbow> Rainbow effect
Glow <glow:#FFFF00>Glowing Text</glow> Glowing text effect

Testing Colors
Code (Bash):

/btab colors           # Show color examples and palette
/btab test <text >     # Test your color formats
 
Commands
Command Description Permission
/btab Show help menu bettertablist.admin
/btab reload Reload all configurations bettertablist.admin
/btab enable Enable the plugin bettertablist.admin
/btab disable Disable the plugin bettertablist.admin
/btab update Update your tab/scoreboard bettertablist.admin
/btab colors Show color examples bettertablist.admin
/btab test <text> Test color formats bettertablist.admin

Aliases: bettertablist, bt, tablist
Permissions
Permission Description Default
bettertablist.* All BetterTablist permissions -
bettertablist.admin Administrative commands op
bettertablist.use Basic usage permissions true

️ API Usage
For Developers
Code (Java):

// Get the plugin instance
BetterTablist plugin = (BetterTablist ) Bukkit. getPluginManager ( ). getPlugin ( "BetterTablist" ) ;
// Access managers
ConfigManager config = plugin. getConfigManager ( ) ;
TabManager tabManager = plugin. getTabManager ( ) ;
ScoreboardManager scoreboardManager = plugin. getScoreboardManager ( ) ;
// Use the color utility
String coloredText = ColorUtil. colorize ( "<gradient:#FF0000,#00FF00>Colored Text</gradient>" ) ;
 
Placeholders
BetterTablist fully supports PlaceholderAPI.
Server Information
  • %server_online% - Online player count
  • %server_max% - Maximum player slots
  • %server_tps% - Server TPS
  • %server_uptime% - Server uptime
Player Information
  • %player_name% - Player name
  • %player_displayname% - Player display name
  • %player_ping% - Player ping
  • %player_health% - Player health
  • %player_level% - Player level
Time & Date
  • %time% - Current time
  • %date% - Current date
  • %server_time% - Server time
Economy (with Vault)
  • %vault_eco_balance% - Player balance
  • %vault_eco_balance_formatted% - Formatted balance
Statistics
  • %statistic_player_kills% - Player kills
  • %statistic_deaths% - Player deaths
  • %statistic_mine_block% - Blocks mined
Troubleshooting
Plugin not loading:
  • Ensure Java 21+ is installed
  • Check for conflicting plugins
  • Verify Spigot/Paper version compatibility
Colors not working:
  • Enable advanced-features: true in config
  • Check server version supports hex colors
  • Use /btab test to validate color codes
Placeholders not working:
  • Install PlaceholderAPI
  • Use /papi info to verify placeholders
  • Check console for expansion errors
Bedrock players not showing:
  • Install Geyser-Spigot and Floodgate
  • Enable bedrock-support in config
  • Configure different layouts if needed
Debug Mode
Enable debug mode in config.yml:
Code (YAML):

debug : true
 
This will provide additional console output for troubleshooting.
Changelog
Version 1.0.0
  • Initial release
  • Advanced color system
  • PlaceholderAPI integration
  • Tablist and scoreboard management
  • Bedrock player support
  • Player sorting system
Contributing
  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request
Made with ❤️ by Codella​

[​IMG]
View on SpigotMC
Resource Information
Author:
----------
Total Downloads: 60
First Release: Oct 12, 2025
Last Update: Oct 12, 2025
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings