⚙️Installation
🛠️ Installation
⚠️ Le plugin fonctionne actuellement uniquement pour la version 1.21.4+ de minecraft
📌 Prérequis
🔗 Dépendance Obligatoire
DecentHolograms (2.8.15 ou supérieur) – Affichage des hologrammes.
Sans cette dépendance, Horizons ne fonctionnera pas du tout. Il n'apparaîtra pas dans votre liste de plugin non plus
🔗 Dépendances Optionnelles
Citizens – PNJ pour les boutiques et interactions.
PlaceholderAPI – Intégration avec d'autres plugins.
Skript – Ajout de scripts personnalisés.
WorldEdit / FastAsyncWorldEdit - Système de housing (v7.3.10 WE / v2.13.1 FAWE)
WorldGuard (7.0.13 ou supérieur) - Système de housing
ItemsAdder - Items custom pour les Shops et Marché noir
Oraxen - Items custom pour les Shops et Marché noir
🔧 Étapes d'Installation
📥 Téléchargez Horizons et placez-le dans
/plugins.🛠️ Installez les dépendances requises.
🔄 Redémarrez votre serveur.
📝 Ajoutez votre licence - Lors du premier démarrage, un fichier
mclicense.txtsera créé. Ouvrez-le et insérez votre clé de licence, puis redémarrez le serveur.⚙️ Configurez le plugin via le dossier
/plugins/Horizons.
Si vous téléchargez le plugin depuis BuiltByBit, la licence est directement intégrée dans le .jar que vous téléchargez. Vous n'avez donc pas à faire toutes ces étapes
🏗️ 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