> For the complete documentation index, see [llms.txt](https://horizons-cite-plugin.gitbook.io/horizons-cite-plugin/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://horizons-cite-plugin.gitbook.io/horizons-cite-plugin/modules/guide-et-installation.md).

# Guide et Installation

## Qu'est-ce qu'un module ?

Les **modules** sont des extensions autonomes qui ajoutent des fonctionnalités supplémentaires à Horizons. Ils fonctionnent de manière indépendante et peuvent être activés, désactivés ou rechargés sans redémarrer le serveur.

## Pourquoi des modules ?

Certaines fonctionnalités qui étaient initialement intégrées au plugin Horizons ont été déplacées en tant que modules pour plus de praticité. Ces features bonus peuvent ainsi être installées uniquement si vous en avez besoin, gardant le plugin principal léger et performant.

Les modules officiels incluent notamment :

* **Suite de Modération** — Outils avancés pour la gestion des joueurs
* **Système de Warp** — Points de téléportation personnalisés
* **Anti-AFK** — Détection et gestion des joueurs inactifs
* **CombatLogout** — Protection contre la déconnexion en combat
* D'autres à venir plus tard...

En plus de ça, il devenait nécessaire d'offrir aux développeurs la possibilité d'étendre les capacité d'Horizons exactement comme ils le souhaitaient de façon simplifié et pratique. C'est de là qu'est né l'idée des modules.

***

## 📚 Bibliothèque de Modules

Vous pouvez parcourir et télécharger les modules officiels/validés directement depuis le jeu :

1. Exécutez la commande `/hz gui`
2. Cliquez sur le bouton **"Modules"**
3. Accédez à la **"Bibliothèque de Modules"**

Depuis cette interface, vous pouvez découvrir tous les modules disponibles et les installer en un clic.

***

## 🔧 Commandes de Gestion

| Commande                              | Description                                                          |
| ------------------------------------- | -------------------------------------------------------------------- |
| `/horizons module list`               | Affiche la liste des modules installés et leur statut                |
| `/horizons module reload <module>`    | Recharge la configuration d'un module                                |
| `/horizons module reloadjar <module>` | Recharge complètement un module (déchargement + rechargement du JAR) |

> \[!NOTE] La commande `reloadjar` permet un "hot reload" complet du module, utile lors de mises à jour ou de développement.

**Permission requise :** `horizons.module`

***

## 👨‍💻 Pour les Développeurs

Les modules sont ouverts aux développeurs tiers ! Vous pouvez créer vos propres modules pour étendre les fonctionnalités d'Horizons selon vos besoins.

La documentation complète de l'API est disponible ici : [**Documentation API Développeurs**](/horizons-cite-plugin/apis/api-java-and-modules.md)


---

# 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://horizons-cite-plugin.gitbook.io/horizons-cite-plugin/modules/guide-et-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.