Votre première session

Bien démarrer

Préparer sa première session weSkel.

WindowsPackage en préparation

weSkel réunit les outils de rig, de skin, d’animation et de design de contrôleurs dans Maya. Ce guide t’oriente vers l’installation, la première ouverture et les mises à jour.

Tu souhaites…	Aller à…
Installer weSkel pour la première fois	Installer weSkel
Utiliser une installation déjà disponible	Ouvrir un premier outil
Comprendre comment mettre weSkel à jour	Mettre à jour
Trouver une solution à une erreur	Dépannage

Avant de commencer

Repère	Ce qu’il faut savoir
Windows	Plateforme visée pour la première distribution.
Maya 2025.3 et 2026.3	Cibles du futur package. Sa validation d’installation et de mise à jour reste à terminer.
Une installation déjà disponible	Les guides permettent de découvrir les outils et leurs commandes d’ouverture.
Une copie source autorisée	La méthode manuelle actuelle est conservée ci-dessous ; ses exemples utilisent Maya 2026.3 sous Windows.

Les deux packages prévus répondent à des usages différents :

Package	Usage prévu
User	Utiliser les outils, avec leurs icônes et accès dans Maya, sans avoir à utiliser Git. C’est le package destiné aux artistes.
Dev	Contribuer au développement avec un accès autorisé aux sources et aux outils de développement. Cet accès est séparé du wiki utilisateur.

Installer weSkel

Le package User est en préparation. Le lien de téléchargement, le fichier à lancer et les captures de l’installateur seront publiés avec la procédure validée.

Si weSkel est déjà configuré sur ton poste, passe directement à la première ouverture. Si tu disposes d’une copie source autorisée, la méthode manuelle reste accessible dans le panneau suivant.

Installation manuelle actuelle — Maya 2026.3 / Windows

Cette méthode concerne un dossier source complet weSkel, déjà obtenu. Elle ne décrit pas le futur package compilé. Conserver le nom du dossier, tous les scripts et toutes les ressources fournis.

1. Placer le dossier

Choisir un emplacement où conserver weSkel. Voici un exemple d’organisation ; l’arborescence est abrégée :

C:/maya_tools/
└── weSkel/
    ├── __init__.py
    └── src/
        └── resources/

2. Conserver l’installation

Fermer Maya, puis ouvrir ou créer le fichier Maya.env dans le dossier Documents/maya/2026/ de ton utilisateur Windows. Ajouter cette ligne, adaptée à ton emplacement :

PYTHONPATH = C:/maya_tools

Situation	Action
Aucune ligne `PYTHONPATH` n’existe	Ajouter la ligne ci-dessus sur sa propre ligne.
Une ligne `PYTHONPATH` existe déjà	Conserver ses chemins et ajouter le parent de weSkel à la même ligne, séparé par `;`.
Le fichier vient d’être créé	Vérifier que son nom exact est `Maya.env`, sans extension `.txt` ajoutée.

Enregistrer, puis redémarrer Maya pour charger la configuration. Référence Autodesk : Maya.env.

Maya est configuré par un studio

MAYA_ENV_DIR peut désigner un autre emplacement pour Maya.env. Un PYTHONPATH défini par Windows ou par le lanceur du studio prend priorité sur celui de Maya.env : faire ajouter le parent de weSkel à cette configuration. Référence Autodesk : chemins.

3. Vérifier que Maya trouve weSkel

Dans un onglet Python du Script Editor, exécuter :

import weSkel

print(weSkel.__file__)

Résultat attendu : un chemin vers weSkel/__init__.py, par exemple C:/maya_tools/weSkel/__init__.py. Le lecteur et les séparateurs peuvent différer ; vérifier surtout qu’il s’agit de la copie que tu viens de placer.

Si ce chemin est correct, continuer avec la première ouverture. Si Maya affiche une erreur ou une autre copie, consulter le dépannage.

Option : tester pour cette session, sans modifier Maya.env

Cette méthode remplace temporairement l’étape de configuration. Elle permet d’essayer weSkel dans la session actuelle, mais devra être répétée après chaque redémarrage de Maya.

Dans le Script Editor Python, adapter tools_root au dossier parent de weSkel, puis exécuter le bloc entier :

import sys
from pathlib import Path

