> 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/03-fonctionnalites.md).

# 03 fonctionnalites

## 3.1 Outils personnalises

Chaque outil NovaTools possede les proprietes suivantes :

| Propriete          | Description                                    |
| ------------------ | ---------------------------------------------- |
| **ID**             | Identifiant unique (lettres, chiffres, \_)     |
| **Nom**            | Supporte les codes couleur `&` et `&#RRGGBB`   |
| **Type**           | PICKAXE, AXE, SHOVEL, HOE, SWORD, MULTI        |
| **Materiau**       | WOOD, STONE, GOLD, IRON, DIAMOND, NETHERITE    |
| **Rarete**         | Configurable (commune, rare, epique...)        |
| **Durabilite max** | Valeur personnalisee independante de Minecraft |
| **Reparable**      | Peut etre repare via la Forge                  |
| **Soulbound**      | Ne tombe pas au sol a la mort du joueur        |
| **Lore**           | Description affichee dans l'infobulle          |
| **Enchantements**  | Enchantements Minecraft standards              |
| **Pouvoirs**       | Capacites speciales (voir 3.3)                 |
| **ItemsAdder ID**  | Texture/modele custom via ItemsAdder           |

<figure><img src="/files/IDNM8vKRctgXZUHGGRO6" alt=""><figcaption><p>Un GUI d'edition d'outil (anoté)</p></figcaption></figure>

<figure><img src="/files/qJ7IpcEWP8QSIWTjiz1J" alt=""><figcaption><p>Liste des outils avec tri et filtres</p></figcaption></figure>

## 3.2 Raretés

Les raretés sont entierement configurables en jeu. Chaque rarete possede :

* Un **identifiant** unique (ex : `legendaire`)
* Un **code couleur** (`&a`, `&9`, `&#FFD700`, etc.)
* Un **ordre** modifiable par echange dans le GUI (Shift+Clic = selectionner, Clic sur une autre = echanger)

Les 5 raretés par defaut generees automatiquement :

| Rarete     | Couleur                   |
| ---------- | ------------------------- |
| commune    | `&a` (vert)               |
| rare       | `&9` (bleu)               |
| epique     | `&#8A2BE2` (violet)       |
| occulte    | `&#9400D3` (violet fonce) |
| legendaire | `&#FFD700` (or)           |

<figure><img src="/files/EVCEeZRPeaPoHasT9xsv" alt=""><figcaption><p>Liste des raretés</p></figcaption></figure>

<figure><img src="/files/4qq4RR9Oh8nFh8l2e6Yp" alt=""><figcaption><p>Edition d'une rarete</p></figcaption></figure>

## 3.3 Pouvoirs speciaux

Les pouvoirs se configurent par outil. Chaque pouvoir a ses propres options de chance, cout Vault, cooldown, son et particule.

### Pouvoirs disponibles

| Pouvoir                      | Type d'outil compatible | Description                                                    |
| ---------------------------- | ----------------------- | -------------------------------------------------------------- |
| **auto\_smelt**              | PICKAXE, MULTI          | Fond automatiquement les minerais extraits (fer, or, etc.)     |
| **till\_radius**             | HOE                     | Laboure un rayon autour du bloc cible (1 = 3x3, 2 = 5x5, etc.) |
| **harvest\_radius**          | HOE                     | Recolte toutes les cultures mures dans un rayon                |
| **replant**                  | HOE                     | Replante automatiquement apres une recolte                     |
| **replant\_from\_inventory** | HOE                     | Prend les graines dans l'inventaire du joueur pour replanter   |
| **tree\_feller**             | AXE                     | Abat tout l'arbre d'un seul coup (max 512 blocs)               |
| **instant\_kill**            | SWORD                   | Tue l'entite ciblee en un seul coup                            |

### Parametres avances par pouvoir

Chaque pouvoir supporte les suffixes suivants (remplacez `*` par le nom du pouvoir, ex : `auto_smelt_chance`) :

