Intégrations

CobaltiaEffets ne fournit pas d’API Java publique : il s’intègre aux autres plugins par leurs API, par des commandes console configurables et par des placeholders. Toutes les intégrations facultatives sont détectées au démarrage ; si un plugin manque, seules les fonctions qui en dépendent sont coupées.

Dépendances obligatoires

LuckPerms obligatoire

Possession des effets, cosmétiques et compagnons : permissions cobaltia.effet.<id>, cobaltia.cosmetique.<id>, cobaltia.compagnon.<id> (attribuées par les commandes give, y compris hors ligne).
Choix des joueurs : métas effet_pseudo (effet actif) et compagnon (compagnon équipé). D’autres plugins peuvent les lire, par exemple %luckperms_meta_effet_pseudo%.
Préfixe : le préfixe LuckPerms est repris par %cobaltiaeffets_prefixe% (codes &, &#RRGGBB et {#RRGGBB} acceptés).
Tri du tab : recalcul instantané à chaque modification d’un joueur.

PlaceholderAPI obligatoire

Fournit l’extension cobaltiaeffets (voir Placeholders) et permet au plugin de lire les placeholders d’autres plugins (HMCCosmetics, plugin « Cobaltia »).

Intégrations facultatives

Plugin	Utilisation	Sans lui
PacketEvents	Affichage des compagnons par paquets (entités virtuelles, taille, monture)	Les compagnons ne sont pas affichés
HMCCosmetics	Chapeaux et sacs à dos : `cosmetics apply` / `unapply` et placeholder `%HMCCosmetics_equipped_<id>%`	Onglets cosmétiques indisponibles
Nexo	Icônes `nexo:<id>` dans les menus, `/give` d’objets Nexo, événement de casse des blocs personnalisés, police des icônes de métier	Icônes de repli (matériaux vanilla), pas de `/give` Nexo ni de minerais personnalisés
BetterHud	Masquage du HUD selon la préférence du joueur	Préférence ignorée
Jobs Reborn	Événements de gain d’XP et de paiement, classement global, économie Jobs	Pas d’XP dans le bandeau, ni de protections métiers, ni de rang de niveau
WorldGuard	Détection des régions de la zone AFK	Zone AFK désactivée
CMI	Téléportation de `/rtp` (`cmi rt`), commande de rafraîchissement du tab par défaut (`cmi tablistupdate`), convention `cmi.tablistweight.<n>`	Remplacez les commandes dans `apres_changement` ; `/rtp` ne téléporte pas
zMenu	Menu d’effets ouvert par `/effets` (`zmenu open effets {joueur} false`)	Changez `menu`, ou laissez-le vide pour une liste texte

Plugin principal « Cobaltia »

CobaltiaEffets a été écrit pour le serveur Cobaltia et se connecte à son plugin principal lorsqu’il est présent :

Fonction	Ce qui est utilisé
Boutique	Débit/remboursement des gemmes, coins et points de farm ; saison en cours ; boosters actifs et activation de boosters
`/money`	Placeholders de solde (coins, gemmes, points de farm)
Zone AFK	Commande de crédit de coins
Garde-robe — titres	Titres possédés et équipés, titre personnalisé, fichier de définition des titres
Chat	Nom du clan, rang au classement des coins
Placeholders	Classements saison/hebdo, boosters actifs
`/give`	Objets et outils de farm du plugin
Paramètres joueur	Données `cobaltia:settings_mentions` et `cobaltia:settings_hud`

Sans ce plugin, ces fonctions sont simplement indisponibles (la boutique répond « Boutique indisponible », les placeholders concernés renvoient une valeur vide) ; tout le reste fonctionne normalement.

Pack de ressources

Plusieurs rendus sont faits côté client et supposent un pack de ressources adapté :

Animations des pseudos : shader de texte qui reconnaît les couleurs déclencheurs (Effets de pseudo) ;
Bandeau : police cobaltia:bandeau (coins, fond, trait d’accent, espaces négatifs) (Bandeau) ;
Glyphes des messages et badges : caractères de la zone privée Unicode (\uE1xx, police Nexo nexo:default).

Sans pack, le plugin reste utilisable : les pseudos sont colorés sans animation et vous pouvez retirer les glyphes des messages.