> 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/08-integrations.md).

# 08 integrations

## 8.1 [Vault](https://www.spigotmc.org/resources/vault.34315/)

**Statut :** Obligatoire

Vault est utilise pour les **couts monetaires des pouvoirs**. Lorsqu'un pouvoir a un cout configure, NovaTools debite le compte du joueur a chaque activation. Si le joueur n'a pas les fonds, le pouvoir ne se declenche pas.

### Configuration

Dans chaque outil, dans la section `powers` :

```yaml
powers:
  auto_smelt: true
  auto_smelt_cost: 10.0               # 10 coins debites a chaque fonte

  tree_feller: true
  tree_feller_cost: 5.0               # 5 coins par activation
  tree_feller_cost_per_block: true    # ou : 5 coins par bloc abattu

  harvest_radius: 2
  harvest_radius_cost: 2.0
  harvest_radius_cost_per_block: true # 2 coins par culture recoltee
```

Un cout a `0.0` signifie que le pouvoir est gratuit.

### Comportement si Vault est absent

Si Vault n'est pas detecte au demarrage, les couts sont ignores et tous les pouvoirs fonctionnent gratuitement. Aucune erreur n'est generee.

***

## 8.2 [ItemsAdder](https://www.spigotmc.org/resources/%E2%9C%A8itemsadder%E2%AD%90emotes-mobs-items-armors-hud-gui-emojis-blocks-wings-hats-liquids.73355/)

**Statut :** Optionnel

ItemsAdder permet d'assigner des **textures et modeles 3D personnalises** aux outils, orbes et coffrets NovaTools, ainsi qu'aux elements du GUI de la Forge et du Recyclage.

### Configuration du namespace

```yaml
itemsadder:
  namespace: "novatools"    # Doit correspondre au namespace de votre pack ItemsAdder
```

### Assigner une texture a un outil

```yaml
tools:
  pioche_elite:
    itemsadder_id: "novatools:pioche_elite"    # namespace:id
```

### Assigner une texture a un orbe

```yaml
orbs:
  orbe_commun:
    itemsadder_id: "novatools:orbe_commun"
```

### Assigner une texture a un coffret

```yaml
random_tools:
  coffret_bronze:
    itemsadder_id: "novatools:coffret_bronze"
```

### Personnaliser les GUIs Forge et Recyclage

```yaml
forge:
  gui:
    background_item: "novatools:fond_forge"      # Item de fond du GUI
    button_repair: "novatools:bouton_reparer"     # Bouton actif
    button_disabled: "novatools:bouton_inactif"   # Bouton inactif (outil/orbe manquant)

recycle:
  gui:
    background_item: "novatools:fond_recycle"
    button_recycle: "novatools:bouton_recycler"
    button_disabled: "novatools:bouton_inactif"
```

### Comportement si ItemsAdder est absent

Si ItemsAdder n'est pas detecte, ou si l'`itemsadder_id` ne correspond a aucun item connu, NovaTools utilise automatiquement l'item Minecraft vanilla correspondant (ex : `PRISMARINE_CRYSTALS` pour les orbes, `CHEST` pour les coffrets).

***

## 8.3 [ProtocolLib](https://www.spigotmc.org/resources/protocollib.1997/)

**Statut :** Obligatoire

ProtocolLib est utilise en interne par NovaTools pour certaines fonctionnalites avancees de gestion des packets reseau. Il n'y a aucune configuration specifique a faire.

Assurez-vous simplement qu'il est present dans le dossier `plugins/` avant de demarrer le serveur.


---

# 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/08-integrations.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.