Files
wgamesolv/README.md

108 lines
2.4 KiB
Markdown

# 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
```