Tablist tweaks
Small plugin that improves the player list (shown on Tab button press)
| Default | Dimension Dots |
|---|---|
![]() |
![]() |
Features (can be disabled through configuration)
- The color of the player's name is associated with the dimension in which they are located:
Green for Overworld
Red for Nether
Purple for The End- Custom dimensions (from datapacks and mods) are supported!
- The "idle" badge is placed after the player's name if they haven't moved for some time
- Placeholders
Compatibility
PlaceholderAPI placeholders
(they can be used in other plugins such as TAB)
| Placeholder | Description |
|---|---|
%tablisttweaks_dimension_color% |
corresponding color code from config (obviously can be used to color anything) |
%tablisttweaks_dimension_dot% |
Dimension Dot with corresponding color (even if the "dimension-dots" feature is disabled) |
%tablisttweaks_idle_badge% |
empty or the "idle" badge with color from config (always empty if the feature is disabled) |
%tablisttweaks_idle_flag% |
either true or false(always false if the feature is disabled) |
Usage
Commands
/tablisttweaks is the main plugin command, which has the alias /tt.
| Command | Description |
|---|---|
/tt help [command] |
Show help for given command, for available commands otherwise |
/tt reload |
Reload config |
Configuration
- The time player has to stand still to get the "idle" badge (in seconds)
- Enable/disable features
- dimension colors
- "dimension dot" format (see images)
- "idle" badge
- dimension colors
- Colors
- default dimensions
- custom dimensions
- "idle" badge
- Plugin messages
- error
- help
- warning
Permissions
| Permission node | Default | Description |
|---|---|---|
tablisttweaks.help |
true | Allows to use /tt help (lists only available commands) |
tablisttweaks.reload |
op | Allows to use /tt reload |
tablisttweaks.admin |
op | Refers to tablisttweaks.reload by default |
Supported versions
Plugin works properly on 1.16 and above. May work on older versions, probably without problems down to 1.13.
Requires Java 1.8 or higher.
Reference
- MineShield server's tab as inspiration
Special thanks to:
- Legitimoose for amazing Paper (Bukkit) plugin (in Kotlin) project setup tutorial
- BeBr0 for Spigot (Bukkit) plugin development tutorial [RU] with very clear API explanation
All Versions
+ Add Version- Support for custom dimensions
## Fixes
- Error when entering a dimension without "environment"
- Placeholders via [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/)
- [TAB](https://modrinth.com/plugin/tab-was-taken) direct integration removal
- Configurable colors
## Fixes
- Configuration validation
- Some unexpected behaviour when calling
/tt reload
## Technical
- General code refactor
- Dimension Dots format (as an option, default false)
## Fixes
- [TAB](https://modrinth.com/plugin/tab-was-taken) compatibility improvement
- Compatibility with [TAB](https://modrinth.com/plugin/tab-was-taken)
## Technical
- Added soft dependency on [TAB](https://modrinth.com/plugin/tab-was-taken)
- In situations in which a player was not idle-tracked properly (for example if the
Tablist tweakshas been loaded via PlugMan with players present on the server) warnings would be printed to the console instead ofNullPointerExceptionspamming
- Idle badge duplication on Paper servers
- Player name truncation on Paper servers
## Technical
- Dependency and Kotlin version bump
- dependency bump
- some directory renaming
- Folia support drop (temporarily)
- Required Java version downgraded to **1.8**
- Crush on startup on Folia hotfix (plugin was sending himself a command - that was a huge crutch)
- However still works weirdly on Folia
/tt reloadcommand that reloads the config and applies the changes immediately- Config validation: if it has missing values it would be renamed and the default one would be generated
## Technical
- New project structure
- Both features may be disabled via configuration
## Fixes
- Maybe improved compatibility with other tablist plugins
## Fixes/Technical
- In-game plugin name update **(plugin directory with configuration also has been renamed)**
## Technical
- Kotlin version upgrade to 1.8.20
- Now minimum **Java 11** is required instead of **Java 13**
## Technical
- Dependencies' versions upgrade
Earlier ones could be found on [GitHub releases page](https://github.com/KruASe76/tablist-tweaks/releases)

