# Skori — catalogue de jeux

Contenu communautaire de [Skori](https://gitea.ton618.ovh/homer/skori_v2),
le compteur de points pour jeux de société : **comment compter les points**
de chaque jeu, et une **fiche de règles** rédigée par la communauté.

Le hub Skori importe ce dépôt automatiquement : un jeu ajouté ici devient
disponible dans l'app pour tout le monde (recherche dans **Jeux → Ajouter un
jeu**).

## Organisation

```
games/
  230802-azul/            # <bggId>-<nom-en-kebab-case>
    game.json             # obligatoire : nom affiché, lien vers les règles officielles
    scoring.json          # modèle de score (comment compter les points)
    rules.fr.json         # fiche de règles en français
    README.md             # notes libres (facultatif)
    assets/               # images sous licence libre (facultatif)
      assets.json         # licence, auteur et source de chaque image
    expansions/           # extensions vendues à part (une par dossier)
      <bggId>-<nom>/
        expansion.json    # ce que l'extension ajoute au jeu de base
        rules.fr.json     # ce qui change dans les règles
schemas/                  # schémas JSON (autocomplétion dans l'éditeur)
```

Le `bggId` est l'identifiant du jeu sur [BoardGameGeek](https://boardgamegeek.com) :
c'est le nombre dans l'adresse de sa page (`boardgamegeek.com/boardgame/230802/azul`).
Les informations du jeu (année, nombre de joueurs, auteurs, image…) viennent
de BoardGameGeek : on ne les recopie pas ici.

## Ce qui n'a pas sa place ici

- **Du code** : les modèles de score sont des fichiers JSON déclaratifs. Si un
  jeu demande une règle de calcul que le format ne sait pas exprimer, ouvrez
  un ticket sur le dépôt de l'app.
- **Des images sans licence libre** (visuels de boîte, logos d'éditeurs…) ni
  autorisation écrite, et des **PDF** : ce sont des œuvres protégées. Les
  images libres sont acceptées, déclarées avec leur licence (voir
  [CONTRIBUTING.md](CONTRIBUTING.md#ajouter-des-images)).
- **Le texte des livrets de règles** : une fiche de règles est un résumé
  rédigé avec vos propres mots, qui renvoie aux règles officielles.

Le CI refuse tout autre fichier que ceux listés ci-dessus.

Voir [CONTRIBUTING.md](CONTRIBUTING.md) pour ajouter ou corriger un jeu.

## Licence

Contenu sous licence [CC BY-SA 4.0](LICENSE). Données de jeux : Powered by
[BoardGameGeek](https://boardgamegeek.com).