tools_root = Path(r"C:\maya_tools")
if not (tools_root / "weSkel" / "__init__.py").is_file():
    raise FileNotFoundError("Expected weSkel/__init__.py inside tools_root.")

if str(tools_root) not in sys.path:
    sys.path.insert(0, str(tools_root))

import weSkel

print(weSkel.__file__)

Vérifier le chemin affiché comme ci-dessus. Si une autre copie a déjà été importée, redémarrer Maya avant de tester le bon dossier. Pour conserver l’installation, reprendre ensuite l’étape Conserver l’installation.

Ouvrir un premier outil

Une fois weSkel disponible dans Maya, commencer par ouvrir Chroma. Dans le Script Editor Python, exécuter ce bloc :

from weSkel.src.ui import chroma

chroma.show_dockable(floating=True)

Tu peux maintenant suivre le guide Chroma pour choisir une couleur et l’appliquer à la sélection, ou passer à un autre outil ci-dessous.

Choisir un outil

Chaque guide présente l’usage de l’outil et son code d’ouverture. Les noms des outils restent identiques dans les deux langues.

Domaine	Tu souhaites…	Guide
Rig	Construire ou modifier un module de rig	Module Manager
Rig	Créer des correctifs de pose	Pushers
Skin	Examiner les influences par vertex	Skin Influences per Vertex
Animation	Passer entre FK et IK sur Arm ou Leg	Switch FK/IK
Utilitaires	Gérer les couleurs des contrôleurs et les palettes	Chroma

Mettre à jour

La procédure de mise à jour du package User sera publiée après validation de l’installateur. Les étapes exactes et la conservation des préférences seront documentées avec la version distribuée.

Précautions pour une installation manuelle existante

Étape	Action
1. Conserver ses données	Sauvegarder les palettes, presets et préférences personnels. Par défaut, les données sont dans `weSkel/user_data/` ; si `WESKEL_USER_DATA_ROOT` est configuré, sauvegarder le dossier qu’il désigne.
2. Fermer Maya	Fermer les sessions qui utilisent la copie à mettre à jour. Conserver l’ancienne copie avant de remplacer les fichiers.
3. Appliquer la mise à jour fournie	Suivre les consignes accompagnant la nouvelle copie. Si son emplacement change, adapter le chemin décrit dans l’installation manuelle.
4. Vérifier après redémarrage	Relancer Maya et vérifier le chemin avec `import weSkel`, puis `print(weSkel.__file__)`, avant d’ouvrir un outil.

Les données personnelles d’une ancienne copie ne sont pas transférées automatiquement vers une nouvelle installation. Conserver leur sauvegarde jusqu’à avoir retrouvé les éléments attendus.

Résoudre un problème courant

Symptôme	Vérification ou action
`No module named 'weSkel'`	Vérifier le nom du dossier, la présence de `__init__.py` et le parent déclaré dans `PYTHONPATH`. Redémarrer Maya après une modification de `Maya.env`.
`Expected weSkel/__init__.py inside tools_root.`	Dans le test temporaire, le chemin désigne le mauvais parent, ou le dossier est incomplet ou imbriqué dans un second dossier.
`No module named 'maya'` ou `PySide6` introuvable	Exécuter le code dans Maya 2026.3, dans un onglet Python du Script Editor.
Le chemin affiché correspond à une ancienne copie	Fermer Maya, corriger le chemin de démarrage puis rouvrir Maya.
L’import fonctionnait avant de redémarrer	Le chemin temporaire n’a pas été conservé. Revoir `Maya.env` ou la configuration du lanceur studio.
Chroma s’ouvre déjà rattaché	Maya restaure son état mémorisé. Détacher la fenêtre et la placer comme souhaité.
Une erreur persiste	Conserver le message complet du Script Editor, la version de Maya, le chemin de weSkel s’il a pu être importé et l’action effectuée, pour les transmettre lors du signalement.

Après un changement de copie ou une mise à jour des fichiers weSkel, redémarrer Maya avant de reprendre les outils.

Choisir son affichage

Réglage du wiki	Comportement
Thème	Retrouver les noms du catalogue partagé avec les UI weSkel, comme Poseidon et Gaïa. Le choix du wiki est indépendant de celui de Maya.
Langue	Passer du français à l’anglais en restant sur le même guide.

Le navigateur mémorise ces préférences lorsque son stockage local est disponible. Les boutons de copie des blocs de code permettent de reprendre les exemples dans Maya.