> ## Documentation Index
> Fetch the complete documentation index at: https://docs.parsaghaei.dev/Set-3D/llms.txt
> Use this file to discover all available pages before exploring further.

# SET: 3D Edition — Pre-Production Developer Documentation

> Pre-production documentation for SET: 3D Edition, a Unity Android card game featuring Clean Architecture, Nakama multiplayer, and R3 reactive UI.

SET: 3D Edition is a planned Android game that adapts the classic SET card game into a tactile 3D experience. Players race to find valid groups of three cards on a shared board, competing against AI or other players in real time. This documentation covers the game's design, architecture, implementation plan, and engineering standards — written for junior-to-intermediate Unity/C# developers joining the project.

<Warning>
  **Pre-production** — SET: 3D Edition is currently in pre-production. No playable build exists yet. Content marked **Planned** or **Phase N** describes intended design, not implemented systems.
</Warning>

<CardGroup cols={2}>
  <Card title="Understand the Rules" icon="cards" href="/Set-3D/game-design/rules">
    Learn the complete SET rules with examples, edge cases, and validation logic.
  </Card>

  <Card title="Learn the Architecture" icon="layer-group" href="/Set-3D/architecture/overview">
    Clean Architecture, layer boundaries, DI with VContainer, and the R3 reactive UI pipeline.
  </Card>

  <Card title="Follow the Roadmap" icon="map" href="/Set-3D/roadmap/overview">
    13 development phases from project setup through Google Play launch.
  </Card>

  <Card title="Start Contributing" icon="code-branch" href="/Set-3D/onboarding/prerequisites">
    Prerequisites, repository tour, and your first contributor tasks.
  </Card>
</CardGroup>

## What is SET: 3D Edition?

SET is a pattern-recognition card game played with 81 unique cards. Each card has four attributes — **Number**, **Shape**, **Color**, and **Shading** — each with three possible values. A valid *Set* is any group of three cards where, for every attribute, all three values are either all the same or all different.

SET: 3D Edition brings this game to Android with:

* **3D cards** with idle animations, tactile feedback, and distinct visual states
* **Seven planned game modes** — Single Player vs AI, Online Multiplayer (Quick Match, Ranked, Private Room), Tournament Mode, Pass & Play, Practice Mode, Campaign Mode, and Daily Challenge
* **Server-authoritative fairness** via Nakama — the server validates every claimed Set
* **Accessibility-first design** — colorblind mode, shape assist, adjustable card sizes, and screen-reader support
* **Cosmetic-only monetization** — table skins, card backs, and symbol packs; no pay-to-win

## The Tech Stack

| Component            | Technology                                                                |
| -------------------- | ------------------------------------------------------------------------- |
| Game Engine          | Unity 2022 LTS (3D, Android target)                                       |
| Language             | C#                                                                        |
| Architecture         | Clean Architecture (Domain / Application / Infrastructure / Presentation) |
| UI Framework         | uGUI + R3 reactive library (Cysharp)                                      |
| Dependency Injection | VContainer (constructor injection)                                        |
| Networking           | Nakama server-authoritative backend                                       |
| Serialization        | Newtonsoft.Json                                                           |
| Testing              | Unity Test Framework + NSubstitute                                        |

## Quick Navigation

<CardGroup cols={3}>
  <Card title="Game Design" icon="gamepad" href="/Set-3D/game-design/concept">
    Player experience, modes, and accessibility goals.
  </Card>

  <Card title="Developer Onboarding" icon="rocket" href="/Set-3D/onboarding/prerequisites">
    Get the project running locally.
  </Card>

  <Card title="Core Gameplay" icon="circle-nodes" href="/Set-3D/core-gameplay/card-model">
    Card model, Set validation, board logic, and AI.
  </Card>

  <Card title="Multiplayer" icon="tower-broadcast" href="/Set-3D/multiplayer/authority-model">
    Nakama authority model and match lifecycle.
  </Card>

  <Card title="Engineering Standards" icon="shield-check" href="/Set-3D/standards/conventions">
    Coding conventions, patterns, and the PR checklist.
  </Card>

  <Card title="Reference" icon="book" href="/Set-3D/reference/glossary">
    Glossary, data formats, and FAQ.
  </Card>
</CardGroup>