> For the complete documentation index, see [llms.txt](https://docs.fansports.fun/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fansports.fun/getting-started/tournaments.md).

# Tournaments

Tournaments are **real-time competitive events** where users participate in short-term competitions based on live football matches.

Players earn **FanPoints (FP)** by predicting match outcomes and player performance. FP is used to rank users on the tournament leaderboard and determine rewards once the tournament ends.

Tournaments follow a **Seasonal and Event-based model**, allowing flexible deployment across:

* Major international tournaments (World Cup, Euro, Copa America)
* Club competitions (Champions League, domestic leagues)
* Special football events

### Core Game Loop

<figure><img src="https://3152938203-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbuPoisSAzdxYe2yEqETL%2Fuploads%2FxQG2IDAmwpiOCNSH9Fxk%2Fimage.png?alt=media&amp;token=95fd106b-b22a-4191-adaf-36d55e6d5a00" alt=""><figcaption></figcaption></figure>

The Tournament system follows a continuous core gameplay loop:

1. **Squad Building**\
   Users analyze data and make predictions to build their lineup.\
   Only player cards with **Active status** can be selected for tournament lineups.
2. **Live Match Execution**\
   When a tournament starts, real-world football matches are played.\
   Match data and player statistics are updated after each match concludes.
3. **Player Scoring**\
   Each player receives a **Player Score** based on final match statistics.\
   Player Scores are used to rank players and determine leaderboard positions.
4. **Tournament Settlement**\
   At the end of the tournament, the system finalizes rankings and distributes **FP rewards** to users.
5. **Reinvestment Loop**\
   Users can use FP to purchase player packs, receive player shares, and:
   * Trade shares on the marketplace, or
   * Use them to build new lineups for future tournaments.

### Tournament Information & Match Data

The Tournament page displays:

* **Past, ongoing, and upcoming tournaments**
* A full list of matches included in each tournament

For each match, users can view:

* Detailed match information
* Player performance statistics
* Points gained or deducted after match completion

To improve usability, players can:

* Search by player name
* Use filters to quickly locate specific players or matches
