# Plugin Blockbench — OakwoodRP Vêtement

Plugin officiel pour créer des vêtements compatibles avec le mod **vetementoak** d'OakwoodRP, directement dans Blockbench, avec un mannequin Steve de référence affiché au centre du viewport.

## Installation

1. Ouvre **Blockbench**
2. Menu **File → Plugins**
3. Onglet **Available** → bouton **Load Plugin from File** (icône dossier en bas)
4. Sélectionne `oakwoodrp_vetement.js` (le nom de fichier doit garder l'underscore — il correspond à l'ID interne du plugin)
5. Le plugin reste actif pour les prochains démarrages

## Utilisation

### 1. Créer un nouveau projet
- **File → New → Modded Entity**
- Texture **64×64**

### 2. Insérer le mannequin Steve
- Menu **Tools → Insérer mannequin Steve**
- Un groupe verrouillé `__steve_reference__` apparaît avec tête, corps, bras et jambes aux bonnes proportions et positions Minecraft
- Ce groupe est **automatiquement ignoré à l'export**

### 3. Modéliser ton vêtement
- Crée tes propres groupes / cubes par-dessus le mannequin
- Les coordonnées sont en **pixels MC** (Y vers le haut, tête à Y=24-32, etc.)

### 4. Choisir le bone d'attache
- Menu **Tools → Choisir bone d'attache**
- Sélectionne `HEAD`, `BODY`, `RIGHT_ARM`, `LEFT_ARM`, `RIGHT_LEG` ou `LEFT_LEG`
- À l'export, les coordonnées seront **automatiquement converties en relatives au pivot du bone choisi**, ce qui correspond à ce que le mod attend

### 5. Exporter
- Menu **File → Export → Exporter .bbs OakwoodRP**
- Sauvegarde le fichier `.bbs`
- Exporte aussi ta texture (`File → Export → Export Texture`) en `.png`

### 6. Soumettre
- Va sur https://oakwoodrp.fr/vetement/upload/
- Tape `/vetement uploadtoken` en jeu pour obtenir ton code
- Upload le `.bbs` + la texture `.png`

## Format de sortie

Le plugin génère le format attendu par `BBModelParser` :

```json
{
  "version": "1.0.0",
  "attach_part": "HEAD",
  "model": {
    "groups": {
      "Lunettes": {
        "origin": [0, 0, 0],
        "cubes": [
          {
            "from": [-4, 3, -5],
            "size": [8, 2, 1],
            "uvs": {
              "front": [0, 0, 8, 2],
              "back": [...],
              "right": [...],
              "left": [...],
              "top": [...],
              "bottom": [...]
            }
          }
        ]
      }
    }
  }
}
```

## Conseils

- N'utilise **que des cubes** (pas de meshes — ils seront ignorés par le mod)
- Évite les rotations sur les cubes individuels (le format `.bbs` ne les supporte pas)
- La texture doit être **64×64** (taille standard du skin player)
- Centre ton accessoire autour du **bone choisi** : si tu attaches à `HEAD`, place ton modèle à hauteur de la tête (Y ≈ 24-32) — le plugin recalculera tout en relatif à l'export