> 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/faq.md). # FAQ ### Comment créer une arène ? Utilisez le mode édition admin : ``` /hs admin create village /hs admin set lobby /hs admin set seeker /hs admin add hider /hs admin set pos1 /hs admin set pos2 /hs admin save ``` Le spawn spectateur peut être ajouté avec : ``` /hs admin set spectator ``` Il n'est pas requis par la validation actuelle. ### Puis-je utiliser WorldEdit pour sélectionner la zone ? Oui, si WorldEdit est installé. Faites une sélection WorldEdit, puis lancez : ``` /hs admin set pos1 ``` ou : ``` /hs admin set pos2 ``` Si la sélection est lisible, le plugin importe les deux coins. ### Pourquoi mon arène ne démarre pas ? Vérifiez : * la carte existe dans `maps.yml` ; * la carte est complète ; * la carte est activée ; * au moins deux joueurs non spectateurs sont dans l'arène ; * l'arène est en état `WAITING` ou `STARTING`. Commande utile : ``` /hs admin check ``` ### Pourquoi le plugin indique `Carte introuvable` ? Le code charge les cartes depuis `maps.yml`. Ca peut arriver si : * `maps.yml` a été supprimé ; * l'arène pointe vers une carte qui n'existe plus ; * le monde indiqué dans les positions n'est pas chargé ; * la carte a été renommée ou dupliquée manuellement de façon incomplète. Vérifiez aussi le lien dans `config.yml` : ```yaml arenas: village: map: village ``` ### Comment modifier une arène ? ``` /hs admin edit village ``` Modifiez ensuite les points nécessaires : ``` /hs admin set lobby /hs admin set seeker /hs admin add hider /hs admin set pos1 /hs admin set pos2 /hs admin save ``` ### Comment ajouter plusieurs arènes ? Créez plusieurs arènes avec des noms différents : ``` /hs admin create village /hs admin save /hs admin create mine /hs admin save ``` Le menu `/hs menu` liste les arènes configurées. ### Comment dupliquer une arène ? ``` /hs admin duplicate village village2 ``` Cette commande duplique la carte et crée une nouvelle arène liée à la copie. ### Comment renommer une arène ? ``` /hs admin rename village bourg ``` Le code actuel renomme en dupliquant la carte vers le nouveau nom, puis en supprimant l'ancienne. ### Comment forcer le démarrage d'une partie ? Compte à rebours de 5 secondes : ``` /hs admin start village ``` Démarrage immédiat : ``` /hs admin start village now ``` Il faut au moins deux joueurs non spectateurs et l'arène doit être en attente ou en démarrage. ### Comment arrêter une partie ? ``` /hs admin stop village ``` L'arène est arrêtée et réinitialisée si elle n'est pas déjà en attente ou en reset. ### Les joueurs peuvent-ils rejoindre une partie en cours ? Oui, en spectateur. Commande : ``` /hs spectate ``` Depuis `/hs menu`, un clic sur une arène déjà lancée tente aussi de rejoindre en spectateur. ### Pourquoi un cacheur ne peut pas choisir certains blocs ? Le déguisement refuse les blocs invisibles, techniques, traversables ou blacklistés. Exemples refusés par les règles actuelles : * `BARRIER` ; * `LIGHT` ; * fleurs ; * herbes ; * pots de fleurs ; * torches ; * rails ; * pancartes ; * tapis ; * boutons ; * plaques de pression. Les bougies sont acceptées par une règle spéciale. ### Comment fonctionne le déguisement en bloc ? Un cacheur choisit un bloc avec un clic droit sur un bloc autorisé. Le plugin : * cache le joueur ; * réduit sa taille ; * le rend non-collidable ; * affiche un `BlockDisplay` ; * met à jour ce display très fréquemment ; * place un vrai bloc temporaire si le joueur s'accroupit et que l'emplacement est libre. Si le joueur bouge après verrouillage, le vrai bloc est retiré. ### Pourquoi le chercheur perd de la vie ? Le système d'erreurs est activé par défaut : ```yaml hunters: mistakes: enabled: true chances: 20 penalty-hearts: 1.0 ``` Quand un chercheur frappe un mauvais bloc, il perd le nombre de coeurs configuré. S'il se trompe alors qu'il ne lui reste plus assez de vie, la partie se termine et les cacheurs gagnent. Le chercheur ne meurt pas. ### Les statistiques fonctionnent-elles ? Non. Les commandes existent : ``` /hs stats /hs top ``` Mais le code actuel affiche uniquement un message d'indisponibilité. Aucune base de données de statistiques n'est générée. ### Les placeholders de statistiques fonctionnent-ils ? Ils existent, mais retournent des valeurs fixes : | Placeholder | Valeur actuelle | | ------------------- | --------------- | | `%hideseek_wins%` | `0` | | `%hideseek_losses%` | `0` | | `%hideseek_ratio%` | `0.00` | ### Comment mettre le plugin à jour sans perdre mes cartes ? 1. Arrêtez le serveur. 2. Sauvegardez le dossier `plugins/HideSeek/`. 3. Remplacez uniquement le `.jar`. 4. Redémarrez le serveur. 5. Vérifiez les cartes avec `/hs admin list` et `/hs admin check `. Ne supprimez pas `maps.yml` si vous voulez conserver les cartes. --- # 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/faq.md?ask=&goal= ``` `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.