Documentation

Sommaire

• 1. Toutes les touches
• 2. Lecteur d'écran & synthèse vocale
• 3. Déplacement & case devant vous
• Curseur de case libre
• 4. Menus, inventaire, dialogues
• Saisie de texte
• Avancement et limites
• 5. Scanner & cheminement automatique
• 6. Agriculture, boutiques, combat, courrier, quêtes, pêche, minage, donjons, horloge
• 7. Jouer à plusieurs
• 8. Langue des annonces

Le mod parle directement à NVDA s'il est lancé (pilotage natif, pas de dépendance à un composant .NET manquant sous Unity/Mono). S'il n'est pas détecté, ou si un appel échoue ponctuellement, tout bascule automatiquement sur une voix SAPI via Tolk — vous n'avez rien à configurer.

Tout texte lu passe par un nettoyeur qui retire les balises de mise en forme du jeu (couleurs, tailles) et convertit les icônes de monnaie en mot (pièces d'or, tickets, orbes) plutôt que de les faire disparaître silencieusement.

La case juste devant votre personnage, dans la direction où il regarde, est décrite à chaque pas, systématiquement — même si son contenu est identique au pas précédent (par exemple plusieurs cases d'herbe à la suite). Ordre de priorité de la description :

1. Objet interactif ciblé par le jeu (culture, PNJ, coffre...) — réutilise directement le système de ciblage du jeu, donc toujours cohérent avec ce que la touche d'interaction activerait. Pour les cultures spécifiquement, une description maison (arrosée ou non, jours avant maturité) remplace le texte du jeu, trop laconique.
2. Terre cultivable/labourée/arrosée sans rien planté.
3. Obstacle physique (mur, rocher non ciblable...) détecté même sans élément interactif dessus.
4. Type de terrain (herbe, sable, pierre, eau...), lu directement dans les données de tuiles du jeu. La présence d'eau est fiable à 100% (donnée de jeu directe) ; le reste dépend du nom brut des tuiles et peut être imparfait.

Anti-rebond : rester immobile près d'une frontière de case ne redéclenche pas l'annonce en boucle — un petit délai (0,35 s) absorbe le tremblement physique naturel du jeu sans jamais rater un vrai pas.

Jusqu'ici le mod ne savait lire qu'une seule case : celle devant votre personnage. Explorer une carte inconnue devenait très laborieux — aucun moyen de savoir ce qu'il y a trois cases plus loin sans s'y rendre physiquement. Le curseur de case libre est un point de lecture que vous déplacez aux flèches n'importe où sur la carte, indépendamment de votre personnage. C'est l'équivalent du Tile Viewer de stardew-access.

• Pavé décimal active ou désactive le curseur. À l'activation il se place sur la case où vous vous tenez, ce qui donne toujours un repère connu au départ.
• Les flèches le déplacent case par case. Chaque déplacement annonce le contenu de la case, sa direction et sa distance par rapport à vous.
• Origine redécrit la case visée, Ctrl+Origine vous y conduit automatiquement, et la touche de clic gauche (Pavé 5) y agit à distance — le curseur souris est d'abord pointé sur cette case.
• Pavé multiplier ramène le curseur sur vous sans quitter le mode.
• Un bip court signale que vous atteignez le bord de la carte chargée.

Les flèches servent aussi à naviguer dans les menus : quand un menu est ouvert, il garde la priorité et le curseur libre ne les capte pas. Les flèches ne sont liées à aucune action de Sun Haven lui-même (le déplacement se fait en ZQSD), il n'y a donc pas de conflit avec le jeu.

Note technique. Sun Haven a un monde isométrique : une case ne mesure pas la même chose horizontalement et verticalement. La conversion exacte entre coordonnées de case et position dans le monde est tirée de la définition du jeu lui-même, et vit désormais à un seul endroit du mod — auparavant elle était recopiée à cinq endroits avec deux conventions contradictoires.

Poser un objet était l'une des dernières actions entièrement fermées : un aperçu suit la souris et change de teinte — blanc si l'emplacement convient, rouge sinon. Sans la vue, on ne sait ni où vise l'aperçu, ni pourquoi le clic ne fait rien.

• Prendre un objet posable en main annonce le mode placement, le nom de l'objet et, s'il fait plus d'une case, son emprise au sol (« emprise 3 sur 2 cases »).
• Le curseur libre sert à viser : activez-le et les flèches déplacent l'emplacement visé, exactement comme elles déplacent le curseur de lecture. Vous entendez donc à la fois ce qu'il y a sur la case et si l'objet peut y aller.
• Le mod annonce « emplacement valide » ou « emplacement invalide » uniquement quand cela bascule. Balayer six cases invalides s'entend une fois, pas six — c'est d'ailleurs ce que perçoit un joueur voyant, dont l'œil n'est alerté que par le changement de teinte.
• Pavé plus redit à tout moment l'état complet : objet, emprise et validité de l'emplacement visé.
• La touche de clic gauche (Pavé 5) pose l'objet à l'endroit visé.

Note technique. Le mod ne reprogramme pas le placement : le jeu recalcule déjà à chaque image la case visée et sa validité, et le mod se contente de les lire. Ce qui est annoncé est donc exactement ce que le jeu va faire, sans règle dupliquée qui pourrait diverger — et toutes les variantes (maisons, granges, arbres, papier peint) sont couvertes sans code particulier.

Chaque ville a son panneau, qui propose deux tâches renouvelées quotidiennement — un seul travail aux baraquements. C'est une source régulière d'argent, d'expérience et de relations. Visuellement, une icône au-dessus du panneau dit d'un coup d'œil s'il reste quelque chose à prendre. Sans la vue, il fallait s'en approcher, l'ouvrir, déplier chaque post-it, et espérer que quelque chose soit lu.

• Pavé Entrée, près d'un panneau, annonce les tâches du jour : leur nom, leur énoncé, et ce qu'elles rapportent.
• Chaque tâche dit si elle est « à prendre » ou « déjà acceptée » — la question qu'on se pose vraiment en repassant devant le panneau le lendemain.
• Sans avoir à ouvrir le panneau. C'est justement avant de l'ouvrir qu'on veut savoir s'il vaut le détour.
• Le panneau est nommé par sa ville, en clair : « la Grande Cité », « les baraquements » — et non par l'identifiant interne anglais collé, incompréhensible à l'oral.

Note technique. Les tâches sont lues dans le gestionnaire du jeu et non sur les post-its affichés : ceux-ci ne sont remplis qu'à l'ouverture du panneau, alors que tout l'intérêt est de savoir sans ouvrir. Seules les récompenses garanties sont annoncées — celles au choix se décident au rendu, pas au moment de partir.

Musée, autel de Dynus, aquarium : les collections qu'on remplit sur toute une partie, en y déposant des objets précis en quantité précise. Visuellement, un paquet est une grille d'emplacements montrant chacun l'objet attendu en grisé et un compteur. Sans la vue, impossible de savoir ce qu'un paquet réclamait encore : il fallait déposer au hasard et voir ce que le jeu acceptait.

• Pavé diviser répond à la seule question qui se pose devant un paquet : qu'est-ce que je dois encore rapporter ? Le nombre d'emplacements remplis, puis chaque objet manquant avec ce qui a déjà été déposé — « Blé, 2 sur 5 ; Truite dorée, 0 sur 1 ».
• En parcourant les emplacements aux flèches, chacun annonce l'objet qu'il attend et où en est le dépôt — même vide, puisque c'est justement vide qu'il porte l'information utile.
• Un paquet entièrement rempli le dit, plutôt que d'annoncer une liste vide.
• Un coffre ordinaire n'est pas pris pour un paquet : la distinction se fait sur la nature des emplacements (n'accepter qu'un objet imposé), pas sur le type de meuble ouvert — ce qui couvre du même coup toutes les variantes de paquets sans avoir à les énumérer.

Note technique. Aucune règle du jeu n'est redéfinie : le mod lit l'objet et la quantité que chaque emplacement réclame, ainsi que ce qui s'y trouve déjà. Si le nom de l'objet reste introuvable, son numéro est annoncé plutôt qu'un mot vague — un numéro se recherche, « objet » ne mène nulle part.

S'occuper des bêtes est une routine quotidienne — nourrir, caresser, ramasser ce qu'elles produisent — et tout y est signalé visuellement : une icône au-dessus de la tête de l'animal, un objet posé au sol. Sans la vue, il fallait aller au contact de chaque animal l'un après l'autre pour découvrir son état, dans un enclos où l'on ne sait même pas combien de bêtes on possède.

• Pavé moins donne le bilan de tout le troupeau présent : combien d'animaux, combien restent à nourrir, combien à caresser, et combien ont laissé un produit au sol. En une phrase, la réponse à « me reste-t-il quelque chose à faire avant de me coucher ? » — ce qu'un joueur voyant règle d'un coup d'œil sur l'enclos.
• Pour un petit troupeau, les noms des animaux concernés sont cités. Au-delà de trois, seul le compte est donné : réciter quinze bêtes serait plus long que d'aller les voir.
• Chaque animal repéré au scanner annonce aussi son propre état, plutôt que son seul nom.
• Un animal dont l'état ne peut pas être lu est compté à part et signalé comme tel, jamais rangé parmi ceux qui n'ont besoin de rien : un compte faussement rassurant serait pire que pas de compte du tout.

• Beaucoup d'écrans du jeu (menu principal, options...) ne passent jamais par la sélection clavier native d'Unity : le mod construit sa propre liste des éléments interactifs visibles à l'écran, parcourable aux flèches.
• Les infobulles natives du jeu sont lues dès qu'elles s'activent (nom réel des objets d'inventaire/équipement, pas juste « Item »).
• La quantité d'un objet empilé est annoncée avant son nom, en une seule phrase ("7, Blé") plutôt que deux annonces séparées qui se couperaient l'une l'autre.
• Les emplacements vides disent « Emplacement vide » ; les emplacements d'armure vides précisent le type attendu (« Emplacement d'armure, bottes, vide »).
• L'aide (F1) est un menu, pas une tirade : elle s'ouvre sur une liste de rubriques groupées par tâche (« savoir où vous êtes », « explorer sans bouger », « ranger son sac »…), qu'on parcourt aux flèches une par une. Les touches y apparaissent avec leur valeur réellement configurée, pas le défaut. Origine et Fin sautent au début et à la fin, un bip marque les extrémités.
• Les 7 onglets du menu principal (Tab) sont nommés par leur position réelle à l'écran, pas par un numéro interne peu fiable : Sac à dos, Arbre de compétences, Relations, Quêtes, Carte, Statistiques, Paramètres.
• Chaque onglet s'ouvre en liste, tout seul, dès qu'on arrive dessus : compétences, relations, quêtes, lieux, statistiques, réglages. Le sac à dos fait exception et garde sa grille, qui lui convient. Le geste à retenir tient en cinq touches, les mêmes partout : Tab ouvre, gauche/droite change d'onglet, haut/bas parcourt, Entrée valide, Échap referme. Les listes existaient déjà, mais derrière des touches séparées qu'il fallait connaître — et une fonctionnalité qu'il faut deviner n'existe pas vraiment. Ces touches restent utilisables pour consulter les mêmes listes sans ouvrir le menu.
• L'onglet Statistiques est le seul sans données derrière lui : le panneau n'est que du texte mis en page, un intitulé à gauche et sa valeur à droite. Les lignes sont donc reconstituées en groupant les textes par hauteur, ce qui rend à chaque intitulé sa valeur en une seule entrée.
• Le choix du personnage s'ouvre en liste sans qu'aucune touche soit à connaître : c'est le premier écran après le menu principal, et devoir s'y souvenir d'un raccourci pour choisir sa partie, c'est buter dès la première minute. Une ligne par partie — nom et date — puis Charger, Détails complets, et Supprimer en dernier, chaque action nommée avec la partie pour qu'on ne puisse pas effacer la mauvaise. La date est remise en français : le jeu l'affiche en anglais même en interface française.
• Les nœuds de l'arbre de compétences annoncent leur nom, leur rang (« 2 sur 3 », ou « prise » / « non prise » pour un nœud simple), s'ils sont verrouillés et à quelle condition, puis leur effet. Sans cela un nœud n'est qu'une icône sans texte : on parcourait l'arbre sans jamais savoir sur quoi on était.
• Les bulles de dialogue sont lues dès le début de la ligne, pas après la fin de l'animation machine à écrire.
• Quand le jeu n'affiche aucun texte visible (icônes seules), un dictionnaire de plusieurs centaines de termes traduit le nom technique de l'élément en français plutôt que de le lire tel quel en anglais.
• Navigation directionnelle réelle : les flèches suivent la disposition visuelle (ligne/colonne), pas une liste à plat. Gauche/droite restent sur la ligne et butent en bout avec un bip court ; haut/bas changent de ligne. Chaque panneau est une zone aux frontières nettes — onglets, équipement, sac à dos, barre d'action — donc on ne déborde jamais accidentellement d'une zone à l'autre.
• Ctrl+flèche saute volontairement d'une zone à l'autre, selon la disposition réelle : onglets en haut, équipement à gauche, sac à droite, barre d'action en bas. Les touches 1 à 0 sur un objet l'envoient ou le récupèrent directement du slot de barre d'action correspondant.
• Écrans en colonnes (création de personnage : catégories à gauche, personnalisation au centre, informations à droite) : Ctrl+gauche/droite saute d'une colonne à l'autre et annonce laquelle, en gardant la même hauteur. Le découpage est déduit des grands écarts horizontaux entre éléments — ce que fait l'œil — sans supposer la hiérarchie de l'écran. Les flèches seules parcourent l'écran comme avant : l'ajout ne change rien à ce qui marchait.
• La disposition de l'équipement est connue exactement plutôt que devinée : 2 colonnes (porté à gauche, apparence à droite) pour chapeau, torse, gants, jambes et dos, puis souvenir, amulette et anneau.
• Un raccourci peut n'être assigné à aucune touche. Dans le menu des raccourcis, au moment de saisir la nouvelle touche, Retour arrière ou Suppression retire l'assignation : l'action reste dans la liste, disponible si vous en voulez plus tard, mais n'occupe plus aucune touche du clavier. C'est aussi ainsi que sont livrées les actions marginales — présentes pour qui en veut, sans encombrer le clavier de tout le monde.
• Le bip de bord et la reprise en main des flèches sont désactivables séparément dans le fichier de config, section Navigation.

Taper du texte se faisait auparavant dans le silence total, ce qui bloquait purement et simplement la création de personnage : aucun moyen de savoir ce qu'on avait tapé comme nom, ni même si la frappe était prise en compte.

• À la prise de focus, le rôle du champ et son contenu actuel sont annoncés.
• À la frappe, seul le caractère ajouté est annoncé — relire toute la chaîne à chaque lettre rendrait la saisie d'un nom insupportable. L'effacement annonce le caractère supprimé.
• Toutes les touches du mod sont suspendues pendant la frappe. Sans ça, taper « p » dans votre nom annoncerait votre position, « o » l'horloge, « c » ouvrirait le tchat.
• Les champs masqués (mot de passe) ne sont jamais prononcés à voix haute.

Couvre le nom du personnage, le champ de tri de l'artisanat et le tchat, sans code spécifique à chacun.

Ce mod est développé par une IA qui ne peut ni voir ni entendre le jeu. Le code est écrit en décompilant Sun Haven et en raisonnant sur son fonctionnement réel ; la validation finale vient toujours d'un test humain. Cette section dit donc explicitement ce qui est confirmé et ce qui ne l'est pas.

Confirmé en jeu

• Boucle du mod stable sur toute une session, synthèse vocale, curseur de case, dialogues, menus et infobulles, agriculture, souris directionnelle, scanner, navigation clavier des menus.

Développé mais pas encore confirmé

• Curseur de case libre, saisie de texte, navigation dans les coffres, confort d'inventaire (tri, résumé, rangement), quêtes, relations, compétences, carte du monde, festivals, création de personnage, minage, donjons, courrier.
• Le bip de visée en pêche est la fonctionnalité la moins certaine : fréquences et tempo ont été choisis au jugé, sans jamais avoir été entendus en conditions réelles.
• Le type de terrain hors zone cultivable est déduit du nom brut des tuiles et peut nécessiter des ajustements de traduction. La présence d'eau, elle, est fiable : c'est une donnée de jeu directe.

Pas encore commencé

• Placement de meubles et de bâtiments : Sun Haven est très axé décoration, et c'est aujourd'hui impossible à l'aveugle. C'est le prochain grand chantier.
• Succès Steam : leurs noms et descriptions ne sont pas dans les données du jeu mais dans les métadonnées Steam — gros chantier pour un contenu surtout cosmétique.
• Déplacement dans la grille de l'arbre de compétences : les nœuds sont désormais lus correctement, mais le fait que les flèches se déplacent bien de nœud en nœud n'a jamais été vérifié en jeu. Une touche annonce en attendant les points disponibles par arbre.
• Traduction anglaise des annonces : le mod ne parle qu'en français pour l'instant.

Le scanner repère tout ce qui se trouve à proximité (55 cases de rayon), par catégorie, trié du plus proche au plus loin. 7 catégories :

• Personnages — tous les PNJ de la carte actuelle.
• Plantations — toutes les cultures, avec leur état (arrosée, stade de croissance).
• Ressources — rochers, arbres à cueillette, objets ramassables, minerais.
• Bâtiments et portails — entrées de bâtiments, avec leur VRAIE destination annoncée (maison, grange, boutique...) plutôt qu'un simple « Entrer ».
• Animaux et compagnons — animaux de ferme et compagnons.
• Ennemis — tous les monstres, hors PNJ.
• Mobilier et rangement — coffres (dont coffres à butin), boîte aux lettres, lit.

Cheminement automatique (Ctrl+Origine) : le personnage marche seul jusqu'à l'élément sélectionné. Le chemin est calculé à la demande par un algorithme A* maison (le pathfinder intégré au jeu s'est révélé être du code de démo jamais branché), qui tient compte des vrais obstacles physiques de la carte via la matrice de collision réelle d'Unity. Si la destination exacte est inatteignable, le personnage avance quand même jusqu'au point le plus proche réellement accessible plutôt que de ne rien faire.

Vos partenaires n'ont rien à installer. Le mod est entièrement local : il n'envoie ni ne reçoit rien sur le réseau, et n'ajoute aucune donnée à ce que le jeu échange. Sur les 26 correctifs qu'il applique au jeu, un seul annule un appel, et uniquement pour son propre objet, identifié par référence — tout le reste laisse le jeu faire exactement ce qu'il faisait. Quelqu'un qui joue avec vous sans le mod ne constate aucune différence.

• Le mod annonce qui rejoint et qui quitte la partie. Un joueur voyant sait d'un coup d'œil s'il est seul ; sans cette annonce on ne l'apprend qu'en heurtant quelqu'un au scanner, ou pas du tout. Traverser un bâtiment ne déclenche rien : Sun Haven détruit et recrée les joueurs à chaque changement de carte, donc un départ n'est annoncé qu'après plusieurs secondes d'absence réelle.
• Les autres joueurs apparaissent dans la catégorie Personnages du scanner, annoncés « son nom, joueur » pour ne pas les confondre avec les personnages du jeu, avec leur direction et leur distance — et le cheminement automatique va jusqu'à eux. Ils manquaient totalement à l'appel : les joueurs ne vivent pas dans la scène de la carte mais dans une scène persistante, que le filtre du scanner écartait.
• Les messages du tchat et les bulles de dialogue disent qui parle, l'émetteur étant retrouvé à partir de l'objet auquel la bulle est rattachée. Sans cela, rien ne distinguait un partenaire d'un personnage du jeu.
• Le mod n'annonce que vos actions. Les annonces de dégâts, de mort et les cinq annonces de pêche ne vérifiaient pas de qui il s'agissait : en coopération, les coups reçus par votre partenaire étaient annoncés comme les vôtres, avec sa santé à lui, et son bouchon déclenchait votre bip de visée. Chacune filtre désormais sur le joueur local.

Ces points demandent une seconde personne et n'ont donc jamais pu être essayés en conditions réelles : ils figurent dans la feuille de route à l'étape « Jouer à plusieurs ».

Le mod parle français ou anglais, et suit la langue du jeu sans rien avoir à régler. Il suit le jeu plutôt que Windows : on peut très bien jouer à Sun Haven en anglais sur un Windows français, et c'est la langue du jeu qui décide de celle des noms d'objets, de personnages et de lieux que le mod prononce à côté de ses propres phrases — les faire diverger donnerait des annonces à moitié dans chaque langue.

• La langue se force dans les réglages, en première entrée de la liste : comme le jeu, Français, English. C'est le seul réglage dont on peut avoir besoin sans comprendre un mot de ce que le mod dit, donc le seul qu'il serait absurde de laisser uniquement dans un fichier de configuration.
• Le français reste la langue écrite dans le code : c'est celle dont chaque tournure a été vérifiée à l'oreille par un utilisateur de lecteur d'écran. L'anglais est une couche par-dessus, appliquée au moment de parler, plutôt qu'une réécriture des 175 annonces réparties dans 56 fichiers — les modifier toutes ferait courir un risque de régression à chaque annonce, pour une langue que personne n'a encore essayée.
• Règle absolue : jamais de phrase à moitié traduite. Ce que la traduction ne reconnaît pas ressort entièrement en français, intact. Un mélange donnerait à un anglophone un mot sur deux, et à un francophone une phrase cassée — une lacune franche vaut mieux.
• Le dictionnaire qui met en français les noms techniques anglais du jeu s'efface en anglais : la source est déjà dans la bonne langue, il ne reste qu'à découper les mots. Idem pour la date d'une sauvegarde, que le jeu affiche en anglais même en interface française.
• L'aide F1 est écrite deux fois, en regard l'une de l'autre : ce sont des paragraphes, pas des annonces, et c'est la seule façon que chaque version se lise naturellement. Un garde-fou journalise l'écart si une rubrique n'est ajoutée que d'un côté — une aide qu'on n'entend pas ne se remarque jamais en jeu.

Personne n'a encore joué en anglais : les points à vérifier sont listés dans la feuille de route, à l'étape « Jouer en anglais ».