Stella • Getting Started

##1. Installation

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

Requirements: a Fabric Loader server running Minecraft 1.21.1, with the Fabric API mod installed. Stella is server-side only — players can join with a vanilla client.
Optional integrations:
- Text Placeholder API (by Patbox) — adds the %stella:…% placeholders.

Drop the .jar into your server's mods folder (together with the Fabric API) and restart. Stella generates config.json, messages.json, teams.json and names.json inside config/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. All /stella subcommands require OP — see Permissions.

###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.defaultPriority from config.json.

###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 scoreboard 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.json and messages.json without a restart.

##3. Optional Hooks

Open config.json to enable integrations:

scoreboard — map team ids to vanilla scoreboard teams so nametags/tab take the team color.
autoTeam — automatically place teamless players into a default team on join.

See the config.json page for the full breakdown.

##4. More Resources

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

You're ready to start building teams with Stella.