---
title: Premier import
description: Importez votre premier fichier NMG dans Blender en quelques minutes.
---

import { Aside, Steps } from '@astrojs/starlight/components';

Ce guide vous accompagne dans l'import d'un fichier de géométrie NMG — le cas d'usage le plus simple pour se familiariser avec l'addon.

## Importer un fichier NMG

<Steps>

1. Assurez-vous que le [dossier projet est configuré](/blender/getting-started/configuration/) dans les préférences de l'addon.

2. Allez dans **File → Import → NMG Geometry (.nmg)**.

   {/* ![Menu Import NMG](../../../assets/placeholder-import-nmg-menu.png) */}

3. Naviguez jusqu'à votre fichier `.nmg` et sélectionnez-le.

4. Dans le panneau d'options à droite du navigateur de fichiers, vérifiez les réglages :
   - **Scale** : laissez à `1.0` sauf si votre scène utilise une échelle différente
   - **Flip X** et **Swap YZ** : laissez cochés (conversion du système de coordonnées GS Framework → Blender)
   - **Import Materials** : coché pour importer automatiquement les matériaux référencés

5. Cliquez sur **Import NMG**.

</Steps>

## Résultat

Après l'import, vous verrez dans votre scène Blender :

- Un (ou plusieurs) **objet mesh** correspondant à la géométrie du fichier NMG
- Les **matériaux** automatiquement créés et assignés (si l'option était activée)
- Des **propriétés custom** sur l'objet (visibles dans le panneau Properties → Object → Custom Properties) contenant les métadonnées d'origine

{/* ![Résultat d'un import NMG dans le viewport](../../../assets/placeholder-nmg-result.png) */}

<Aside type="tip">
Si les matériaux apparaissent noirs ou manquants, vérifiez que le **Dossier Projet** est correctement configuré dans les [préférences de l'addon](/blender/getting-started/configuration/). Activez le **Verbose Logging** pour voir les tentatives de résolution de chemins dans les logs.
</Aside>

## Comprendre les propriétés importées

Sélectionnez l'objet importé et ouvrez la sidebar (touche `N`). Vous y trouverez deux onglets utiles :

- Onglet **GS Object** : le **Nommage** (type + nom), le **Type d'Asset**, et — si le fichier source en contenait — les **propriétés physiques**.
- Onglet **GS Scene** : le panneau **Items Actifs**, qui indique si l'objet est actif dans la scène.

Pour en savoir plus sur chaque panneau, consultez la section Interface : [GS Scene](/blender/interface/export-tab/) et [GS Object](/blender/interface/gsedit-tab/).

## Et ensuite ?

- Pour importer un matériau seul : [Import NMM](/blender/import/nmm/)
- Pour importer une scène complète avec sous-scènes : [Import NMS Unpacked](/blender/import/nms-unpacked/)
- Pour comprendre le système de nommage : [Tutoriel Nommage](/blender/tutoriels/nommage/)
