> 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/6.-commands.md).

# 6. commands

{% hint style="info" %}
**Noms configurables :** toutes les commandes et sous-commandes peuvent être renommées dans `config.yml` (sections `commands` et `subcommands`). Les noms affichés ici sont les valeurs par défaut. Un redémarrage est nécessaire pour appliquer les changements de noms.

Exception : les sous-commandes `about` et `help` sont toujours disponibles telles quelles, quel que soit le nom configuré.
{% endhint %}

## Commandes joueur

| Commande                       | Description                            | Permission              |
| ------------------------------ | -------------------------------------- | ----------------------- |
| `/shards`                      | Affiche la page d'aide du plugin       | `novashard.use`         |
| `/shards about`                | Affiche la page d'aide du plugin       | `novashard.use`         |
| `/shards help`                 | Affiche la page d'aide du plugin       | `novashard.use`         |
| `/shards balance`              | Affiche votre solde de shards          | `novashard.use`         |
| `/afk`                         | Passe en mode AFK                      | `novashard.use`         |
| `/quitafk`                     | Quitte le mode AFK                     | `novashard.use`         |
| `/transfer <joueur> <montant>` | Transfère des shards à un autre joueur | `novashard.transfer`    |
| `/store`                       | Ouvre la boutique de shards            | *(aucune)*              |
| `/leaderboard [page]`          | Affiche le classement des shards       | `novashard.leaderboard` |

## Commandes admin

| Commande                                    | Description                                 | Permission        |
| ------------------------------------------- | ------------------------------------------- | ----------------- |
| `/shards give <joueur> <montant>`           | Donne des shards à un joueur                | `novashard.admin` |
| `/shards remove <joueur> <montant>`         | Retire des shards à un joueur               | `novashard.admin` |
| `/shards set <joueur> <montant> [-s]`       | Redéfinit le solde exact d'un joueur        | `novashard.admin` |
| `/setafk`                                   | Définit le point AFK à votre position       | `novashard.admin` |
| `/afkremove`                                | Supprime le point AFK                       | `novashard.admin` |
| `/store add <slot> <prix>`                  | Ajoute l'item en main au slot indiqué       | `novashard.admin` |
| `/store remove <slot>`                      | Supprime l'item du slot indiqué             | `novashard.admin` |
| `/store edit <slot> <prix>`                 | Modifie le prix d'un item                   | `novashard.admin` |
| `/store editname <slot> <nom>`              | Modifie le nom d'affichage d'un item        | `novashard.admin` |
| `/store editlore <slot> <ligne1\|ligne2>`   | Modifie le lore d'un item (séparateur `\|`) | `novashard.admin` |
| `/novashard reload`                         | Recharge la configuration sans redémarrage  | `novashard.admin` |
| `/novashard configure [page\|clé] [valeur]` | Modifie la configuration en jeu             | `novashard.admin` |
| `/novashard help`                           | Affiche l'aide complète                     | *(aucune)*        |
| `/novashard about`                          | Affiche l'aide complète                     | *(aucune)*        |

## Commandes console

Les commandes suivantes peuvent être exécutées depuis la console du serveur :

| Commande                           | Description                            |
| ---------------------------------- | -------------------------------------- |
| `shards give <joueur> <montant>`   | Donne des shards à un joueur en ligne  |
| `shards remove <joueur> <montant>` | Retire des shards à un joueur en ligne |

> Le joueur doit être connecté pour que la commande console fonctionne.

## Détail des commandes

### `/shards`

```
/shards
/shards about
/shards help
/shards balance
/shards give <joueur> <montant>
/shards remove <joueur> <montant>
/shards set <joueur> <montant> [-s]
```

Sans argument (ou avec `about` / `help`) : affiche la page d'aide du plugin avec la version, la licence masquée, les liens utiles et la liste de toutes les commandes disponibles.

`balance` : affiche votre solde de shards.

`give` / `remove` : réservé aux admins et à la console — ajoute ou retire un montant au solde actuel.

`set` : réservé aux admins — **redéfinit** le solde à une valeur exacte (sans tenir compte du solde actuel). L'option `-s` (silent) empêche l'envoi du message de notification au joueur ciblé.

> La **tab completion** est disponible sur `/shards` : appuyez sur TAB pour afficher les sous-commandes disponibles, les joueurs en ligne et les autres commandes du plugin.

### `/afk` et `/quitafk`

```
/afk
/quitafk
```

`/afk` lance un compte à rebours (configurable dans `config.yml`), puis téléporte le joueur au point AFK.\
Le mode AFK doit être activé et un point AFK doit être défini par un admin.

Tout mouvement pendant le compte à rebours annule la téléportation.

### `/transfer`

```
/transfer <joueur> <montant>
```

Ouvre une interface de confirmation. Le transfert n'est effectué qu'après validation.\
Impossible de se transférer des shards à soi-même.

### `/store`

```
/store
/store add <slot> <prix>
/store remove <slot>
/store edit <slot> <prix>
/store editname <slot> <nom>
/store editlore <slot> <ligne1|ligne2|...>
```

Sans argument : ouvre la boutique.\
Les sous-commandes de gestion nécessitent `novashard.admin`.

### `/setafk` et `/afkremove`

```
/setafk
/afkremove
```

`/setafk` enregistre votre position actuelle comme point de téléportation AFK.

> Conseil : définissez ce point dans un monde dédié (ex. avec MultiVerse-Core) pour de meilleures performances.

### `/leaderboard`

```
/leaderboard
/leaderboard <page>
```

Affiche le classement paginé. Sans numéro de page, affiche la page 1.

### `/novashard`

```
/novashard
/novashard help
/novashard about
/novashard reload
/novashard configure [page|clé] [valeur]
```

Sans argument, `help` ou `about` : affiche la même page d'aide que `/shards`.

`reload` : recharge `config.yml` et `messages.yml` à chaud. Si le backend de stockage a changé, la reconnexion est effectuée automatiquement.

`configure` : modifie la configuration du plugin directement en jeu.

| Usage                                            | Effet                                         |
| ------------------------------------------------ | --------------------------------------------- |
| `/novashard configure`                           | Affiche la page 1 des paramètres (8 par page) |
| `/novashard configure 2`                         | Affiche la page 2                             |
| `/novashard configure earning.playtime.amount`   | Affiche la valeur actuelle de ce paramètre    |
| `/novashard configure earning.playtime.amount 5` | Définit la valeur à `5` et sauvegarde         |

Les modifications sont écrites dans `config.yml` immédiatement. La **tab completion** suggère les clés disponibles et les valeurs possibles (`true`/`false` pour les booléens, valeur actuelle pour les nombres).

> Les noms de commandes et sous-commandes modifiés dans `config.yml` nécessitent un redémarrage complet - ils ne sont **pas** rechargés par `reload` ni par `configure`.

> La **tab completion** est disponible sur `/novashard` : TAB affiche les sous-commandes ainsi que toutes les autres commandes du plugin.


---

# 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/6.-commands.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.