Stella • Getting Started

##1. Installation

To get started with Stella, install the plugin on your Minecraft server:

Requirements: a Spigot or Paper server running Minecraft 1.20.x – 1.21.x. CraftBukkit is not supported.
Optional integrations:
- PlaceholderAPI — adds the %stella_…% placeholders.
- LuckPerms — lets Stella add/remove a permission group when a player joins or leaves a team.

Drop the .jar into your server's plugins folder and restart. Stella generates config.yml, messages.yml and teams.yml inside plugins/stella/.

INFO

Stella stores team members by UUID, so memberships survive player name changes — there's no identifier mode to pick.

##2. Create and Manage Teams

Every action runs through the /stella command.

###Create a Team

/stella create <id> [priority]

Replace <id> with the team's id (lowercased automatically) and optionally [priority] (higher = more important when a player is in several teams). Example: /stella create red 10. Without a priority it uses teams.default-priority from config.yml.

###Managing Members

Add members
```
/stella add <team> [target]
```
Leave [target] empty to add yourself. The target can also be a player name, @all, @online, or @team:<id>. Example: /stella add red Alex or /stella add vip @online.
Remove members
```
/stella remove <team> [target]
```
Same targets as add. Example: /stella remove red Alex, or /stella remove old @team:new to pull everyone in new out of old.

###View Information

A team's details — display name, color, priority and members:
```
/stella info team <team>
```
Every team a player belongs to (their main team is starred):
```
/stella info player <player>
```
All teams at a glance:
```
/stella list
```

###Customize a Team

/stella setname <team> <name>
/stella setcolor <team> <#hex>
/stella setpriority <team> <priority>

Example: /stella setname red Red Team, /stella setcolor red #FF5555, /stella setpriority red 10. The color must be a 6-digit #RRGGBB hex and drives the vanilla nametag color when the Minecraft team hook is enabled.

###Delete a Team

/stella delete <team>

Example: /stella delete red removes the team and all its members.

###Reload

/stella reload

Re-reads config.yml and messages.yml without a restart.

##3. Optional Hooks

Open config.yml to enable integrations:

luckperms — map team ids to LuckPerms groups so membership grants/removes a group.
minecraft_team — map team ids to vanilla scoreboard teams so nametags/tab take the team color.
auto_team — automatically place teamless players into a default team on join.

See the config.yml page for the full breakdown.

##4. More Resources

Plugin
Configuration Files
- config.yml
- messages.yml
API
- Stella API

You're ready to start building teams with Stella.