> For the complete documentation index, see [llms.txt](https://wiki.novadev.ovh/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.novadev.ovh/novatolls/04-installation.md).

# 04 installation

## 4.1 Dependances

| Plugin          | Statut      | Utilisation                          |
| --------------- | ----------- | ------------------------------------ |
| **Vault**       | Obligatoire | Economie (couts des pouvoirs)        |
| **ProtocolLib** | Obligatoire | Gestion avancee des packets          |
| **ItemsAdder**  | Optionnel   | Textures et modeles 3D personnalises |

Telechargez [Vault](https://www.spigotmc.org/resources/vault.34315/) et [ProtocolLib](https://www.spigotmc.org/resources/vault.34315/download?version=344916) depuis [SpigotMC](https://www.spigotmc.org/) avant de continuer.\
[ItemsAdder](https://www.spigotmc.org/resources/%E2%9C%A8itemsadder%E2%AD%90emotes-mobs-items-armors-hud-gui-emojis-blocks-wings-hats-liquids.73355/) est optionnel, mais vous pouvez le retrouver aussi sur SpigotMC.

## 4.2 Placement des fichiers

```
votre-serveur/
  plugins/
    NovaTools-2026.05.16 (1.0.1 #19).jar   <- NovaTools
    Vault.jar                                <- obligatoire
    ProtocolLib.jar                          <- obligatoire
    ItemsAdder.jar                           <- optionnel
```

## 4.3 Premier demarrage

Demarrez le serveur. NovaTools genere automatiquement sa structure de fichiers :

```
plugins/NovaTools/
  config.yml       <- configuration principale (outils, orbes, coffrets, parametres)
  lang/
    fr.yml         <- messages du plugin
```

Le plugin charge ses valeurs par defaut et cree 5 raretes de base (commune, rare, epique, occulte, legendaire).

## 4.4 Cle de licence

Ouvrez `plugins/NovaTools/config.yml` et renseignez votre cle :

```yaml
license:
  key: "XXXX-XXXX-XXXX-XXXX"
```

Sauvegardez le fichier puis faites `/tools reload` (ou redemarrez le serveur).

La validation se fait en ligne au chargement. Le statut s'affiche dans :

* La console au demarrage
* La commande `/tools` (cle masquee partiellement)

## 4.5 Verification

Une fois installe correctement, la console doit afficher :

```
[NovaTools] Charge X outil(s), X coffret(s), X orbe(s).
[NovaTools] Licence validee.
```

Connectez-vous au serveur et tapez `/tools` pour voir le panneau d'informations du plugin.

## 4.6 Mise a jour

Pour mettre a jour NovaTools :

1. Arretez le serveur.
2. Remplacez l'ancien JAR par le nouveau dans `plugins/`.
3. Redemarrez le serveur.

> Le fichier `config.yml` est conserve entre les mises a jour. Les nouvelles options sont ajoutees avec leurs valeurs par defaut si elles sont absentes.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.novadev.ovh/novatolls/04-installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.