🧭 TeamLocatorBar

A lightweight, high-performance, and fully dynamic Minecraft plugin that dynamically changes the vanilla Locator Bar (Compass HUD) waypoint colors based on player team relationships. Perfect for team-based game modes, factions, or competitive servers!

---

✨ Features

• Dynamic Relationship Coloring: Automatically colors player waypoints on the locator bar depending on their scoreboard team.
• 3 Relationship States Supported:
  • 🟩 Teammates: Players in the exact same team.
  • 🟥 Enemies: Players in different teams.
  • ⬜ Neutrals: Players with no team assigned.
• Visibility Control (Hide Players): Setting any state to false in the config completely blocks the packet, hiding those players from the locator bar entirely!
• Blazing Fast Optimization: Uses an intelligent asynchronous event-driven system with anti-spam packet protection (debounce). Zero repeating tasks, zero main-thread lag!
• Folia Support: Built from the ground up to support multi-threaded server environments like Folia and Paper.

---

🛠️ Commands & Permissions

By default, permissions are kept simple and secure. Only Operators (OP) can execute the plugin commands. No extra permission plugins required!

• /teamlocatorbar (Alias: /tlb) - Reloads the plugin configuration files dynamically.
  • Permission: Server Operator (OP) only.

---

⚙️ Configuration (config.yml)

You can fully customize the colors using standard Hex Codes and toggle whether specific groups should be visible or hidden.

enabled: true

colors:
  teammate:
    enabled: true
    color: "#00FF00" # Green for teammates

  enemy:
    enabled: true
    color: "#FF0000" # Red for rival teams

  neutral:
    enabled: true
    color: "#FFFFFF" # White for teamless players