| Suffixe                         | Type                | Defaut | Description                                         |
| ------------------------------- | ------------------- | ------ | --------------------------------------------------- |
| `*_chance`                      | 0.0 - 1.0           | 1.0    | Probabilite de declenchement (1.0 = toujours)       |
| `*_cost`                        | nombre              | 0.0    | Cout en argent Vault par activation                 |
| `*_cooldown`                    | secondes            | 0      | Delai de recharge                                   |
| `*_sound`                       | nom Sound Bukkit    | varie  | Son joue lors de l'activation (vide = desactive)    |
| `*_particle`                    | nom Particle Bukkit | varie  | Particule lors de l'activation (vide = desactive)   |
| `durability_per_block`          | entier              | 1      | Durabilite consommee par bloc/action                |
| `tree_feller_cost_per_block`    | boolean             | false  | Cout par bloc abattu plutot que par activation      |
| `harvest_radius_cost_per_block` | boolean             | false  | Cout par culture recoltee plutot que par activation |

### Sons par defaut

| Pouvoir         | Son par defaut               |
| --------------- | ---------------------------- |
| auto\_smelt     | `BLOCK_FURNACE_FIRE_CRACKLE` |
| till\_radius    | `ITEM_HOE_TILL`              |
| harvest\_radius | `BLOCK_CROP_BREAK`           |
| replant         | *(aucun)*                    |
| tree\_feller    | `BLOCK_WOOD_BREAK`           |
| instant\_kill   | `ENTITY_PLAYER_ATTACK_CRIT`  |

### Particules par defaut

| Pouvoir         | Particule par defaut |
| --------------- | -------------------- |
| auto\_smelt     | `FLAME`              |
| till\_radius    | `BLOCK_DUST`         |
| harvest\_radius | `VILLAGER_HAPPY`     |
| replant         | *(aucune)*           |
| tree\_feller    | `SWEEP_ATTACK`       |
| instant\_kill   | `CRIT`               |

> **Image :** `images/tool-powers.png` - GUI des pouvoirs

## 3.4 Orbes de reparation

Les orbes sont des items qui permettent de reparer les outils NovaTools via la Forge.

| Propriete         | Description                              |
| ----------------- | ---------------------------------------- |
| **ID**            | Identifiant unique                       |
| **Nom**           | Supporte les codes couleur               |
| **Durabilite**    | Nombre de points de durabilite restaures |
| **Lore**          | Description de l'orbe                    |
| **ItemsAdder ID** | Texture custom optionnelle               |

> **Image :** `images/orb-list.png` - Liste des orbes

> **Image :** `images/orb-edit.png` - Edition d'un orbe

## 3.5 Coffrets (outils aleatoires)

Les coffrets sont des items qui, a l'utilisation, donnent un outil aleatoire parmi une liste pondérée.

| Propriete         | Description                                           |
| ----------------- | ----------------------------------------------------- |
| **ID**            | Identifiant unique                                    |
| **Nom**           | Supporte les codes couleur                            |
| **Lore**          | Description du coffret                                |
| **Outils**        | Liste d'outils avec leur poids (probabilite relative) |
| **ItemsAdder ID** | Texture custom optionnelle                            |

Les poids sont relatifs : un outil avec poids 60 a deux fois plus de chances qu'un outil avec poids 30.

<figure><img src="/files/OMzvBSbfRIJWxgGrCb6K" alt=""><figcaption><p>Liste des coffrets</p></figcaption></figure>

<figure><img src="/files/O8mD5Levk10rsRweER2n" alt=""><figcaption><p>Édition d'un coffret</p></figcaption></figure>

## 3.6 Forge

La Forge permet de reparer un outil NovaTools en y inserant un orbe de reparation.

* Le joueur place son outil et son orbe dans le GUI
* Un apercu de l'outil repare est affiche
* Si l'orbe repare plus que necessaire, un **reste d'orbe** est rendu (ratio configurable)
* Les slots, le titre et les items du GUI sont entierement personnalisables
* Reparation par XP optionnelle (alternative aux orbes)

<figure><img src="/files/pw7PbOJiEP4z36iK0KUa" alt=""><figcaption><p>Interface de forge (vide)</p></figcaption></figure>

