🧩 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:

   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:

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