> For the complete documentation index, see [llms.txt](https://hider.somadocs.fr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hider.somadocs.fr/configuration.md).

# Configuration

Au premier démarrage, SomaHider écrit cinq fichiers dans `plugins/SomaHider/`. Modifiez-les puis lancez `/sh reload` pour appliquer les changements.

### Les fichiers

| Fichier         | Contenu                                                                    |
| --------------- | -------------------------------------------------------------------------- |
| `config.yml`    | Réglages principaux : apparence du déguisement, thème des messages, alias. |
| `usernames.yml` | La liste des faux pseudos.                                                 |
| `skins.yml`     | Les skins qu'un déguisement peut porter.                                   |
| `chat.yml`      | Les messages du chat où le nom est à masquer.                              |
| `nbts.yml`      | Les NBT à conserver quand les NBT sont masqués.                            |

### config.yml

```yaml
persist_identity: true

disguise:
  show_name: false
  prefix: "§7Masqué "
  show_cape: false
  show_health: true
  random_heart_color: false
  show_armor: true
  show_nbts: true
  show_fire: true
  show_stuck_arrows: true
```

#### Le bloc disguise

| Clé                  | Défaut        | Effet                                                                                                  |
| -------------------- | ------------- | ------------------------------------------------------------------------------------------------------ |
| `show_name`          | false         | Affiche ou non, au-dessus de la tête, un pseudo tiré de `usernames.yml`.                               |
| `prefix`             | `"§7Masqué "` | Texte affiché devant le nom.                                                                           |
| `show_cape`          | false         | Afficher la cape du joueur.                                                                            |
| `show_health`        | true          | Afficher la vie.                                                                                       |
| `random_heart_color` | false         | Couleur aléatoire pour le cœur de l'indicateur de vie de chaque joueur masqué.                         |
| `show_armor`         | true          | Afficher l'armure portée.                                                                              |
| `show_nbts`          | true          | Afficher les données NBT des objets. Les tags de `nbts.yml` sont conservés même quand c'est désactivé. |
| `show_fire`          | true          | Afficher le feu quand un joueur brûle.                                                                 |
| `show_stuck_arrows`  | true          | Afficher les flèches plantées dans le joueur.                                                          |

`persist_identity` conserve l'identité masquée des joueurs, même s'ils sortent et reviennent dans la zone.

### Ajouter un skin

Les skins vivent dans `skins.yml`, chacun avec un `value` et une `signature`.

{% stepper %}
{% step %}

#### Générez le skin

Sur [mineskin.org](https://mineskin.org), envoyez votre image de skin.
{% endstep %}

{% step %}

#### Copiez les deux champs

Récupérez `value` et `signature` renvoyés par le site.
{% endstep %}

{% step %}

#### Ajoutez l'entrée

Dans `skins.yml`, ajoutez une entrée sous une clé unique, puis lancez `/sh reload`.
{% endstep %}
{% endstepper %}

```yaml
skins:
  skin1:
    value: "..."
    signature: "..."
```

Un joueur masqué porte au hasard l'un des skins de cette liste.

### Les autres fichiers

* **usernames.yml** : la liste des pseudos. Un joueur masqué en reçoit un au hasard. Prévoyez-en assez pour éviter les répétitions dans un gros combat.
* **chat.yml** : `replacement` est le texte qui remplace un nom masqué. `blacklist` liste les messages système où un nom peut apparaître ; SomaHider y remplace le nom. `{player}` marque le nom, `*` accepte n'importe quel texte.
* **nbts.yml** : les tags NBT conservés quand une zone masque les NBT. Pratique pour des objets personnalisés qui en dépendent. Clés et valeurs acceptent `*` et `prefix*`.


---

# 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, and the optional `goal` query parameter:

```
GET https://hider.somadocs.fr/configuration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.