feat: Initial commit

src/content/docs/blender/import/nmg.mdx

@@ -0,0 +1,86 @@
+---
+title: Import NMG (Géométrie)
+description: Importer un fichier de géométrie NMG dans Blender.
+---
+
+import { Aside } from '@astrojs/starlight/components';
+
+Le format **NMG** (Native Model Geometry) contient les données de géométrie d'un modèle 3D : vertices, normales, UV maps, indices de faces et références aux matériaux. C'est le format de base pour importer un mesh isolé depuis GS Framework.
+
+**Menu** : File → Import → **NMG Geometry (.nmg)**
+
+{/* ![Boîte de dialogue d'import NMG](../../../assets/placeholder-import-nmg-dialog.png) */}
+
+---
+
+## Options d'import
+
+| Option | Par défaut | Description |
+|---|---|---|
+| **Project Folder** | (préférences) | Dossier racine du projet, utilisé pour résoudre les chemins des matériaux et textures. Si laissé vide, la valeur des préférences est utilisée. |
+| **Scale** | `1.0` | Facteur d'échelle appliqué à la géométrie importée. Plage : 0.001 à 1000. |
+| **Flip X** | ✅ Activé | Inverse l'axe X. Le moteur GS Framework utilise un axe X inversé par rapport à Blender. |
+| **Swap YZ** | ✅ Activé | Échange les axes Y et Z. GS Framework utilise un système Y-up, Blender utilise Z-up. |
+| **Import Materials** | ✅ Activé | Importe automatiquement les matériaux (.nmm) référencés par la géométrie. |
+
+---
+
+## Détail des options
+
+### Scale
+
+Le facteur d'échelle multiplie toutes les coordonnées de la géométrie. Utilisez-le si votre scène GS Framework est dans une échelle très différente de celle de Blender.
+
+<Aside type="tip">
+En règle générale, laissez l'échelle à `1.0`. Modifiez-la uniquement si les objets importés apparaissent démesurément grands ou petits.
+</Aside>
+
+### Flip X et Swap YZ
+
+Ces deux options gèrent la conversion du système de coordonnées entre GS Framework et Blender :
+
+- **GS Framework** : Y vers le haut, X inversé
+- **Blender** : Z vers le haut
+
+**Gardez les deux options activées** dans la grande majorité des cas. Ne les désactivez que si vous travaillez volontairement dans le système de coordonnées natif de GS Framework (rare).
+
+### Import Materials
+
+Quand cette option est activée, l'addon :
+
+1. Lit les références de matériaux contenues dans le fichier NMG
+2. Recherche les fichiers `.nmm` correspondants dans le dossier projet
+3. Importe chaque matériau (textures, paramètres shader, couleurs)
+4. Assigne les matériaux aux faces correspondantes du mesh
+
+Si l'option est désactivée, le mesh est importé sans matériaux — vous pouvez les ajouter manuellement plus tard.
+
+<Aside type="caution">
+Si les matériaux ne sont pas trouvés, vérifiez que le **Project Folder** est correctement configuré. Activez le [Verbose Logging](/getting-started/configuration/) pour voir les chemins de recherche tentés.
+</Aside>
+
+---
+
+## Ce qui est importé
+
+Un fichier NMG produit dans Blender :
+
+- Un **objet mesh** avec la géométrie complète (vertices, faces, normales)
+- Les **UV maps** du modèle (autant de layers UV que le fichier en contient)
+- Les **matériaux** assignés (si l'option est activée)
+- Des **propriétés custom** sur l'objet :
+  - `asset_type` : "NMG"
+  - `asset_file` : chemin du fichier source
+  - `nmg_vertices` : nombre de vertices
+  - `nmg_polygons` : nombre de polygones
+  - `nmg_uv_channels` : nombre de layers UV
+  - `nmg_has_normals` : présence de normales
+  - `nmg_materials` : liste JSON des chemins de matériaux référencés
+
+---
+
+## Cas d'usage
+
+- **Vérifier un modèle** : importer un NMG seul pour inspecter la géométrie d'un asset
+- **Remplacer un mesh** : importer la géométrie pour la modifier, puis réexporter
+- **Assemblage manuel** : importer plusieurs NMG individuellement pour construire une scène à la main