56 lines
4.8 KiB
Markdown
56 lines
4.8 KiB
Markdown
# Réalisation et validation V1
|
||
|
||
Cible : Minecraft 1.21.1 / NeoForge 21.1.235 / Java 21 / Easy NPC Core 7.12.1.
|
||
|
||
## Implémentation
|
||
|
||
- [x] Identité du mod, configurations, intégration obligatoire Easy NPC.
|
||
- [x] Boutique persistante, cinq objets de construction, inventaires et outil de liaison.
|
||
- [x] Validation des zones, parcours, spécialisations et chunks, contours côté client.
|
||
- [x] Framework extensible et production Vanilla : 2×2, 3×3, four, haut fourneau, fumoir, taille de pierre, forge.
|
||
- [x] Provenance par boutique/session/propriétaire, lots manuels, exclusion des anciens résultats et des apports automatiques.
|
||
- [x] Graphe de recettes, alternatives, cycles, quantités, restes, combustible et stock sans doublons.
|
||
- [x] Sessions STANDARD/CHILL, commandes jusqu’à trois lignes, livraison atomique pour les interactions normales, paiement et crédit persistant.
|
||
- [x] Clients Easy NPC, file, navigation, dialogues, sortie, récupération des blocages, réputation et fermetures.
|
||
- [x] Écrans, modèles utilisant les textures Vanilla, recettes d’obtention, traductions FR/EN, documentation et scripts d’installation/validation.
|
||
- [x] Extension de test ajoutant famille, station, recette et handler sans modifier le cœur.
|
||
|
||
## Contrôles exécutés — 17 septembre 2026
|
||
|
||
**14 tests unitaires**, sans échec :
|
||
|
||
- Règles des deux modes, réputation CHILL à 500, progression STANDARD.
|
||
- Prix multi-produit et arrondi unique après multiplicateur.
|
||
- Recettes récursives, tailles de lots, restes, ressources partagées, alternatives, cycles, combustible, budget de recherche et absence de mutation lors d’un échec.
|
||
|
||
**21 GameTests**, sans échec sur serveur Minecraft/NeoForge avec Easy NPC :
|
||
|
||
- Sérialisation de boutique, modes et invalidation des anciens marquages.
|
||
- Livraison exacte sur plusieurs piles, surplus et refus sans consommation partielle.
|
||
- Craft 2×2, 3×3 et shift-craft ; rejet des intermédiaires externes et fabrications hors zone.
|
||
- Fours manuels, haut fourneau, fumoir ; rejet du chargement automatique, des anciennes sorties et des mélanges par entonnoir.
|
||
- Tailleur de pierre, transformation netherite, restes de fabrication marqués.
|
||
- Permissions des stockages, limitation des sessions, inventaire plein et crédit restant.
|
||
- Transfert stockage → grille → curseur sans duplication du stock.
|
||
- Humanoïde et villageois Easy NPC : apparition, navigation et suppression.
|
||
- Cycle client → commande → fabrication → livraison → paiement → départ ; double validation sans double paiement.
|
||
- Fermeture neutre après obstruction du parcours.
|
||
- Extension indépendante de production ; entonnoir incapable de retirer le stock sécurisé.
|
||
|
||
Les joueurs simulés des GameTests ne négocient pas les canaux réseau Easy NPC : son API peut journaliser un refus de bulle de dialogue vers ces connexions simulées. La synchronisation avec un vrai client est couverte séparément.
|
||
|
||
**Test graphique automatisé réussi**, dans un affichage Xvfb isolé : chargement des mods, connexion au serveur intégré, création d’une boutique, arrivée du PNJ au comptoir, réception de la commande et affichage de l’écran français. Capture inspectée : `run/clientSmoke/counter-smoke.png`. Témoin d’exécution : `run/clientSmoke/counter-smoke.ok`.
|
||
|
||
**Construction du JAR réussie.** Rapports unitaires : `build/reports/tests/test/index.html`. Bilan serveur : `build/reports/gametest.log`. Le script de vérification exige un bilan non vide de tests réussis, en plus du code de sortie Gradle.
|
||
|
||
## Limites des preuves et recette manuelle
|
||
|
||
Les tests automatiques ne remplacent pas une partie prolongée. Les points suivants restent à éprouver avant de qualifier une version publique de stable :
|
||
|
||
- Deux vrais joueurs sur un serveur dédié : réapprovisionnement par un ami, reconnexion, échanges rapides et inventaires pleins.
|
||
- Arrêt puis redémarrage complet d’un serveur avec boutiques et crédits, récupération des anciens PNJ dans des chunks chargés ultérieurement. La sérialisation et l’invalidation par session sont testées ; cette séquence disque/processus complète n’est pas automatisée.
|
||
- Déchargement réel des chunks, rechargement de datapacks et reconfiguration en cours de jeu.
|
||
- Parcours avec relief, obstacles mobiles et autres types d’entités Easy NPC configurés.
|
||
- Équilibrage des prix, de la patience et des quantités ; performances avec un modpack volumineux et de nombreuses boutiques actives.
|
||
|
||
La V1 utilise des recettes à résultat déterministe. Les objets à composants particuliers et mécanismes non pris en charge sont exclus. L’estimation de combustible/durée est conservatrice pour les machines déjà en cours de cuisson. Farmer’s Delight, automatisation admissible, assistants, feu de camp et recettes spéciales sont prévus après cette version.
|