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

# 📑 FR / Wiki Officiel : HytJump 🏃‍♂️💨

### 🌟 Introduction

HytJump est conçu pour offrir une expérience de Parkour unique. Au lieu de sauter sur des blocs statiques, le chemin se génère en temps réel devant vous. Chaque tentative est un nouveau défi !

### 🛠️ Installation Rapide

1. 📥 Téléchargez le fichier `HytJump.jar`.
2. 📂 Placez-le dans votre dossier `/plugins/`.
3. 🔄 Redémarrez votre serveur.
4. 🌍 Les dossiers `languages/` et les fichiers de config seront créés automatiquement.

### 📍 Configuration du Parcours (Admin)

Pour que le plugin fonctionne, vous devez définir deux points essentiels :

1. L'Arrivée (End) : Allez à l'endroit où le parcours doit se terminer et tapez :

   👉 `/hytjump end` *(C'est la première étape obligatoire).*
2. Le Départ (Start) : Allez à votre point de départ et tapez :

   👉 `/hytjump start`

   *Note : Le plugin calculera automatiquement la direction vers l'arrivée.*
3. Le Coffre (Rewards) : Regardez un coffre ou un tonneau et tapez :

   👉 `/hytjump reward set`

   *Pour le retirer : `/hytjump reward unset`.*

### 🎮 Comment Jouer ?

* Démarrage : Marchez sur la plaque de pression de départ.
* Le saut : Un bloc apparaît. Sautez dessus pour faire apparaître le suivant. Le bloc précédent disparaît derrière vous.
* La chute : Si vous tombez, vous êtes téléporté derrière la plaque de départ pour retenter votre chance.
* Victoire : Atteignez la plaque de fin pour enregistrer votre chrono !

### 🏆 Système de Classement (Leaderboard)

Le plugin suit les 15 meilleurs temps du serveur. Vous pouvez afficher ce top via des hologrammes grâce à PlaceholderAPI.

* Variables disponibles :
  * `%hytjump_top_1_name%` : Nom du champion.
  * `%hytjump_top_1_time%` : Son record.
  * *(Fonctionne de 1 à 15).*

### 🎁 Récompenses & Cooldown

Après une victoire, le joueur débloque l'accès au coffre de récompense.

* ⏳ Cooldown : Par défaut, un joueur peut récupérer un lot toutes les 24h.
* ⏱️ Suivi : Utilisez le placeholder `%hytjump_reward_cooldown%` pour afficher le temps restant au joueur avant son prochain gain.

***

### 💻 Commandes Administrateur

| **Commande**                       | **Description**                                         |
| ---------------------------------- | ------------------------------------------------------- |
| `/hytjump start/end`               | Configure les plaques de jeu.                           |
| `/hytjump reward set/unset`        | Configure le coffre de gains.                           |
| `/hytjump cooldown reset <pseudo>` | Rend le coffre disponible immédiatement pour un joueur. |
| `/hytjump cooldown set <pseudo>`   | Bloque le coffre d'un joueur pour 24h.                  |
| `/hytjump reload`                  | Recharge les fichiers de config et de langue.           |

### 🌍 Personnalisation (Config & Langues)

* Langues : Modifiez `language: fr` ou `en` dans la `config.yml`. Les messages sont entièrement modifiables dans le dossier `/languages/`.
* Blocs : Vous pouvez choisir les blocs qui apparaissent pendant le jump dans la liste `jump-blocks` de la config.
* Récompenses : Ajoutez autant de commandes que vous voulez avec un système de pourcentage de chance.

***

#### 🖼️ Tableau des Placeholders (PlaceholderAPI)

| Placeholder                 | 📝 Description Courte                                       | 💡 Exemple de Rendu |
| --------------------------- | ----------------------------------------------------------- | ------------------- |
| `%hytjump_best_time%`       | Affiche le meilleur temps (record) du joueur.               | `00:45:120`         |
| `%hytjump_last_time%`       | Affiche le temps réalisé lors du tout dernier essai réussi. | `00:52:800`         |
| `%hytjump_reward_cooldown%` | Temps d'attente restant avant d'ouvrir le coffre.           | `18h 05m 30s`       |
| `%hytjump_top_{1-15}_name%` | Affiche le pseudo du joueur au rang spécifié.               | `Papa_Arnix`        |
| `%hytjump_top_{1-15}_time%` | Affiche le temps du joueur au rang spécifié.                | `00:38:005`         |


---

# 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.arnixstudio.fr/documentation/fr-wiki-officiel-hytjump.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.