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

# Fonctionnement

Une zone hider agit sur une seule chose : ce que les autres joueurs voient de vous. Le reste du jeu ne change pas.

### Ce que voient les autres

À l'intérieur d'une zone, chaque joueur masqué prend une fausse identité.

* **Nom.** Avec `show_name: true`, un pseudo tiré de `usernames.yml` préfixé de `prefix` (par défaut `§7Masqué`). Avec `show_name: false`, le nom disparaît et seule la vie du joueur est visible. Si `show_health: false`, aucune information ne sera visible au dessus du joueur. 
* **Skin.** Un skin de `skins.yml`, à la place du vrai.
* **Équipement et effets.** Armure, cape, feu, flèches plantées et NBT des objets suivent votre configuration.

### Ce que voit le joueur masqué

Rien ne change pour lui. Il conserve son nom, son skin et son inventaire. Le déguisement n'est envoyé qu'aux autres.

### Ce qui ne change pas

Le déguisement est visuel. Déplacements, dégâts, portée et hitbox restent ceux du vrai joueur. Un coup porté sur un joueur masqué touche bien ce joueur.

### Le chat

Certains messages système révèlent un nom : une annonce de téléportation, un indicateur de distance. `chat.yml` liste ces messages, et SomaHider y remplace le nom masqué par le texte de `replacement`. Le détail est dans [Configuration](/configuration.md).

### Voir les vraies identités

Le staff peut lancer [`/sh bypass`](/commandes-et-permissions.md) pour voir tout le monde sans déguisement dans les zones. La bascule reste active après reconnexion, et demande la permission `soma.hider.bypass`.

### Identités persistantes

Avec `persist_identity: true`, un joueur garde le même pseudo et le même skin tant qu'une zone tourne, même s'il sort et revient.


---

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