Documentation

Prise en main

La version courte d’abord : installez, indiquez à FixMyMesh où sont vos moteurs, choisissez un fichier .blend ou un dossier, choisissez vos cibles, lancez le test. Le reste de cette page explique quoi faire quand le résultat n’est pas PASS.

Logiciels supportés

  • Source : Blender 5.2 LTS et 4.5 LTS.
  • Cibles : Unreal Engine 5.8, 5.7 et 5.6 ; Godot 4.7 et 4.6 ; Unity 6.3 LTS et 6.0 LTS, en FBX.
  • Autres versions de Blender : FixMyMesh fonctionne quand même, au mieux, et l’écran de démarrage vous dit clairement que les résultats ne sont pas testés. Blender antérieur à 3.5 est refusé.
  • Autres versions d’un moteur cible : elles ne peuvent pas encore être testées. L’application vous dit quelle version elle a trouvée et lesquelles installer à la place.
  • Système : Windows 10 ou 11, 64 bits.
  • Langues de l’interface : anglais et français, pour l’instant.

FixMyMesh pilote les moteurs déjà installés sur votre machine. Il n’embarque ni Blender, ni Unreal, ni Godot, ni Unity, et ne les installe pas pour vous.

Indiquer à FixMyMesh où sont vos moteurs

FixMyMesh ne fouille jamais votre ordinateur de lui-même. Ouvrez les Réglages : la section Moteurs a une ligne par version supportée.

  • Pour chaque version que vous utilisez, indiquez son dossier : tapez-le, ou cliquez sur Parcourir. FixMyMesh dit ce qu’il y a trouvé, par exemple « Trouvé : 5.8.2 ».
  • Ou cliquez sur Chercher sur cette machine : FixMyMesh regarde alors aux endroits habituels (Epic Games Launcher, Unity Hub, PATH, Program Files) et remplit les lignes vides. Vérifiez-les.
  • Cliquez sur Enregistrer.

Inutile d’avoir tous les moteurs : l’application ne propose que les cibles des moteurs que vous avez configurés.

Votre premier test

  1. Sur l’écran de démarrage, choisissez un fichier .blend, ou tout un dossier.
  2. Cochez les cibles auxquelles vous livrez.
  3. Gardez le préréglage par défaut, ou choisissez celui qui correspond à votre métier.
  4. Cliquez sur Tester mon asset. Votre asset est exporté, puis réellement importé par chaque moteur, et l’avancement s’affiche par objet et par cible.
  5. Patientez. Le premier passage est plus lent, car le moteur doit démarrer et construire ses caches.
  6. Lisez le rapport.

Rien n’est envoyé nulle part : toute l’exécution se passe sur votre machine.

Lire les résultats

L’écran de résultat est une matrice : vos assets en lignes, vos cibles en colonnes, chaque case montrant le constat le plus grave pour ce couple. Cliquez sur une case pour le détail. Du moins grave au plus grave :

  • PASS : rien à signaler.
  • INFO : un fait à noter, sans conséquence pour la livraison.
  • WARNING : quelque chose a changé. Ce peut être anodin, et le rapport dit quoi, de combien, et la cause probable.
  • ERROR : un vrai défaut.
  • CRITICAL : un défaut bloquant, comme un import qui a carrément échoué.

Les problèmes bloquants, quand il y en a, passent en premier. Le score de fidélité n’est jamais montré seul : chaque catégorie est listée avec son pourcentage et son poids. Les avis sur la source, les problèmes déjà présents dans votre .blend quelle que soit la cible, ont leur propre panneau. Passez à tout moment de Simple à Detailed ou Expert ; Expert montre aussi les valeurs brutes mesurées. Exporter le rapport HTML écrit tout le rapport dans un seul fichier.

Chaque nombre est un écart mesuré entre la source Blender et ce que le moteur a réellement importé, pas une prédiction faite depuis la scène.

Préréglages, dossiers et contrôle visuel

  • Les préréglages décident de ce qui compte, avec quelle sévérité, et de ce qui bloque une livraison. Huit sont montrés d’abord, du contrôle du quotidien au profil strict d’artiste technique ; les autres sont un clic plus loin.
  • Le mode dossier : déposez un dossier au lieu d’un fichier. Chaque moteur est lancé une fois pour tout le dossier, et un asset qui échoue n’arrête pas les autres.
  • Le contrôle visuel : facultatif, désactivé par défaut. Il fait un rendu de la source et de chaque cible dans les mêmes conditions et les compare. C’est le seul contrôle qui utilise la carte graphique.

Réparer et retester

Quand une cause connue a une correction connue, FixMyMesh propose un plan de réparation en trois parties :

  • Corrections sûres : rien d’autre ne change dans le résultat livré.
  • Corrections qui demandent votre confirmation : chacune n’est appliquée que si vous la cochez.
  • Réglages à changer côté cible : ils vivent dans le projet du moteur, FixMyMesh ne les change donc jamais ; il vous donne le texte à transmettre.

Les réparations sont toujours appliquées à une copie de votre fichier Blender, jamais à l’original. Une réparation qui aggrave les choses est annulée. Testez ensuite la copie réparée sur la même cible : l’intérêt de la boucle, c’est la confirmation, pas la suggestion.

Licence

Votre clé de licence ressemble à FMM-XXXXX-XXXXX-XXXXX-XXXXX et vous est envoyée par email à l’achat. Saisissez-la une fois dans l’application : elle est activée par internet et conservée dans le Gestionnaire d’identification de Windows. L’application conserve ensuite un certificat hors ligne signé, valable 30 jours et renouvelé silencieusement en arrière-plan dès qu’une connexion existe, pour continuer à fonctionner sans connexion.

  • Essai gratuit : 3 vrais tests contre un moteur, sans carte bancaire. Un test ne compte que si un moteur a vraiment tourné.
  • Individuel : un utilisateur, jusqu’à 2 machines.
  • Studio : 5 postes, jusqu’à 10 machines.
  • Changement de machine : dans Réglages, Licence, cliquez sur Désactiver cet appareil (il faut une connexion), puis activez la nouvelle.

Ligne de commande

L’installeur peut ajouter la commande fixmymesh à votre PATH. Elle lance les mêmes tests que l’application (fixmymesh test, fixmymesh repair, fixmymesh report), écrit du JSON avec --json, et rend des codes de sortie qu’un script ou une chaîne d’intégration continue peut exploiter. Elle suit la même règle de licence que l’application.

En cas de problème

Un moteur apparaît comme absent

Indiquez son dossier sur la ligne de cette version dans les Réglages, ou cliquez sur Chercher sur cette machine, puis Enregistrer.

Le moteur ne démarre pas

Vérifiez d’abord que le moteur se lance normalement tout seul, et que le dossier indiqué dans les Réglages est la bonne installation.

Le premier passage est très lent

C’est attendu. Les moteurs construisent leurs caches au premier usage. Les passages suivants sont bien plus rapides.

Une cible a échoué, les autres semblent bonnes

C’est voulu : une cible qui échoue n’emporte jamais les autres. Son propre détail dit ce que le moteur a signalé.

Un résultat semble faux

Utilisez l’export pour le support dans l’application et envoyez-nous le paquet. Par défaut il contient le rapport et les journaux, pas votre .blend, et votre nom d’utilisateur Windows y est remplacé par un substitut. Une mesure que nous ne pouvons pas reproduire est un bug que nous voulons voir.

Clé perdue ?

Cette page est le guide court. Le guide utilisateur complet est livré avec l’application, et ce qui change à chaque version est listé dans le journal des versions.