<figure><img src="/files/DUwiEfwZTOOgUg2mWAVw" alt=""><figcaption><p>Interface de forge en utillisation (rendement de reste = 50%)</p></figcaption></figure>

## 3.7 Recyclage

Le Recyclage permet de convertir un outil NovaTools use en orbe de reparation.

* Le joueur place son outil dans le GUI
* Un apercu de l'orbe obtenu est affiche
* L'orbe obtenu a une durabilite proportionnelle a l'etat de l'outil recycle
* Les slots et items du GUI sont personnalisables\ <br>

  <figure><img src="/files/bietQYkOjUd3T0R4Osde" alt=""><figcaption><p>Interface du recyclage (vide)</p></figcaption></figure>

  <figure><img src="/files/xBWtJ9nhpbDRaU5BZrJw" alt=""><figcaption><p>Interface recyclage en usage (pour un rendemen a 50%)</p></figcaption></figure>

## 3.8 Affichage de la durabilite

La durabilite courante s'affiche automatiquement selon le mode configure :

| Mode         | Description                      |
| ------------ | -------------------------------- |
| `NONE`       | Aucun affichage                  |
| `ACTION_BAR` | Barre d'action sous le hotbar    |
| `BOSS_BAR`   | Barre de boss en haut de l'ecran |

## 3.9 Statistiques

Si l'option est activee, le plugin enregistre les statistiques d'utilisation des outils (blocs mines, mobs tues, etc.) par joueur.

## 3.10 Interface d'administration

Toute la gestion se fait en jeu via `/tools config`, sans modification manuelle du fichier de configuration.

### Gestion des outils

* Liste paginee de tous les outils avec tri (A-Z, Z-A, par rarete, par type, par durabilite croissante ou decroissante)
* Filtre par rarete : accessible depuis la liste des raretés via un clic droit
* Creation d'un outil en choisissant d'abord son type (Pioche, Pelle, Hache, Houe, Epee, Multi-outil)
* Edition complete : nom, identifiant, materiau, durabilite max, rarete, reparable, soulbound, ID ItemsAdder
* **Lore editable ligne par ligne** : ajout, modification et suppression de chaque ligne
* **Enchantements editables** : clic gauche pour augmenter le niveau, clic droit pour le reduire, liste filtree selon le type d'outil
* **Pouvoirs editables individuellement** : activation, chance de declenchement, cooldown, cout Vault, son et particule - avec un selecteur de presets visuels pour les sons et particules
* Bouton pour se donner l'outil directement, ou le donner a un joueur en ligne
* Suppression avec fenetre de confirmation

### Gestion des raretés

* Liste de toutes les raretés avec le nombre d'outils associes
* Creation d'une nouvelle rarete (identifiant + code couleur saisis dans le chat)
* Modification de la couleur avec apercu en temps reel
* Echange d'ordre : Shift+clic pour selectionner une rarete, clic sur une autre pour echanger leurs positions
* Suppression avec confirmation

### Gestion des orbes

* Liste paginee de tous les orbes
* Edition : nom, identifiant, durabilite reparee, ID ItemsAdder, lore ligne par ligne
* Bouton pour se donner l'orbe ou le donner a un joueur en ligne
* Suppression avec confirmation

### Gestion des coffrets

* Liste paginee de tous les coffrets
* Edition : nom, identifiant, ID ItemsAdder, lore ligne par ligne, liste des outils avec leurs poids de probabilite
* Ajout et retrait d'outils dans un coffret, modification des poids via saisie dans le chat
* Bouton pour se donner le coffret ou le donner a un joueur en ligne
* Suppression avec confirmation

### Parametres

Activation/desactivation en un clic sans redemarrage : destruction de l'outil a zero durabilite, interface de parametres joueur, reparation par XP, particules, sons, statistiques, forge, recyclage, mode d'affichage de la durabilite (aucun / barre d'action / barre de boss).

<figure><img src="/files/g4SCqbddJAAUWU9rAuVm" alt=""><figcaption><p>Un GUI des paramètres généraux</p></figcaption></figure>


---

# 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/03-fonctionnalites.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.
