⚙️Installation

🛠️ Installation

⚠️ Le plugin fonctionne actuellement uniquement pour la version 1.21.4+ de minecraft

📌 Prérequis

🔗 Dépendance Obligatoire

🔗 Dépendances Optionnelles

🔧 Étapes d'Installation

  1. 📥 Téléchargez Horizons et placez-le dans /plugins.

  2. 🛠️ Installez les dépendances requises.

  3. 🔄 Redémarrez votre serveur.

  4. 📝 Ajoutez votre licence - Lors du premier démarrage, un fichier mclicense.txt sera créé. Ouvrez-le et insérez votre clé de licence, puis redémarrez le serveur.

  5. ⚙️ Configurez le plugin via le dossier /plugins/Horizons.


🏗️ Modules Principaux

🏅 Système d’Équipes

Les joueurs sont regroupés en équipes avec des scores, des couleurs uniques et des classements en temps réel. Le système de points est entièrement personnalisable pour s’adapter à votre événement.

💰 Économie & Marché Noir

Horizons propose un système d'économie dynamique où les prix des objets varient selon l'offre et la demande.

  • 🛍️ Boutiques interactives avec PNJ marchands (Citizens).

  • 🔥 Marché noir aléatoire avec des objets rares et des échanges limités.

📜 Hologrammes & Affichage

Affichez des informations en temps réel sur le jeu :

  • 📊 Scores et classements visibles via hologrammes.

  • 🏷️ Noms & préfixes personnalisables au-dessus des joueurs.

  • 💬 Formatage du chat pour une meilleure lisibilité.

🏹 Combat & Modération

  • ⚔️ Système anti-déconnexion pour éviter l’abus en combat.

  • 🔥 Mode PvP configurable (activation/désactivation à tout moment).

  • Gestion avancée des sanctions (mute, freeze, vanish, etc.).

🎨 Resource Pack Auto-hébergé

  • 🔄 Serveur HTTP intégré pour héberger automatiquement vos resource packs

  • 🔒 Système de hash SHA-1 pour garantir l'intégrité des packs

🏠 Système de Housing

  • 🏘️ Maisons pour joueurs et équipes – Achat et gestion des logements avec panneaux interactifs.

  • 🔐 Gestion des accès – Contrôle des membres autorisés et restrictions d'achat par équipe.

  • 🔨 Intégration avec WorldEdit/WorldGuard – Protection des zones et configuration facile des propriétés.

⚙️ Configuration Complète

Tous les paramètres du plugin sont modifiables via des fichiers YAML.

  • 🌍 Spawn & téléportation personnalisables.

  • 🛒 Gestion avancée des shops et du marché noir.

  • 🎨 Personnalisation des préfixes, messages & hologrammes.


🔌 APIs Disponibles

Horizons propose plusieurs intégrations pour enrichir l'expérience et permettre aux développeurs d'étendre ses fonctionnalités.

📜 PlaceholderAPI (PAPI)

Horizons s'intègre avec PlaceholderAPI pour fournir des placeholders dynamiques (préfixe %horizons_) permettant :

  • 👤 Information du joueur - Accéder à l'équipe du joueur actuel, son préfixe et son nom d'affichage.

  • 🏆 Statistiques d'équipe - Afficher des scores, nombre de membres et autres métriques.

  • 📊 Équipes spécifiques - Récupérer des informations sur n'importe quelle équipe par son nom.

Idéal pour les panneaux d'affichage, messages de chat personnalisés ou tout plugin compatible avec PlaceholderAPI.

🛠️ API Java

Les développeurs peuvent interagir avec Horizons via une API Java complète (TeamManagerAPI), permettant :

  • 🔍 Vérifications d'équipes - Vérifier l'existence d'équipes et l'appartenance des joueurs.

  • ℹ️ Informations d'équipe - Accéder aux préfixes, noms d'affichage et listes de membres.

  • 📊 Gestion des scores - Consulter, définir et modifier les scores des équipes.

  • 👥 Équipes et classements - Obtenir toutes les équipes ou les trier par score.

  • 🎮 Gestion des joueurs - Récupérer et manipuler l'équipe d'un joueur.

L'API est thread-safe et conçue pour s'intégrer facilement à d'autres plugins.

✨ Intégration Skript

Horizons est compatible avec Skript, permettant aux administrateurs et développeurs de créer des événements et actions personnalisés sans coder en Java !

Le plugin offre une API Skript complète qui permet :

  • 🏆 Gestion des équipes - Créer, modifier et supprimer des équipes, gérer les membres et leurs attributs.

  • 📊 Manipulation des scores - Définir, incrémenter ou décrémenter les scores d'équipe, les comparer et les trier.

  • 🔍 Récupération d'informations - Accéder aux membres d'une équipe, aux préfixes, noms d'affichage et scores.

  • ⚖️ Conditions avancées - Vérifier l'appartenance à une équipe, comparer des scores entre équipes ou avec des valeurs fixes.


🎤 Rejoignez la Communauté !

Vous avez une suggestion ? Une idée d'amélioration ? Un bug à signaler ? Nous sommes ouverts aux retours pour faire d'Horizons le meilleur plugin pour les événements Cité ! 🚀

📢 Participez aux discussions et suivez les mises à jour : 📍 Lien du Discord

Mis à jour