> 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/4.-installation.md).

# 4. installation

## Prérequis

| Élément           | Requis             |
| ----------------- | ------------------ |
| Serveur           | Spigot ou Paper    |
| Version Minecraft | 1.17 ou supérieure |
| Java              | 17 minimum         |
| PlaceholderAPI    | Optionnel          |
| WorldGuard        | Optionnel          |

## Téléchargement

Obtenez le fichier JAR sur le [Discord NovaDev](https://discord.gg/HtjPAfqUXu).

{% hint style="warning" %}
Le plugin est signé numériquement. Toute version non officielle sera rejetée au démarrage.
{% endhint %}

## Installation

{% stepper %}
{% step %}

### Copiez le fichier JAR

Copiez `NovaShard-2026.05.13 (1.0.0 #4).jar` dans le dossier `plugins/` de votre serveur.
{% endstep %}

{% step %}

### Démarrez le serveur

Les fichiers de configuration sont générés automatiquement :

```
plugins/
└── NovaShard/
    ├── config.yml
    ├── messages.yml
    └── storage/
        └── novashard.db   ← créé si SQLite est utilisé
```

{% endstep %}

{% step %}

### Arrêtez le serveur

{% endstep %}
{% endstepper %}

## Clé de licence

Ouvrez `plugins/NovaShard/config.yml` et remplacez la valeur par défaut :

```yaml
license:
  key: "VOTRE-CLE-LICENCE-ICI"
```

Remplacez `VOTRE-CLE-LICENCE-ICI` par votre clé obtenue sur le Discord.

{% hint style="info" %}
La licence est vérifiée au démarrage puis toutes les 6 heures automatiquement.\
Si la vérification échoue (clé invalide, serveur de licence injoignable), le plugin se désactive.
{% endhint %}

<details>

<summary>En cas de problème de licence</summary>

```
[NovaShard] ⚠ LICENCE NON VALIDÉE
[NovaShard] Le plugin ne peut pas démarrer.
[NovaShard] Rejoignez notre Discord et créez un ticket #support.
[NovaShard] Support : https://discord.gg/HtjPAfqUXu
```

Ouvrez un ticket `#support` sur le [Discord](https://discord.gg/HtjPAfqUXu) avec votre clé et l'IP de votre serveur.

</details>

## Dépendances optionnelles

### PlaceholderAPI

Si installé, NovaShard enregistre automatiquement ses placeholders au démarrage :

```
[NovaShard] PlaceholderAPI détecté - placeholders enregistrés.
```

Si absent :

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

### WorldGuard

Si installé, les gains par région deviennent disponibles (à activer dans `config.yml` sous `region-earning`).

## Premier démarrage

Relancez le serveur après avoir renseigné votre clé. La console doit afficher :

```
[NovaShard] ✓ Licence validée
[NovaShard] États AFK effacés au démarrage.
[NovaShard] NovaShard v2026.05.13 (1.0.0 #4) activé.
```

Connectez-vous et tapez `/shards balance` pour vérifier que le plugin répond correctement.


---

# 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/4.-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.