Installation

Installation

1. Vérifiez que le serveur tourne sous Paper 1.21.x avec Java 21, et que LuckPerms et PlaceholderAPI sont installés : sans eux, le plugin se désactive au démarrage.

2. Arrêtez le serveur et copiez CobaltiaEffets.jar dans le dossier plugins/.

3. Ajoutez les plugins facultatifs dont vous voulez profiter (voir le tableau ci-dessous). Aucun n’est indispensable : chaque fonction qui en dépend reste simplement inactive.

4. Démarrez le serveur. Le dossier plugins/CobaltiaEffets/ est créé avec :

   • config.yml — grades, effets, garde-robe, compagnons, bandeau, chat, RTP, zone AFK, tab, messages ;
   • boutique.yml — catégories et articles de la boutique (créé seulement s’il n’existe pas).

5. Consultez la console : le plugin signale toute erreur de configuration (section manquante, couleur invalide, mob inconnu…) et les intégrations absentes.

6. Donnez les permissions de base à vos grades (voir Permissions), puis testez /effets, /garderobe et /boutique en jeu.

Configuration invalide

Si config.yml contient une erreur bloquante (grade sans permission, effet sans couleur pour un grade, catégorie inconnue…), le message config.yml invalide : … s’affiche dans la console et le plugin se désactive pour ne pas afficher de pseudos incorrects. Corrigez la ligne indiquée et redémarrez.

Fonctions selon les plugins présents

Plugin installé	Ce qui s’active
(aucun facultatif)	Effets de pseudo, menu /effets, placeholders, mentions et @item, /money, /furnace, /nightvision, /rtp, bandeau, MOTD, messages de connexion, tab par monde, tri du tab
PacketEvents	Affichage des compagnons autour du joueur
HMCCosmetics	Onglets chapeaux et sacs à dos de la garde-robe, /hat et /sac
Nexo	Icônes Nexo des menus, /give d’objets Nexo, gains de métier sur les minerais personnalisés (avec Jobs)
Jobs Reborn	XP de métier dans le bandeau, rang de niveau dans le chat, pêche AFK, chasse aux joueurs
WorldGuard	Zone AFK rémunérée
BetterHud	Préférence HUD affiché/masqué appliquée à la connexion
Plugin « Cobaltia »	Boutique, titres dans la garde-robe, classements, boosters, clan dans le chat, versements de la zone AFK

* /money lit les soldes via les placeholders du plugin « Cobaltia » ; /rtp téléporte via la commande rt de CMI. Voir Intégrations.

Vérifier l’installation

Console

[CobaltiaEffets] Enabling CobaltiaEffets v1.0.0
[CobaltiaEffets] PacketEvents absent : les compagnons ne seront pas affiches
[CobaltiaEffets] Boutique désactivée : plugin Cobaltia absent

Les lignes d’avertissement ne sont pas des erreurs : elles indiquent qu’une intégration facultative est absente.

En jeu

/papi parse me %cobaltiaeffets_pseudo%
/effets liste
/garderobe

Le premier placeholder doit renvoyer votre pseudo coloré selon votre grade.

Mise à jour

1. Arrêtez le serveur et remplacez le .jar.
2. Gardez vos fichiers config.yml et boutique.yml : les messages absents de votre config.yml sont lus dans la configuration par défaut du .jar, vous n’avez donc pas à recopier les nouvelles clés de message.
3. Redémarrez et vérifiez la console.

Astuce

/effets reload recharge à chaud les messages, le bandeau, les icônes de métier, les minerais, les modèles du chat, /money et les messages de connexion. Les autres sections (effets, garde-robe, compagnons, boutique, RTP, zone AFK, tab) demandent un redémarrage. Voir FAQ.