mirror of
https://github.com/deunix-educ/aventuriers-des-mots.git
synced 2026-10-13 02:11:58 +02:00
Denis Defolie
19831807b0
export_presets.cfg is hand-written (no editor GUI available here): a minimal preset per platform (name, platform, path, x86_64 architecture) is enough, since Godot fills every other option from its platform defaults. tools/setup.sh now also fetches the matching export templates (~1.2GB, cached outside the repo like the Godot binary itself) -- note the directory it unpacks into uses a dot before "stable" while .godot-version and the download URLs use a hyphen, two different spellings of the same version that are easy to conflate. Both make export-linux and make export-windows now actually run and produce a working package; tests/ and addons/gut/ are excluded from the exported .pck (124KB vs 1.5MB before -- a dev-only dependency has no business shipping to a child's machine). The Linux binary was smoke-tested headless and boots cleanly; the Windows .exe could only be confirmed as a valid PE32+ binary, since no Windows machine or Wine is available in this environment -- flagged in docs/testing/manual-checklist.md rather than claimed as verified. This closes out every step in the launch prompt's "Ordre de construction." README status lines updated to reflect the first playable prototype rather than a bare skeleton. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
45 lines
2.0 KiB
Markdown
45 lines
2.0 KiB
Markdown
# Les Aventuriers des mots
|
|
|
|
Jeu éducatif de français pour les CE1-CE2 (7-9 ans) : une aventure 2D hors ligne, avec une carte à explorer, un personnage guide, et des exercices de grammaire, d'orthographe et de dictées.
|
|
|
|
Projet open source, en développement. Statut actuel : premier prototype jouable (périmètre du §15 du cahier des charges) — démarrage, profils, carte à trois lieux, trois types d'exercices, sauvegardes, exports Linux/Windows. Contenu pédagogique encore minimal (voir `docs/specs/decisions.md` pour les décisions de cadrage et `docs/specs/cahier-des-charges.md` pour la spécification complète).
|
|
|
|
## Pile technique
|
|
|
|
- Godot 4.6 (GDScript typé)
|
|
- Exercices et contenu pédagogique en données JSON, validées au chargement
|
|
- Tests headless (GUT), lint/format GDScript (gdtoolkit)
|
|
|
|
## Démarrer
|
|
|
|
```sh
|
|
make setup # installe Godot (pinné), GUT et gdtoolkit en local, rien n'est commité
|
|
make run # lance le jeu
|
|
```
|
|
|
|
## Commandes
|
|
|
|
| Commande | Effet |
|
|
|---|---|
|
|
| `make setup` | installe l'outillage (lint, tests, modèles d'export) |
|
|
| `make run` | lance le jeu |
|
|
| `make lint` / `make format` | analyse statique et formatage GDScript |
|
|
| `make validate-data` | valide les JSON de `data/` |
|
|
| `make test` | tests headless |
|
|
| `make check` | lint + validate-data + test, à passer avant chaque commit |
|
|
| `make export-linux` / `make export-windows` | exports dans `build/` |
|
|
|
|
## Structure
|
|
|
|
- `autoload/` : modules globaux (gestion du jeu, profils, progression, exercices, sauvegardes, audio, réglages)
|
|
- `scenes/` : scènes Godot, autonomes et communiquant par signaux
|
|
- `scripts/` : logique pure (correction, pédagogie) et chargement des données
|
|
- `data/` : contenu pédagogique en JSON, validé contre des schémas
|
|
- `assets/` : graphismes et audio (provisoires à ce stade, voir `assets/CREDITS.md`)
|
|
- `tests/` : tests headless (GUT)
|
|
- `docs/specs/` : cahier des charges et décisions de cadrage
|
|
|
|
## Licence
|
|
|
|
Code et contenu sous [GNU Affero General Public License v3](LICENSE).
|