# Installation

Ce chapitre décrit la mise en place de MasterLadder sur votre serveur.

## 1. Fichiers

1. Téléchargez `MasterLadder-vX.Y.Z.zip`.
2. Décompressez le dossier `MasterLadder` dans votre dossier `resources/` (par exemple `resources/[mastermods]/MasterLadder`).

⚠️ Ne renommez pas les fichiers à l'intérieur du dossier.

## 2. server.cfg

```cfg
ensure ox_target          # si vous utilisez un target
ensure votre-vehicule-epan # la ressource qui stream le véhicule et les props
ensure MasterLadder
```

## 3. MasterKey

Créez votre clé gratuite sur [ressources.mastermods.dev/CreerMasterKey.php](https://ressources.mastermods.dev/CreerMasterKey.php), puis renseignez-la **à un seul de ces deux endroits** :

- dans `server.cfg` (recommandé, prioritaire) :
  ```cfg
  set mastermods_key "MM-XXXXXXXX"
  ```
- ou dans `config/config.lua` :
  ```lua
  Config.MasterModsKey = "MM-XXXXXXXX"
  ```

Au démarrage, la console serveur affiche `Licence MasterMods validée pour : <nom du serveur>`. La clé est revérifiée toutes les 30 minutes.

⚠️ Une même MasterKey peut servir sur **3 serveurs différents maximum par 24 h**. Au-delà, elle est bloquée 1 jour.

En cas de problème, voir [En cas d'erreur](en-cas-derreur).

## 4. Configuration

- `config/config.lua` : framework, permissions, interface, touches, vitesses, sons… voir [Configuration générale](configuration-generale).
- `config/ladders.lua` : vos véhicules à échelle (props, butées, extras, places)… voir [Configuration des échelles](configuration-des-echelles).

## 5. Administration (optionnel)

Pour autoriser vos administrateurs à utiliser `/mladmin` :

```cfg
add_ace group.admin command.mladmin allow
```

## Mise à jour

Remplacez tout le dossier **sauf** `config/config.lua` et `config/ladders.lua`, puis comparez-les avec ceux de la nouvelle version : les nouvelles options sont listées dans les [Journaux des changements](journaux-des-changements). Une option absente de votre config prend sa valeur par défaut.