Better Tablist

🧩 BetterTablist

A powerful and customizable tablist plugin for your Minecraft server – designed with flexibility, performance, and clarity in mind.

✨ Features

- 🔧 Per-server tag configuration Use global config files like `citybuild.yml`, `minigame.yml`, and more – assigned via `server_tag`.

- 📁 Global config directory Organize all your tablists in one central location: `network/tablists/`.

- 🧠 Automatic fallback If no matching config is found for a server, a `template.yml` file is used as fallback.

- 🪄 Animated header & footer Create smooth animations using simple YAML lists – with optional randomization.

- 🧩 PlaceholderAPI support Supports your favorite placeholders like `{player}`, `{online}`, and custom ones.

- ✅ No console spam Smart logging only warns about missing files every 2 minutes to keep the console clean.

🛠️ Setup

1. Drop the plugin `.jar` into your `/plugins/` folder 2. Start your server once – config files are auto-generated 3. Edit your `config.yml` and set: ```yaml server_tag: citybuild global_config: "../network/tablists/" ``` 4. Customize the matching `citybuild.yml` file in your global config folder 5. Done! The tablist now updates based on your settings 🎉

🔧 Configuration Example

Example `citybuild.yml`:

```yaml use_animated_header: true animated_header: - ["&6Welcome, &e{player}!", "&7Enjoy your stay!"]

use_animated_footer: true animated_footer: - ["&aVisit our Discord!", "&fdiscord.gg/yourserver"]

header: - "&bStatic fallback header"

footer: - "&eStatic fallback footer" ```

🔄 Compatibility

| Minecraft Version | Plugin Version | Status | |-------------------|----------------|------------| | 1.21.4 | v1.0 | ✅ Tested | | future | TBD | ⏳ Planned |

Works with Spigot, Paper, and compatible forks.

📎 Notes

- All dynamic tablist content is controlled from global YAML files - `config.yml` is only used for the `server_tag` and path to global config - `template.yml` is used as fallback if the tag is missing or unknown