> 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/novashard/9.-troubleshooting.md).

# 9. troubleshooting

## Le plugin ne démarre pas - licence non validée

**Message en console :**

```
[NovaShard] ⚠ LICENCE NON VALIDÉE
[NovaShard] Le plugin ne peut pas démarrer.
```

**Causes possibles :**

* La clé de licence dans `config.yml` est incorrecte ou absente
* La clé a expiré ou a été révoquée

**Solution :**

1. Vérifiez que `license.key` dans `config.yml` contient bien votre clé
2. Si le problème persiste, ouvrez un ticket `#support` sur le [Discord](https://discord.gg/HtjPAfqUXu)

***

## Le plugin ne démarre pas - fichier non autorisé

**Message en console :**

```
[NovaShard] ✖ FICHIER NON AUTORISÉ DÉTECTÉ
[NovaShard] Ce fichier n'est pas une version officielle.
```

**Cause :** Le fichier JAR a été modifié ou n'est pas une version officielle.

**Solution :** Téléchargez à nouveau le plugin depuis le [Discord officiel](https://discord.gg/HtjPAfqUXu).

***

## Impossible de contacter le serveur de licence

**Message en console :**

```
[NovaShard] Impossible de contacter le serveur de validation.
```

**Causes possibles :**

* Votre serveur n'a pas accès à Internet
* Le serveur de licences est temporairement indisponible
* Un pare-feu bloque les connexions sortantes vers `licences.novadev.ovh`

**Solution :**

1. Vérifiez que votre machine a bien accès à Internet
2. Autorisez les connexions HTTPS sortantes vers `licences.novadev.ovh` (port 443)
3. Réessayez dans quelques minutes. Si le problème persiste, contactez le support

***

## PlaceholderAPI n'est pas détecté

**Message en console :**

```
[NovaShard] PlaceholderAPI introuvable. Placeholders indisponibles.
```

**Solution :**

1. Téléchargez [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) et placez-le dans `plugins/`
2. Redémarrez le serveur

***

## WorldGuard n'est pas détecté / les gains par région ne fonctionnent pas

**Vérifications :**

1. WorldGuard est installé et activé sur le serveur
2. `region-earning.enabled` est à `true` dans `config.yml`
3. Le nom de la région dans `config.yml` correspond **exactement** au nom de la région WorldGuard (respect de la casse)

***

## Les commandes ne répondent pas

**Vérifications :**

1. Le plugin est bien activé (`/plugins` - NovaShard doit apparaître en vert)
2. Le joueur possède la permission requise (voir \[7. permissions.md]\(7. permissions.md))
3. Pour les commandes admin : le joueur est op ou possède `novashard.admin`

***

## Les shards ne sont pas sauvegardés entre les redémarrages

**Causes possibles :**

* Crash du serveur (les données ne sont sauvegardées qu'à la déconnexion)
* Fichier SQLite corrompu

**Solution :**

1. Évitez les arrêts brutaux - utilisez toujours `/stop`
2. Vérifiez que le fichier `plugins/NovaShard/storage/novashard.db` existe et n'est pas vide
3. Si vous utilisez MySQL, vérifiez que la connexion est stable

***

## Erreur SQL au démarrage

**Message en console :**

```
[NovaShard] Impossible d'effacer les états AFK : ...
```

**Solution :**

1. Vérifiez les paramètres MySQL dans `config.yml` si vous utilisez MySQL
2. Vérifiez que l'utilisateur MySQL a les droits sur la base de données
3. Pour SQLite, vérifiez que le dossier `plugins/NovaShard/storage/` existe et est accessible en écriture

***

## Le mode AFK ne fonctionne pas

**Vérifications :**

1. `earning.afk.enabled` est à `true` dans `config.yml`
2. Un point AFK a été défini par un admin avec `/setafk`
3. Le point AFK n'est pas dans le Nether ou l'End
4. Le joueur possède la permission `novashard.use`

***

## Le rechargement ne prend pas effet

`/novashard reload` recharge `config.yml` et `messages.yml`.

Certains paramètres nécessitent un redémarrage complet du serveur :

* Changement du backend de stockage (`sqlite` ↔ `mysql`)
* Renommage de commandes (`commands.*`) ou de sous-commandes (`subcommands.*`)

***

## Les commandes ne répondent pas après un renommage

Les noms de commandes et sous-commandes sont enregistrés **au démarrage** du serveur.\
`/novashard reload` ne les met pas à jour - un redémarrage complet est obligatoire.

***

## Support

Si aucune solution ci-dessus ne résout votre problème :

* **Discord :** [discord.gg/HtjPAfqUXu](https://discord.gg/HtjPAfqUXu) → ticket `#support`
* **Email :** <novadev.privacy@gmail.com>

Précisez dans votre ticket : la version du plugin, la version de Spigot/Paper, et les messages d'erreur complets depuis la console.


---

# 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/novashard/9.-troubleshooting.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.