Configuration
Directoryplugins/CobaltiaEffets/
- config.yml — the whole configuration (except the shop)
- boutique.yml —
/boutiquecategories and items - rtp.yml — today’s
/rtpcounters (generated) - afk.yml — today’s AFK zone gains (generated)
Player choices (active effect, equipped companion) are stored in LuckPerms (metas effet_pseudo and compagnon); preferences (night vision, hidden clan, per-season purchases) in the world player data. No extra database is needed.
config.yml sections
Section titled “config.yml sections”| Section | Purpose | Reload | Page |
|---|---|---|---|
grades |
Colors and permission of each display rank, by priority | Restart | Name effects |
effets |
Effects catalog: name, description, icon, triggers, markers, positions | Restart | Name effects |
apres_changement |
Console commands after an effect or title change ({joueur}) |
Restart | Name effects |
menu |
Console command opened by /effets with no argument ({joueur}); empty = text list |
Restart | Name effects |
titres_apres |
Titles shown after the name, with their rendering | Restart | Wardrobe |
titres_badges |
Badge rendering of some titles before the name | Restart | Wardrobe |
motd |
Server list MOTD | Restart | Tab, MOTD and joins |
connexion |
Join/quit messages | /effets reload |
Tab, MOTD and joins |
minerais_metier |
Jobs rewards on Nexo blocks | /effets reload |
Jobs |
bandeau |
Duration, colors, XP template, redirected messages, short texts, job icons | /effets reload |
Banner |
chat_infos |
Ranks/clan prefix templates | /effets reload |
Chat |
compagnons |
Companion rarities and catalog | Restart | Companions |
rtp |
Random teleport world | Restart | Random teleport |
money |
Lines shown by /money |
/effets reload |
Utilities |
chasse_joueurs |
Kill farming window | Restart | Jobs |
peche_afk |
AFK fishing protection | Restart | Jobs |
zone_afk |
Paid AFK zone | Restart | AFK zone |
tab_par_monde |
Tab list world groups | Restart | Tab, MOTD and joins |
garderobe |
Wardrobe categories and cosmetics | Restart | Wardrobe |
messages |
Every plugin text | /effets reload |
Messages |
Startup validation
Section titled “Startup validation”The plugin checks the configuration before enabling and refuses to start, with an explicit message, if:
- a color is not in the
#RRGGBBformat; - a rank has no
permissionorcouleurs; - an effect ID contains anything other than lowercase letters, digits and
_; - an effect lacks a trigger (or a marker, or a position) for a rank;
- a wardrobe category has an unknown type or lacks its
emplacement/commande; - a cosmetic points to an unknown category;
- a companion has neither
mobnorobjet, has an unknown mob, an out-of-range size or an invalid rarity.
boutique.yml is validated separately: on error, only the shop is disabled.
/effets reload re-reads config.yml safely: if the file cannot be parsed or a message is missing, the reload is refused and the previous configuration stays active.
Key reference
Section titled “Key reference”Table generated from the default files. Values shown are the ones shipped with the plugin; filter by file or by text.
218 results
grades.<grade>.permissionPermission that assigns this name grade; the first grade in the list whose permission the player has is applied.
grades.<grade>.couleursHex colours of the player name for this grade: one colour for a solid name, several for a gradient.
grades.<grade>.grasDisplays the name of this grade in bold (false by default).
effets.<effet>.nomName of the name effect shown in the wardrobe, the shop and messages; <effet> = identifier made of lowercase letters, digits and _.
effets.<effet>.descriptionEffect description shown in its icon lore in the wardrobe.
effets.<effet>.iconeEffect icon in the wardrobe: a Minecraft material or a Nexo item as nexo:<id> (PAPER by default).
effets.<effet>.declencheurs.<grade>Trigger colour applied to the name for this grade, recognised by the resource pack shader to animate the effect; required for every grade and badge.
effets.<effet>.marqueurs.debut.<grade>Special colour set on the first letter of the name for this grade, used by the shader to locate the start of the effect (optional).
effets.<effet>.marqueurs.fin.<grade>Special colour set on the last letter of the name for this grade, used by the shader to locate the end of the effect (optional).
effets.<effet>.positions.<grade>Colour step added letter by letter to the trigger so the shader can locate each letter (optional, otherwise required for all grades).
apres_changementConsole commands run after an effect, cosmetic or title change; {joueur} = the player's name.
menuConsole command that opens the effects menu on /effets; {joueur} = the player's name, empty to show the list in chat.
titres_apres.starText appended after the name when the star title is equipped; each titres_apres key is a title shown after the name instead of before.
motdMiniMessage lines of the server description shown in the server list (two lines).
connexion.arriveeJoin message shown in chat; <player> = player name, not applied to a hidden player.
connexion.departQuit message shown in chat when depart_chat is true; <player> = player name.
connexion.depart_chatShows the quit message in chat; when false, the departure is only logged in the console.
minerais_metier.metierName of the Jobs job that receives the rewards of the Nexo ores listed in minerais_metier.blocs (Miner by default).
minerais_metier.blocsNexo ores paid to the job, by Nexo identifier: money, points and xp earned when mined in survival, without Silk Touch.
bandeau.dureeDisplay time in seconds of a notification in the banner above the hotbar (minimum 1, 5 by default).
bandeau.couleurs.succesBanner accent colour for success messages.
bandeau.couleurs.infoBanner accent colour for information messages.
bandeau.couleurs.avertBanner accent colour for warnings.
bandeau.couleurs.refusBanner accent colour for refusals and errors.
bandeau.couleurs.xpBanner accent colour for job XP gains.
bandeau.couleurs.afkBanner accent colour for the AFK zone counter.
bandeau.couleurs.voteBanner accent colour for the vote type of the /bandeau command.
bandeau.xpFormat of the job XP gain shown in the banner; <icone>, <metier>, cumulative <gain>, <xp> and <max> of the level.
bandeau.messagesMessage keys sent to the banner above the hotbar instead of the chat.
bandeau.textes.activeShort version shown in the banner when a name effect is activated; <nom> = effect.
bandeau.textes.retireShort version shown in the banner when the name effect is removed.
bandeau.textes.deja_actifShort version shown in the banner when the player picks an effect that is already active; <nom> = effect.
bandeau.textes.aucun_actifShort version shown in the banner when the player removes an effect while none is active.
bandeau.textes.verrouilleShort version shown in the banner when the player picks an effect they do not own; <nom> = effect.
bandeau.textes.garderobe_equipeShort version shown in the banner when a cosmetic is equipped from the wardrobe; <nom> = cosmetic.
bandeau.textes.garderobe_retireShort version shown in the banner when a cosmetic is removed from the wardrobe; <nom> = cosmetic.
bandeau.textes.garderobe_tout_retireShort version shown in the banner after the Remove all button of the wardrobe.
bandeau.textes.titre_equipeShort version shown in the banner when a title is equipped; <nom> = title.
bandeau.textes.titre_retireShort version shown in the banner when a title is removed; <nom> = title.
bandeau.textes.titre_pleinShort version shown in the banner when the player equips a title while two are already equipped.
bandeau.textes.titre_indisponibleShort version shown in the banner when a title cannot be equipped or removed.
bandeau.textes.compagnon_equipeShort version shown in the banner when a companion is summoned; <nom> = companion.
bandeau.textes.compagnon_retireShort version shown in the banner when a companion is put away; <nom> = companion.
bandeau.textes.compagnon_pas_possedeShort version shown in the banner when the player picks a companion they do not own; <nom> = companion.
bandeau.textes.compagnon_tout_retireShort version shown in the banner after the Remove all button of the companions tab.
bandeau.textes.afk_entreeShort version shown in the banner when entering the AFK zone; <taux> = coins per second.
bandeau.textes.afk_sortieShort version shown in the banner when leaving the AFK zone; <gain> = coins earned during the session.
bandeau.textes.afk_plafondShort version shown in the banner when the daily AFK cap is reached.
bandeau.textes.chat_infos_clan_afficheShort version shown in the banner when /chatinfos clan shows the clan again.
bandeau.textes.chat_infos_clan_masqueShort version shown in the banner when /chatinfos clan hides the clan.
bandeau.textes.chat_infos_classements_afficheShort version shown in the banner when /chatinfos classements shows the ranks again.
bandeau.textes.chat_infos_classements_masqueShort version shown in the banner when /chatinfos classements hides the ranks.
bandeau.textes.chat_infos_vipShort version shown in the banner when a player without the VIP+ rank uses /chatinfos.
bandeau.textes.garderobe_creatifShort version shown in the banner when cosmetics are turned off in creative or spectator mode.
bandeau.textes.boutique_fondsShort version shown in the banner when the player lacks the currency for a purchase; <monnaie> = currency.
bandeau.textes.boutique_dejaShort version shown in the banner when the player buys an item they already own; <article> = item.
bandeau.textes.boutique_saisonShort version shown in the banner when an item limited to one purchase per season has already been bought.
bandeau.textes.boutique_booster_aucunShort version shown in the banner when a random booster is bought while every type is already active.
bandeau.textes.mentionShort version shown in the banner when a player is mentioned with @name in chat; <joueur> = author.
bandeau.icones_metiers.<metier>Nexo glyph shown before the job name in the XP banner; <metier> = job name as displayed by Jobs.
chat_infos.classementsRanking block shown before the name in chat; <parties> = level and coins ranks.
chat_infos.separateurSeparator placed between the level rank and the coins rank in chat.
chat_infos.niveauFormat of the jobs leaderboard rank in chat; <rang> = the player's position.
chat_infos.coinsFormat of the coins leaderboard rank in chat; <rang> = the player's position.
chat_infos.clanFormat of the clan shown before the name in chat; <clan> = clan name.
compagnons.raretes.<rarete>.nomDisplayed name of the rarity; <rarete> = commun, rare, epique or legendaire.
compagnons.raretes.<rarete>.couleurHex colour of the rarity, used for the companion name and its lore.
compagnons.raretes.<rarete>.chanceWeight of the rarity in a random companion draw (proportion of the sum of weights).
compagnons.catalogue.<compagnon>.nomDisplayed name of the companion; <compagnon> = identifier, the permission cobaltia.compagnon.<compagnon> unlocks it.
compagnons.catalogue.<compagnon>.mobMinecraft entity type of the companion; set either mob or objet, not both.
compagnons.catalogue.<compagnon>.tailleCompanion scale between 0.0625 and 1 (1 by default).
compagnons.catalogue.<compagnon>.flotteMakes the companion fly above the ground instead of walking (false by default).
compagnons.catalogue.<compagnon>.rareteCompanion rarity: commun, rare, epique or legendaire.
compagnons.catalogue.<compagnon>.bebeShows the companion as a baby when the mob allows it (false by default).
compagnons.catalogue.<compagnon>.monture.mobEntity type of an optional mount the companion rides on.
compagnons.catalogue.<compagnon>.monture.tailleMount scale between 0.0625 and 1 (1 by default).
compagnons.catalogue.<compagnon>.objetMinecraft item displayed instead of a mob as the companion, also used as the menu icon.
rtp.mondeDestination world of /rtp; empty to disable the plugin's handling of /rtp.
moneyMiniMessage lines shown by /money; <joueur>, <coins>, <gemmes> and <points> = the player's balances.
chasse_joueurs.fenetre_heuresWindow in hours during which killing the same player only grants job XP and money once.
peche_afk.actifEnables blocking of job fishing rewards for players who no longer move their camera.
peche_afk.minutesMinutes without camera movement after which fishing no longer pays the job (minimum 1).
peche_afk.metiersJobs affected by the AFK fishing block.
zone_afk.actifEnables the AFK zone that pays coins to players inside its WorldGuard regions.
zone_afk.regionsWorldGuard regions that make up the AFK zone.
zone_afk.coins_par_secondeCoins earned per second in the AFK zone, multiplied by the cobaltia.afk.multiplier.<value> permission.
zone_afk.star_coins_par_secondeMinimum rate in coins per second for players with the cobaltia.afk.star permission.
zone_afk.plafond_jourMaximum coins that can be earned per day in the AFK zone, reset every day at midnight (Paris time).
zone_afk.versement_secondesInterval in seconds between two payouts of the coins accumulated in the AFK zone (minimum 1).
tab_par_monde.actifLimits the player list (Tab) to players in the same world group.
tab_par_monde.groupes.<groupe>.nomDisplayed name of the world group, returned by the world placeholder; <groupe> = group identifier.
tab_par_monde.groupes.<groupe>.mondesWorlds bundled in this group: their players see each other in the Tab list.
titres_badges.<grade>Badge shown in place of the matching title before the name; the key is the title identifier (vip, vipplus, premium…).
garderobe.categories.<categorie>.nomName of the wardrobe tab; <categorie> = category identifier.
garderobe.categories.<categorie>.typeTab type: cosmetique, effets, titres, compagnons or lien (cosmetique by default).
garderobe.categories.<categorie>.emplacementHMCCosmetics slot of the tab's cosmetics, for example HELMET or BACKPACK; required for the cosmetique type.
garderobe.categories.<categorie>.commandeCommand run by the player when clicking a lien tab, or as a fallback for a titres tab; required for these types.
garderobe.cosmetiques.<cosmetique>.nomDisplayed name of the cosmetic; <cosmetique> = HMCCosmetics identifier, unlocked by cobaltia.cosmetique.<cosmetique>.
garderobe.cosmetiques.<cosmetique>.categorieCosmetique-type tab the cosmetic belongs to.
garderobe.cosmetiques.<cosmetique>.nexoIdentifier of the Nexo item used as the cosmetic icon (the cosmetic identifier by default).
messages.aucunText shown in /effets liste when no effect is active or owned.
messages.tous_les_effetsText replacing the effect name when an admin gives or removes all effects.
messages.tous_les_cosmetiquesText replacing the cosmetic name when an admin gives or removes all cosmetics.
messages.tous_les_compagnonsText replacing the companion name when an admin removes all companions.
messages.compagnon_lore_rareteRarity line in a companion's lore in the wardrobe; <couleur> and <rarete> = rarity colour and name.
messages.garderobe_titreTitle of the wardrobe inventory; <categorie> = name of the open tab.
messages.garderobe_lore_equipeLore line of an item already equipped in the wardrobe.
messages.garderobe_lore_equiperLore line of an unequipped item in the wardrobe.
messages.garderobe_videName of the icon shown when the wardrobe tab is empty.
messages.garderobe_vide_detailLore of the icon shown when the wardrobe tab is empty.
messages.garderobe_precedenteName of the wardrobe previous page button.
messages.garderobe_suivanteName of the wardrobe next page button.
messages.garderobe_ongletLore of a wardrobe tab that is not displayed.
messages.garderobe_onglet_actifLore of the wardrobe tab currently displayed.
messages.garderobe_tout_retirerName of the wardrobe Remove all button.
messages.garderobe_pagePage indicator on the wardrobe navigation buttons; <page> and <total>.
messages.garderobe_fermerName of the wardrobe Close button.
messages.garderobe_onglet_lienLore of a lien-type tab, which opens another menu.
messages.garderobe_apercuPreview line of the name with the effect in the wardrobe; <apercu> = coloured name.
messages.garderobe_titre_limiteLore line on titles recalling the limit of equipped titles.
messages.separateurSeparator between owned effects in /effets liste.
messages.possedeFormat of an owned effect in /effets liste; <nom> = effect.
messages.afk_actionbarCounter shown continuously in the AFK zone; <taux> per second, <jour> earned today, daily <plafond>.
messages.afk_actionbar_pleinCounter shown in the AFK zone once the daily cap is reached; <plafond> = cap.
messages.activeMessage sent when the player activates a name effect; <nom> = effect.
messages.retireMessage sent when the player removes their name effect.
messages.deja_actifMessage sent when the player picks an effect that is already active; <nom> = effect.
messages.aucun_actifMessage sent by /effets retirer when no effect is active.
messages.inconnuMessage sent by /effets choisir for a non-existent effect; <id> = input.
messages.verrouilleMessage sent when the player picks an effect they do not own; <nom> = effect.
messages.erreurMessage sent when saving a choice or a grant fails.
messages.joueur_seulementMessage sent when a player-only command is run from the console.
messages.listeMessage of /effets liste; <actif> = active effect, <possedes> = owned effects.
messages.usageHelp for /effets, shown after the list or on an invalid argument.
messages.admin_donneConfirmation sent to the admin after /effets give; <joueur> and <nom> = effect.
messages.admin_retireConfirmation sent to the admin after /effets remove; <joueur> and <nom> = effect.
messages.admin_rienMessage sent to the admin when /effets give or remove changes nothing; <joueur> and <nom>.
messages.admin_perduMessage sent to the online player when an admin removes an effect from them; <nom> = effect.
messages.garderobe_equipeMessage sent when a cosmetic is equipped from the wardrobe; <nom> = cosmetic.
messages.garderobe_retireMessage sent when a cosmetic is removed from the wardrobe; <nom> = cosmetic.
messages.garderobe_tout_retireMessage sent after the wardrobe Remove all button.
messages.garderobe_indisponibleMessage sent when a cosmetics or companions tab cannot open because the required plugin is missing.
messages.titre_equipeMessage sent when a title is equipped from the wardrobe; <nom> = title.
messages.titre_retireMessage sent when a title is removed from the wardrobe; <nom> = title.
messages.titre_pleinMessage sent when the player equips a title while the maximum is already equipped.
messages.titre_indisponibleMessage sent when a title cannot be equipped or removed at the moment.
messages.admin_recuMessage sent to the online player when an admin gives them an effect; <nom> = effect.
messages.joueur_inconnuMessage sent when the target player has never joined the server; <joueur> = name entered.
messages.pas_permissionMessage sent when the command sender lacks the required permission.
messages.cosmetique_donneConfirmation sent to the admin after /hat or /sac give; <joueur> and <nom> = cosmetic.
messages.cosmetique_retireConfirmation sent to the admin after /hat or /sac remove; <joueur> and <nom> = cosmetic.
messages.cosmetique_rienMessage sent to the admin when /hat or /sac changes nothing; <joueur> and <nom>.
messages.cosmetique_recuMessage sent to the online player when an admin gives them a cosmetic; <nom> = cosmetic.
messages.cosmetique_perduMessage sent to the online player when an admin removes a cosmetic from them; <nom> = cosmetic.
messages.usage_cosmetiqueHelp for /hat and /sac on invalid arguments; <commande> = command used.
messages.compagnon_equipeMessage sent when a companion is summoned from the wardrobe; <nom> = companion.
messages.compagnon_retireMessage sent when a companion is put away from the wardrobe; <nom> = companion.
messages.compagnon_tout_retireMessage sent after the Remove all button of the companions tab.
messages.compagnon_pas_possedeMessage sent when the player picks a companion they do not own; <nom> = companion.
messages.compagnon_recuMessage sent to the online player when a companion is given to them; <nom>, <couleur> and <rarete>.
messages.compagnon_perduMessage sent to the online player when an admin removes a companion from them; <nom> = companion.
messages.compagnon_admin_donneConfirmation sent to the admin after /compagnon give; <joueur>, <nom>, <couleur> and <rarete>.
messages.compagnon_admin_retireConfirmation sent to the admin after /compagnon remove; <joueur> and <nom> = companion.
messages.compagnon_admin_rienMessage sent to the admin when /compagnon give or remove changes nothing; <joueur> and <nom>.
messages.compagnon_inconnuMessage sent by /compagnon for a non-existent companion; <id> = input.
messages.usage_compagnon_adminHelp for the /compagnon admin commands on invalid arguments.
messages.rtp_okMessage sent after a successful /rtp; <restants> = /rtp still available today.
messages.rtp_ok_illimiteMessage sent after a successful /rtp with no daily limit.
messages.rtp_quotaMessage sent when the daily /rtp quota is used up; <quota> = number allowed per day.
messages.rtp_delaiMessage sent when the delay between two /rtp has not elapsed; <secondes> = remaining wait.
messages.rtp_indisponibleMessage sent by /rtp when the destination world is not loaded.
messages.give_okConfirmation of a /give of a Nexo or server item; <joueur>, <quantite> and <nom> = item.
messages.afk_entreeMessage sent when entering the AFK zone; <taux> = coins per second, <reste> = coins still earnable today.
messages.afk_sortieMessage sent when leaving the AFK zone; <gain> = coins earned during the session.
messages.afk_plafondMessage sent when the daily AFK cap is reached; <plafond> = cap.
messages.fourneau_okMessage sent after /furnace; <quantite> = number of items smelted.
messages.fourneau_rienMessage sent by /furnace when the held item cannot be smelted.
messages.fourneau_rien_toutMessage sent by /furnace all when no inventory item can be smelted.
messages.vision_onMessage sent when /nightvision turns night vision on.
messages.vision_offMessage sent when /nightvision turns night vision off.
messages.chat_infos_clan_afficheMessage sent when /chatinfos clan shows the clan in chat again.
messages.chat_infos_clan_masqueMessage sent when /chatinfos clan hides the clan in chat.
messages.chat_infos_classements_afficheMessage sent when /chatinfos classements shows the ranks in chat again.
messages.chat_infos_classements_masqueMessage sent when /chatinfos classements hides the ranks in chat.
messages.rechargement_okMessage sent after a successful /effets reload.
messages.rechargement_erreurMessage sent when /effets reload fails; the previous configuration stays active.
messages.boutique_achat_okMessage sent after a purchase in /boutique; <article> and the <prix> paid.
messages.mentionMessage sent to the player mentioned with @name in chat; <joueur> = author.
messages.peche_afkWarning sent once when AFK fishing stops paying the job.
messages.boutique_fondsMessage sent when the player lacks the currency for a purchase; <monnaie> = currency.
messages.boutique_dejaMessage sent when the player buys an item they already own; <article> = item.
messages.boutique_saisonMessage sent when an item limited to one purchase per season has already been bought; <article> = item.
messages.boutique_booster_aucunMessage sent when a random booster is bought while every type is already active.
messages.boutique_erreurMessage sent when a purchase fails without anything being charged.
messages.boutique_indisponibleMessage sent by /boutique when the link to the server economy is unavailable.
messages.garderobe_creatifMessage sent when cosmetics are turned off on switching to creative or spectator mode.
messages.chat_infos_vipMessage sent when a player without the VIP+ rank uses /chatinfos.
messages.chat_infos_usageHelp for /chatinfos on an invalid argument.
messages.bandeau_usageHelp for /bandeau when arguments are missing.
messages.give_hors_ligneMessage sent when the player targeted by a command is not online; <joueur> = name entered.
messages.usage_adminHelp for the /effets admin commands on invalid arguments.
boutiques.gemmes.titreTitle of the /boutique main menu.
boutiques.gemmes.monnaie-principaleCurrency offered first when an item has several prices: gems, coins or farm_points.
boutiques.gemmes.categories.<categorie>.nomName of the category in the shop, MiniMessage allowed; <categorie> = category identifier.
boutiques.gemmes.categories.<categorie>.iconeCategory icon: a Minecraft material or a Nexo item as nexo:<id> (CHEST by default).
boutiques.gemmes.categories.<categorie>.slotSlot of the category icon in the shop main menu.
boutiques.gemmes.categories.<categorie>.descriptionLore lines of the category icon.
boutiques.gemmes.articles.<article>.categorieCategory in which the item is displayed; <article> = item identifier.
boutiques.gemmes.articles.<article>.nomDisplayed name of the item.
boutiques.gemmes.articles.<article>.iconeItem icon: a Minecraft material or a Nexo item as nexo:<id> (PAPER by default).
boutiques.gemmes.articles.<article>.prix.gemsItem price in gems (strictly positive).
boutiques.gemmes.articles.<article>.prix.coinsItem price in coins (strictly positive); with several prices, the player picks the currency.
boutiques.gemmes.articles.<article>.commandesConsole commands run after payment; {joueur} = player name, {hasard:a|b} = random choice.
boutiques.gemmes.articles.<article>.lienCommand run by the player on click, instead of a purchase (opens another menu).
boutiques.gemmes.articles.<article>.loreLore lines of the item.
boutiques.gemmes.articles.<article>.booster-aleatoire.facteurMultiplier of the personal booster drawn at random among inactive types (2 by default).
boutiques.gemmes.articles.<article>.booster-aleatoire.minutesDuration in minutes of the random personal booster (60 by default).
boutiques.gemmes.articles.<article>.possedePermission indicating the player already owns the item, which blocks its purchase.
- No entries.