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

# Introduction

SomaHider change qui est qui à l'intérieur d'une zone. Quand un évenement commence, les joueurs choisissent souvent un nom et le focus. Dans une zone hider, tout le monde apparaît sous un pseudo et un skin aléatoires : il n'y a plus de nom à appeler. Vous choisissez qui reste reconnaissable : les coéquipiers, une équipe cible, ou toute personne autorisée par vos règles.

<figure><img src="/files/edG73ALEARRURj3wgOVH" alt="" width="563"><figcaption></figcaption></figure>

### Un masquage complet

À l'intérieur d'une zone, SomaHider remplace et fais tourner chaque repère que le jeu associe à un joueur : l'UUID, l'entity ID, le skin, le nom au-dessus de la tête, l'équipe, les marqueurs de scoreboard, les NBT présents sur ses équipements, son nom dans des messages stratégiques du chat, le ping, les métadonnées d'entité...

À l'œil nu, l'apparence reste cohérente : sur une cible donnée, tout le monde voit le même pseudo et le même skin. En revanche, les identifiants que le client lit en coulisses (UUID, entity id, marqueurs) diffèrent d'un observateur à l'autre, et sont régénérés fréquemment. Aucun client ne peut donc relier deux apparitions d'un même joueur, ni le suivre automatiquement. Il ne reste que le focus stratégique humain, à l'œil et à la déduction.

Le basculement est presque parfait. Il se produit en plein mouvement et conserve la position, l'orientation, la vélocité, l'équipement et jusqu'aux animations de coup en cours : un joueur peut changer de déguisement au beau milieu d'un combat sans que l'adversaire ne soit dérangé par le changement.

### Ce qu'une zone change

* Chaque joueur masqué reçoit un nom tiré de votre liste de pseudos, ou un marqueur neutre si vous désactivez les noms.
* Son skin est remplacé par l'un de ceux que vous avez configurés.
* La cape, l'armure, le feu, les flèches plantées et les NBT des objets peuvent être masqués.
* Dans les messages système qui révéleraient un nom masqué (téléportation, indicateur de distance), le nom est remplacé.
* La vie reste lisible sous le nom si vous le souhaitez.

{% hint style="info" %}
Pré-requis : un serveur Minecraft 1.8.8, Java 21 ou plus récent, et PacketEvents. Voir [Installation](/installation.md).
{% endhint %}

### Par où commencer

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Installation</strong></td><td>Pré-requis, étapes et test rapide.</td><td><a href="/pages/IZpIJy5ip3G7CjhgDQ7X">/pages/IZpIJy5ip3G7CjhgDQ7X</a></td></tr><tr><td><strong>Configuration</strong></td><td>Déguisement, skins, pseudos et chat.</td><td><a href="/pages/lZUglvQ7W7KRc2At0i88">/pages/lZUglvQ7W7KRc2At0i88</a></td></tr><tr><td><strong>API développeur</strong></td><td>Ouvrir des zones depuis votre plugin.</td><td><a href="/pages/kyn2Skl6t8BmwAmam6nQ">/pages/kyn2Skl6t8BmwAmam6nQ</a></td></tr></tbody></table>


---

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