# wgamesolv

> **Words Games Solver** — Script d'aide à la résolution des jeux de mots style Wordle, SUTOM, mots-croisés, Scrabble...
> On a fait ça pour s'amuser, pas spécialement pour tricher aux jeux de mots.

**Auteurs :** AntoineVe, Brunus
**Courageux testeur des 1ères versions et précieux apporteur d'idées :** DarKou
**Licence :** MIT

---

> [!WARNING]
> Le dictionnaire `fr_FR.json` n'est plus à jour. Il doit soit être mis à jour soit remplacé par des dictionnaires de mots en x lettres, comme le nouveau `fr_A_10letters.json` (mots de 10 lettres commençant par la lettre A) qui lui est à jour (le 26 fév. 2026).

---

## Utilisation

```
wgamesolv.py -d dictionnaire.json -nb 7 [autres options]
```

## Options

### `-d`, `--dictionary` — dictionnaire à utiliser

```
-d fr_FR.json
```

Trois dictionnaires ont été fusionnés pour n'en faire qu'un : Wordle, SUTOM et l'officiel du Scrabble.

---

### `-nb`, `--nbLetters` — nombre de lettres du mot

```
-nb 7
```

---

### `-fl`, `--firstLetter` — première lettre du mot

```
-fl C
```

Cette option est intéressante que l'on connaisse ou non la première lettre : il faut en choisir une pour limiter la liste de mots possibles.

---

### `-ft`, `--firstTry` — optimisation du premier essai

```
-ft 4
```

Optimise le premier essai en sortant les mots de `-nb` lettres, commençant par `-fl`, ne contenant aucune lettre en plusieurs occurrences et contenant `-ft` voyelles.

> Cette option peut être utilisée pour le tout premier essai, pour optimiser les chances d'avoir des lettres validées. Elle est ensuite inutile ou contre-productive pour les essais suivants et **ne peut pas être utilisée avec la pattern**.

---

### `-nd`, `--noDoubleLetters` — sans lettres doublées

Filtre les mots composés d'une seule occurrence de chaque lettre.

---

### `-kl`, `--knownLetters` — lettres déjà validées

```
-kl AEP
```

---

### `-bl`, `--badLetters` — lettres déjà invalidées

```
-bl ZTOR
```

---

### `-p`, `--pattern` — lettres placées et mal placées

```
-p L.uI...
```

| Casse | Signification |
|-------|---------------|
| Majuscule | Lettre connue et **bien placée** |
| minuscule | Lettre connue mais **mal placée** |
| `.` | Position non validée |

*Exemple : `-p L.uI...` pour le mot LUCIOLE*

---

## Exemple complet

```
wgamesolv.py -d fr_FR.json -nb 7 -fl L -p L.uI... -kl U -bl AMNR
```