---
title: Installation
description: Installer et activer l'addon BlenderEdit dans Blender.
---

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

## Prérequis

- **Blender 3.0** ou supérieur
- Les fichiers source du projet GS Framework (dossier contenant vos `.nms`, `.nmg`, `.nmm`)

<Aside type="tip">
L'addon fonctionne avec toutes les versions de Blender à partir de la 3.0. Nous recommandons d'utiliser la dernière version LTS pour une stabilité maximale.
</Aside>

## Installer l'addon

<Steps>

1. **Téléchargez** le fichier `.zip` de l'addon BlenderEdit (fourni par votre équipe).

2. **Ouvrez Blender** et allez dans **Edit → Preferences** (ou `Ctrl+,`).

3. Dans la section **Add-ons**, cliquez sur le bouton **Install…** en haut à droite.

   {/* ![Bouton Install dans les préférences Blender](../../../assets/placeholder-install-button.png) */}

4. **Sélectionnez** le fichier `.zip` téléchargé et confirmez.

5. **Activez** l'addon en cochant la case à côté de son nom : **Blender-GS - NMS/NMG/NMM Importer from GameStart Editor**.

   {/* ![Activation de l'addon dans les préférences](../../../assets/placeholder-addon-activate.png) */}

</Steps>

## Vérifier l'installation

Une fois l'addon activé, vous devriez voir :

- De nouveaux menus dans **File → Import** :
  - NMS Scene (.nms)
  - NMG Geometry (.nmg)
  - NMM Material (.nmm)
- Un menu dans **File → Export** :
  - Composite Scene (.gltf + .scene.json)
- Trois nouveaux onglets dans la sidebar du **viewport 3D** (touche `N`) :
  - **GS Scene** — outils qui agissent sur toute la scène (export, props, textures, intégrité…)
  - **GS Object** — propriétés de l'objet sélectionné (nommage, physique, tracks, LOD…)
  - **GS Animation** — animations scriptées Squirrel
- Un onglet **GS Material** dans la sidebar de l'**éditeur de shaders** (Shader Editor)

![Menu File → Import avec les entrées NMS, NMG et NMM](../../../../assets/import-menu.png)

<Aside>
Si vous ne voyez pas la sidebar, appuyez sur `N` dans le viewport 3D pour la faire apparaître, puis cherchez les onglets **GS Scene**, **GS Object** et **GS Animation**. L'onglet **GS Material**, lui, n'apparaît que dans le Shader Editor.
</Aside>

<Aside type="note">
L'entrée **NMS Scene (.nms)** importe la scène en mode « unpacked » (un fichier `.blend` par sous-scène) — c'est le seul mode d'import de scène. Voir [Import NMS Unpacked](/blender/import/nms-unpacked/).
</Aside>

## Étape suivante

Avant de commencer à importer, il est important de [configurer les préférences de l'addon](/blender/getting-started/configuration/).
