> 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/09-depannage.md).
# 09 depannage
Le plugin ne charge pas
**Symptome :** Le plugin n'apparait pas dans `/plugins` ou est en rouge.
* Verifiez que Vault et ProtocolLib sont bien presents dans `plugins/`.
* Verifiez que vous utilisez Spigot ou Paper 1.16.5.
* Consultez la console au demarrage pour le message d'erreur precis.
Licence invalide / plugin bloque
**Symptome :** Message d'erreur de licence en console, plugin non fonctionnel.
* Verifiez que la cle dans `config.yml` est correcte (pas d'espace en debut/fin).
* Verifiez que votre serveur a acces a Internet (la validation se fait en ligne).
* Faites `/tools` pour voir le statut actuel de la licence.
* Contactez le support si la cle est correcte et le probleme persiste.
Les outils n'apparaissent pas dans le GUI
**Symptome :** Le GUI de gestion des outils est vide alors que `config.yml` en contient.
* Verifiez la syntaxe YAML de votre `config.yml` (un seul outil mal formate peut bloquer le chargement). Utilisez un validateur YAML en ligne.
* Consultez la console au demarrage - le plugin affiche le nombre d'outils charges. Si c'est 0, la section `tools:` est invalide.
* Faites `/tools reload` apres toute modification du fichier.
Un pouvoir ne se declenche pas
**Symptome :** L'outil est en main, le pouvoir est configure a `true` mais rien ne se passe.
* Verifiez que le pouvoir est compatible avec le type de l'outil (ex : `auto_smelt` ne fonctionne que sur PICKAXE et MULTI).
* Si un `*_cost` est configure, verifiez que le joueur a suffisamment d'argent Vault.
* Si un `*_cooldown` est configure, attendez que le delai soit ecoule.
* Verifiez que la durabilite de l'outil n'est pas a 0 (si `break_item_when_zero: false`, l'outil est bloque a 0 et les pouvoirs sont desactives).
* Verifiez que `settings.effects.particles` et `settings.effects.sounds` ne sont pas les seuls indicateurs que vous observez (ils sont optionnels, le pouvoir peut fonctionner sans effets visuels).
La Forge / le Recyclage ne s'ouvre pas
**Symptome :** La commande `/tools forge` ou `/tools recycle` ne fait rien.
* Verifiez `forge.enabled: true` / `recycle.enabled: true` dans `config.yml`.
* Verifiez que le joueur a la permission `novatools.forge` / `novatools.recycle`.
* Verifiez qu'aucun autre plugin ne bloque la commande.
Les textures ItemsAdder ne s'affichent pas
**Symptome :** L'item affiche le materiau vanilla au lieu de la texture custom.
* Verifiez que l'`itemsadder_id` correspond exactement a un item defini dans votre configuration ItemsAdder (`namespace:id`).
* Verifiez que le `namespace` dans `config.yml` correspond a celui de votre pack.
* Rechargez ItemsAdder apres modification (`/iazip` ou redemarrage).
* Verifiez que ItemsAdder est bien charge AVANT NovaTools (l'ordre de chargement peut varier).
Les enchantements ne s'appliquent pas
**Symptome :** L'outil ne possede pas les enchantements configures.
* Verifiez les noms des enchantements : ils doivent correspondre aux cles Bukkit 1.16.5.
* Correct : `efficiency`, `fortune`, `sharpness`, `unbreaking`
* Incorrect : `Efficiency`, `FORTUNE`, `tranchant`
* La console affiche un avertissement `Enchantement inconnu : X` pour chaque enchantement non reconnu.
**Liste des enchantements courants (cles Bukkit 1.16.5) :**
| Nom affiche | Cle Bukkit |
| --------------- | ------------- |
| Efficacite | `efficiency` |
| Solidite | `unbreaking` |
| Fortune | `fortune` |
| Toucher de soie | `silk_touch` |
| Tranchant | `sharpness` |
| Pillage | `looting` |
| Feu | `fire_aspect` |
Les commandes forge/recycle personnalisees ne fonctionnent pas
**Symptome :** La commande configuree dans `forge.commands` n'est pas reconnue.
* Les alias de commandes sont enregistres au demarrage du serveur uniquement. Un `/tools reload` ne suffit pas.
* Redemarrez completement le serveur apres avoir modifie `forge.commands` ou `recycle.commands`.
* Verifiez qu'aucun autre plugin n'utilise la meme commande.
L'ordre des raretés ne correspond pas
**Symptome :** L'ordre des raretés dans le GUI ne correspond pas a ce qui est dans `config.yml`.
* L'ordre est celui de la section `rarities:` dans `config.yml`. YAML preservele ordre d'insertion.
* Utilisez le GUI de gestion des raretés (`/tools config` > Raretés) pour echangerles positions directement en jeu - cela met a jour `config.yml` automatiquement.
Un outil perd sa durabilite trop vite / pas assez
* Verifiez `durability_per_block` dans la section `powers` de l'outil (defaut : 1 par action).
* Si l'outil a plusieurs pouvoirs actifs, chaque pouvoir consomme `durability_per_block` independamment.
## Contacter le support
Si vous ne trouvez pas la solution ici :
* **Discord :** lien disponible dans `/tools`
* **Documentation en ligne :**
---
# 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/09-depannage.md?ask=
```
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.