Stella 🌠

Stella is a star-powered player-teams plugin for Spigot & Paper servers — lightweight, fully configurable, and built to organize your players with priorities, colors, and powerful targeting.

Supports Minecraft 1.20.x – 1.21.x on Spigot/Paper (and forks like Purpur). LuckPerms & PlaceholderAPI are optional.

---

Features 💫

• Teams with priorities — when a player belongs to several teams, the highest-priority one wins as their "main" team.
• Per-team hex colors — give each team a #RRGGBB color that drives vanilla nametag & tab colors.
• Smart member targeting — add or remove players one by one, or in bulk with @all, @online, and @team:<id> to move an entire team at once.
• LuckPerms integration — mirror team membership as permission groups automatically.
• Scoreboard team hook — reflect teams as vanilla scoreboard teams so nametags take the team color.
• Auto-team on join — drop new players into a default team automatically (with a bypass permission).
• PlaceholderAPI support — 21 placeholders for chat, scoreboards, tab lists and more.
• Fully configurable messages — restyle every line the plugin sends in messages.yml.
• Developer API — query and manage teams from your own plugins, with cancellable events.
• Update checker — get notified on Modrinth releases.
• UUID-based genestorage — so memberships survive name changes. THIS PLUGIN DOES NOT WORK ON OFFLINE-MODE (CRACKED) SERVERS!

Commands 💻

Everything lives under /stella:

/stella create <id> [priority]              Create a team
/stella add <team> [target]                 Add member(s) — @all, @online, @team:<id>
/stella remove <team> [target]              Remove member(s)
/stella setname | setcolor | setpriority    Customize a team
/stella info team|player <name>             Inspect a team or player
/stella list                                List all teams
/stella reload                              Reload config & messages

For Developers 🧪

Drive Stella from your own plugin via StellaAPI (static methods) and listen to cancellable PlayerJoinTeamEvent / PlayerLeaveTeamEvent plus TeamCreateEvent / TeamDeleteEvent. Available on JitPack.

Links 🔗

• Wiki Documentation — full guides for commands, permissions, placeholders, config, and the API.
• GitHub Repository — source code and dev builds.

Support ❓

Found a bug or have a feature request? Open an Issue on GitHub so it can be tracked and resolved. For setup help, check the wiki first.

---

*Stella — a star-powered player teams plugin.