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

# Installation

{% hint style="info" %}
Cette page est basée sur le build actuel du plugin : `HideSeek-Premium.jar`, version `1.0.0`.
{% endhint %}

### Prérequis

| Élément        |             Version cible | Obligatoire |
| -------------- | ------------------------: | :---------: |
| Serveur        |           Paper `1.21.11` |     Oui     |
| Java           |                      `21` |     Oui     |
| PlaceholderAPI | `2.12.2` côté compilation |     Non     |
| WorldEdit      |        Détection par hook |     Non     |

Le plugin utilise des API Paper, notamment le chat Adventure/Paper. Il doit donc être installé sur Paper, pas sur un serveur Spigot pur.

### Dépendances

| Plugin         | Rôle                                                                      | Comportement si absent                                 |
| -------------- | ------------------------------------------------------------------------- | ------------------------------------------------------ |
| PlaceholderAPI | Active les placeholders `%hideseek_*%`                                    | Les placeholders ne sont pas enregistrés               |
| WorldEdit      | Permet d'importer une sélection avec `/hs admin pos1` ou `/hs admin pos2` | Les positions sont prises depuis la position du joueur |

### Installation

1. Arrêtez le serveur.
2. Placez `HideSeek-Premium.jar` dans le dossier `plugins/`.
3. Installez PlaceholderAPI si vous voulez utiliser les placeholders.
4. Installez WorldEdit si vous voulez importer des sélections d'arène.
5. Redémarrez le serveur.

Au premier démarrage, le plugin génère ses fichiers dans :

```
plugins/HideSeek/
```

### Fichiers générés

| Fichier               | Rôle                                              |
| --------------------- | ------------------------------------------------- |
| `config.yml`          | Configuration globale, messages, arènes, gameplay |
| `maps.yml`            | Cartes HideSeek et positions sauvegardées         |
| `languages/fr_FR.yml` | Messages français surchargés                      |
| `languages/en_US.yml` | Messages anglais surchargés                       |

{% hint style="warning" %}
Les cartes sont stockées dans `maps.yml`. Ne supprimez pas ce fichier lors d'une mise à jour si vous voulez conserver vos cartes.
{% endhint %}

### Premier démarrage

Après installation :

1. Connectez-vous en opérateur.
2. Créez une carte avec les commandes admin.
3. Vérifiez la carte avec `/hs admin check <carte>`.
4. Sauvegardez avec `/hs admin save`.
5. Lancez une partie avec `/hs join <arène>` ou depuis `/hs menu`.

Une carte jouable doit avoir :

| Élément                   | Commande               |
| ------------------------- | ---------------------- |
| Lobby de carte            | `/hs admin set lobby`  |
| Spawn chercheur           | `/hs admin set seeker` |
| Au moins un spawn cacheur | `/hs admin add hider`  |
| Position 1 de zone        | `/hs admin set pos1`   |
| Position 2 de zone        | `/hs admin set pos2`   |

Le spawn spectateur existe dans le plugin, mais il n'est pas requis par la validation actuelle de la carte.

### Problèmes fréquents

| Problème                           | Cause probable                                                  | Solution                                                                    |
| ---------------------------------- | --------------------------------------------------------------- | --------------------------------------------------------------------------- |
| `Aucune arène n'est configurée`    | Aucune arène dans `config.yml`                                  | Créez une arène avec `/hs admin create <nom>`                               |
| `Carte introuvable`                | L'arène pointe vers une carte absente de `maps.yml`             | Vérifiez `maps.yml` et `/hs admin check <nom>`                              |
| Carte incomplète après redémarrage | Le monde de la carte n'est pas chargé ou des positions manquent | Chargez le monde puis refaites `/hs admin check <carte>`                    |
| Placeholder vide                   | PlaceholderAPI absent ou placeholder inexistant                 | Installez PlaceholderAPI et utilisez uniquement les placeholders documentés |
| WorldEdit ignoré                   | WorldEdit absent ou sélection invalide                          | Refaites une sélection WorldEdit ou utilisez les positions du joueur        |


---

# 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://docs.chrisgraph.fr/plugins/hideseek/installation.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.