> For the complete documentation index, see [llms.txt](https://swu-forge.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://swu-forge.gitbook.io/docs/decks/trilogies.md).

# Trilogies

The **Trilogies** page (`/trilogies`) lets you group 3 of your decks together for the Trilogy format, with automatic cross-deck validation.

## What is Trilogy?

Trilogy is a multi-deck format where each player brings 3 decks. The decks use the eternal card pool, but with extra restrictions:

* **No duplicate leaders** — each deck must have a unique leader
* **No duplicate bases** — each deck must have a unique base
* **Cross-deck copy limit** — a card can appear at most 3 times across all 3 decks combined (not 3 per deck)

Sideboards are not counted toward the cross-deck copy limit.

## Creating a Trilogy

1. Navigate to **Trilogies** in the top navigation bar
2. Click **+ New Trilogy**
3. Enter a name for your trilogy
4. Select 3 decks from the dropdown menus (each deck can only be selected once)
5. Click **Create**

Your trilogy will appear as a card showing all 3 decks with their leader and base thumbnails.

## Validation

Each trilogy shows a validation status badge:

* **Valid** (green checkmark) — all cross-deck rules pass
* **Issues** (red warning) — one or more violations detected

Click the issues badge to expand the violation list. Each violation shows:

* The card name
* What rule was broken (duplicate leader, duplicate base, or over copy limit)
* Which decks are involved

Validation runs automatically every time you view the trilogies page, using the current state of your decks.

![Screenshot: Trilogy Validation](https://cdn.swuforge.com/how-tos/trilogy-validation.png)

## Editing a Trilogy

Click the **kebab menu** (three dots) on any trilogy card and select **Edit** to change the name or swap out decks.

## Deleting a Trilogy

Click the **kebab menu** and select **Delete**. A confirmation dialog will appear. Deleting a trilogy does not delete the decks themselves.

## Deck Page Integration

When a deck belongs to a trilogy, a gold **TRILOGY:** badge appears in the deck header on the deck detail page (`/decks/[deckId]`). Clicking it navigates back to the trilogies page.

## Navigating to Decks

Each deck slot in a trilogy card is a link — click it to go directly to that deck's detail page for editing.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://swu-forge.gitbook.io/docs/decks/trilogies.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
