> For the complete documentation index, see [llms.txt](https://wiki.lemoncloud.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.lemoncloud.org/gamemodes/factions/rosters.md).

# Rosters

Faction Rosters are a way for factions to lock in who is allowed to play with them during the map.

Instead of freely inviting new players at any time, factions build a roster during grace. Once grace ends, rosters become locked, and only rostered players can join that faction.

***

### What Is A Roster?

A roster is a list of players connected to a faction.

If you are on a faction's roster, you can accept that roster and join the faction without needing a normal invite.

You do not need to be online when you are added to a roster. A faction can add your Minecraft username even if you have not joined the server yet.

***

### Pending vs Accepted

You can only be accepted on one faction roster at a time. If you accept a different faction's roster, your previous accepted roster will be cleared.

***

### Commands

| Command                                  |                                                                                                       |
| ---------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| `/f roster list`                         | Shows your faction's roster.                                                                          |
| `/f roster list <faction>`               | Shows another faction's roster.                                                                       |
| `/f roster add <player>`                 | Adds a player to your faction roster.                                                                 |
| `/f roster remove <player>`              | Removes a player from your faction roster.                                                            |
| `/f roster join <player>`                | Accepts a faction roster invite. If you are factionless, this also tries to join you to that faction. |
| `/f roster leave`                        | Leaves your accepted roster.                                                                          |
| `/f roster role <player> <role>`         | Changes the role a rostered player will receive when they join.                                       |
| `/f roster swap <oldPlayer> <newPlayer>` | Replaces one rostered player with another. After grace, this is limited to 1 per day.                 |

***

### Joining A Full Faction

If you are an accepted roster member and your faction is full, the server may rotate you into the faction by removing an offline regular member.

***

### New Factions

Newly created factions will always get a minimum 5 days to freely change their roster, even when grace period ends.