Integrations

CobaltiaEffets does not provide a public Java API: it integrates with other plugins through their APIs, through configurable console commands and through placeholders. Every optional integration is detected on startup; when a plugin is missing, only the features depending on it are turned off.

Required dependencies

LuckPerms required

• Ownership of effects, cosmetics and companions: permissions cobaltia.effet.<id>, cobaltia.cosmetique.<id>, cobaltia.compagnon.<id> (granted by the give commands, including offline).
• Player choices: metas effet_pseudo (active effect) and compagnon (equipped companion). Other plugins can read them, for example %luckperms_meta_effet_pseudo%.
• Prefix: the LuckPerms prefix is reused by %cobaltiaeffets_prefixe% (&, &#RRGGBB and {#RRGGBB} codes accepted).
• Tab sorting: instant recomputation on every player change.

PlaceholderAPI required

Provides the cobaltiaeffets expansion (see Placeholders) and lets the plugin read other plugins’ placeholders (HMCCosmetics, “Cobaltia” plugin).

Optional integrations

Plugin	Usage	Without it
PacketEvents	Packet-based companion rendering (virtual entities, scale, mount)	Companions are not shown
HMCCosmetics	Hats and backpacks: cosmetics apply / unapply and the %HMCCosmetics_equipped_<id>% placeholder	Cosmetic tabs unavailable
Nexo	nexo:<id> icons in menus, /give for Nexo items, custom block break event, job icon font	Fallback icons (vanilla materials), no Nexo /give or custom ores
BetterHud	Hiding the HUD according to the player’s preference	Preference ignored
Jobs Reborn	XP gain and payment events, global top, Jobs economy	No XP in the banner, no job protections, no level rank
WorldGuard	AFK zone region detection	AFK zone disabled
CMI	/rtp teleport (cmi rt), default tab refresh command (cmi tablistupdate), cmi.tablistweight.<n> convention	Replace the commands in apres_changement; /rtp does not teleport
zMenu	Effects menu opened by /effets (zmenu open effets {joueur} false)	Change menu, or leave it empty for a text list

Tip

CMI and zMenu are only used through commands defined in config.yml: you can replace them with other plugins’ commands (DeluxeMenus, TAB…).

The “Cobaltia” core plugin

CobaltiaEffets was written for the Cobaltia server and connects to its core plugin when present:

Feature	What is used
Shop	Withdrawing/refunding gems, coins and farm points; current season; active boosters and booster activation
/money	Balance placeholders (coins, gems, farm points)
AFK zone	Coin credit command
Wardrobe — titles	Owned and equipped titles, custom title, title definition file
Chat	Clan name, coins leaderboard rank
Placeholders	Season/weekly leaderboards, active boosters
/give	The plugin’s items and farm tools
Player settings	cobaltia:settings_mentions and cobaltia:settings_hud data

Without that plugin, these features are simply unavailable (the shop answers “Shop unavailable”, the related placeholders return an empty value); everything else works normally.

Resource pack

Several renderings happen client-side and assume a suitable resource pack:

• Name animations: a text shader that recognizes trigger colors (Name effects);
• Banner: the cobaltia:bandeau font (corners, background, accent stroke, negative spaces) (Banner);
• Glyphs in messages and badges: Unicode private-use characters (\uE1xx, Nexo font nexo:default).

Without a pack, the plugin remains usable: names are colored without animation and you can remove glyphs from messages.