> ## Documentation Index
> Fetch the complete documentation index at: https://docs.invaro.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Alliance Management

> Track allied groups, their representatives, notes, and disciplinary records

Alliance Management lets you track relationships with allied Roblox groups. For each alliance you can record representative contacts, write internal notes, and log disciplinary actions — all in one place.

***

## Alliances

Each alliance is linked to a Roblox group and has a status, colour, and optional description.

### Creating an Alliance

Click **Add Alliance** in the top-right corner, then:

1. Enter the Roblox Group ID and click the search button. The group's name, member count, and owner are fetched automatically.
2. Choose a colour for the alliance card.
3. Set a status — Active, Neutral, Inactive, or Ended.
4. Optionally add a description (internal notes about the alliance).
5. Click **Add Alliance**.

### Statuses

| Status       | Meaning                                           |
| ------------ | ------------------------------------------------- |
| **Active**   | Currently allied — shown with a pulsing indicator |
| **Neutral**  | Informal or tentative relationship                |
| **Inactive** | Alliance exists but is not currently active       |
| **Ended**    | Alliance has concluded                            |

### Managing Alliances

Each alliance card links to its detail page. Cards can be filtered by status using the filter buttons, or searched by group name or description. The refresh button re-fetches all alliance data.

Owners and Admins can delete an alliance from its card. This cannot be undone.

***

## Alliance Detail Page

Clicking **Manage** on an alliance card opens its detail page. This page has three tabs:

### Reps

Reps are Discord members assigned as points of contact for an alliance. Each rep has a role label (e.g. Rep, Lead Rep, Ambassador) chosen from the list configured in Alliance Settings.

**Adding reps** — click **Add Reps**, search for Discord members from your server, select one or more, choose a role for all selected members, and confirm.

**Removing a rep** — hover over their card and click the X button (requires appropriate permissions).

### Notes

Notes are internal log entries about the alliance. Each note is timestamped and attributed to the staff member who wrote it.

**Adding a note** — type in the text area and click **Add Note**.

**Deleting a note** — hover over it and click the trash icon (requires delete permission).

### Disciplinaries

Disciplinaries are formal records of issues with an alliance. Each record has a type (e.g. Notice, Warning, Strike, Terminate), severity, and details.

**Adding a disciplinary** — click **Add**, choose the type and severity, fill in the details, and confirm.

**Resolving a disciplinary** — hover over an open record and click the checkmark icon. Resolved records are greyed out. Resolved records can be re-opened from the same button.

**Filtering** — toggle between open and resolved disciplinaries using the **Show/Hide resolved** button.

***

## Alliance Settings

The **Settings** button in the top-right of the Alliance Management page opens the settings view (Owner/Admin only). Settings are divided into three tabs:

### Discord Message

Configure an automatic Discord post that lists all alliances and their reps.

* **Channel** — the Discord channel to post in
* **Include statuses** — which alliance statuses to include in the post (Active, Neutral, Inactive, Ended)
* **Rep line** — how each rep is formatted inside the `{reps}` variable (e.g. `• {repName} ({repRole})`)
* **Alliance block** — how each alliance is formatted inside `{alliances}` (e.g. `**{name}**\n{reps}`)
* **Rich embed** — toggle to wrap the post in a Discord embed with colour bar and fields
* **Post to Discord** — sends or updates the message in the selected channel. If a previous message exists it is edited in place.

### Rep Roles

Customise the role labels available when assigning reps to an alliance. By default these include Rep, Lead Rep, Ambassador, Liaison, and Coordinator. You can add, rename, or remove labels.

### Disciplinaries

Define the types of disciplinary actions available. Each type has a label, colour, and severity. Types can be toggled on or off without deleting them. You can also add custom types.

***

## Stats

The Alliance Management list page shows four stat cards: total alliances, active alliances, total reps across all alliances, and open disciplinaries.

***

## Access Control

Viewing the Alliance Management page requires `CanView` on the Alliance Management page (or Owner/Admin status). Creating alliances requires `CanCreate`. Editing status, colour, or description requires `CanEdit`. Adding and removing reps and notes requires `CanCreate` and `CanDelete` respectively. Deleting alliances requires `CanDelete`. Alliance Settings are Owner/Admin only.