> 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/1.-getting-started.md).

# 1. getting started

Bienvenue sur **NovaShard** ! Ce guide vous permet d'être opérationnel en moins de 5 minutes.

{% stepper %}
{% step %}

### Prérequis

Avant d'installer le plugin, vérifiez que votre environnement est compatible :

* Serveur **Spigot** ou **Paper** en version **1.17 ou supérieure**
* Java **17** minimum
* Une clé de licence valide obtenue sur le [Discord de support](https://discord.gg/HtjPAfqUXu)

> **Dépendances optionnelles :**
>
> * [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) - pour utiliser les placeholders dans vos scoreboards, holograms, etc.
> * [WorldGuard](https://dev.bukkit.org/projects/worldguard) - pour activer les gains de shards par région
>   {% endstep %}

{% step %}

### Installation

1. Téléchargez le fichier `NovaShard-2026.05.13 (1.0.1 #3).jar`
2. Placez-le dans le dossier `plugins/` de votre serveur
3. Démarrez le serveur une première fois - les fichiers de configuration sont générés automatiquement
4. **Arrêtez le serveur** avant de continuer
   {% endstep %}

{% step %}

### Clé de licence

Ouvrez `plugins/NovaShard/config.yml` et renseignez votre clé :

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

> Sans clé valide, le plugin se désactive automatiquement au démarrage. En cas de problème : [Discord support](https://discord.gg/HtjPAfqUXu) → ticket `#support`
> {% endstep %}

{% step %}

### Démarrage

Relancez le serveur. Dans la console, vous devriez voir :

```
[NovaShard] ✓ Licence validée
[NovaShard] NovaShard v2026.05.13 (1.0.1 #3) activé.
```

{% endstep %}

{% step %}

### Vérification rapide

Connectez-vous au serveur et tapez `/shards balance` - vous devriez voir votre solde (0 au départ).

> Tapez `/shards` sans argument pour afficher la page d'aide complète du plugin.

### Prochaines étapes

| Sujet                                     | Fichier                                          |
| ----------------------------------------- | ------------------------------------------------ |
| Configurer les gains, la boutique, l'AFK… | \[5. configuration.md]\(5. configuration.md)     |
| Liste complète des commandes              | \[6. commands.md]\(6. commands.md)               |
| Utiliser les placeholders                 | \[8. placeholderapi.md]\(8. placeholderapi.md)   |
| Quelque chose ne fonctionne pas           | \[9. troubleshooting.md]\(9. troubleshooting.md) |
| Historique des versions                   | \[11. changelog.md]\(11. changelog.md)           |
| {% endstep %}                             |                                                  |
| {% endstepper %}                          |                                                  |


---

# 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/1.-getting-started.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.