Compagnons

Les compagnons sont des mini-mobs purement cosmétiques qui suivent le joueur. Ils n’existent pas dans le monde : ils sont affichés aux joueurs proches par paquets réseau (via PacketEvents). Ils ne peuvent donc ni être frappés, ni bloquer quoi que ce soit, ni coûter de ressources au serveur comme de vraies entités.

Catalogue fourni

Le config.yml par défaut contient 127 compagnons répartis en quatre raretés :

Rareté	Couleur par défaut	Chance au tirage	Compagnons fournis
Commun	`#B9C4D0`	60	51
Rare	`#6FC3FF`	28	41
Épique	`#C77DFF`	10	23
Légendaire	`#FFD84A`	2	12

On y trouve des mini-versions de la plupart des mobs (allay, axolotl, abeille, blaze…), des bébés, 8 jockeys (un mob sur sa monture : cavalier squelette, strider jockey, capitaine ravageur…) et un mini ender dragon représenté par une tête de dragon flottante.

Comportement en jeu

Suivi fluide

Le compagnon se place derrière le joueur, légèrement sur le côté, avec un mouvement lissé et l’orientation de sa marche. S’il est distancé de plus de 8 blocs, il se replace instantanément.

Mobs volants

Les compagnons marqués flotte volent environ 1,2 bloc au-dessus du sol.

Visibilité

Il est montré aux joueurs du même monde dans un rayon de 48 blocs qui peuvent voir son propriétaire.

Discrétion

Il disparaît quand son propriétaire est mort, en spectateur ou en vanish, et réapparaît ensuite. Il suit aussi les téléportations et changements de monde.

Un joueur équipe un compagnon à la fois. Son choix est stocké dans la méta LuckPerms compagnon et restauré à la connexion.

Le joueur ouvre ses compagnons avec /compagnon ou l’onglet « Compagnons » de la garde-robe. Les compagnons possédés sont triés par rareté (la plus haute d’abord) puis par nom, avec leur rareté colorée dans la description. Un clic équipe ou range le compagnon ; « Tout retirer » range le compagnon actif.

Configurer un compagnon

compagnons:
  raretes:
    commun:     {nom: "Commun",     couleur: "#B9C4D0", chance: 60}
    rare:       {nom: "Rare",       couleur: "#6FC3FF", chance: 28}
    epique:     {nom: "Épique",     couleur: "#C77DFF", chance: 10}
    legendaire: {nom: "Légendaire", couleur: "#FFD84A", chance: 2}
  catalogue:
    mini_allay:
      nom: "Mini allay"
      mob: ALLAY          # type d'entité Minecraft
      taille: 0.8         # échelle entre 0.0625 et 1.0
      flotte: true        # vole au-dessus du sol
      rarete: epique
    bebe_sur_cochon:
      nom: "Bébé zombie sur cochon"
      mob: ZOMBIE
      bebe: true          # version bébé du mob
      taille: 0.7
      monture:            # mob monté (jockey)
        mob: PIG
        taille: 0.7
      rarete: rare
    mini_ender_dragon:
      nom: "Mini ender dragon"
      objet: DRAGON_HEAD  # un objet affiché à la place d'un mob
      taille: 0.5
      flotte: true
      rarete: legendaire

Champ	Obligatoire	Description
`nom`	non	Nom affiché (par défaut l’identifiant)
`mob` ou `objet`	oui, l’un des deux	Type d’entité vivante, ou matériau affiché comme objet
`taille`	non	Échelle de `0.0625` à `1.0` (défaut `1.0`)
`bebe`	non	Version bébé (mobs qui en ont une)
`flotte`	non	Vole au-dessus du sol
`monture`	non	Sous-section `mob`, `bebe`, `taille` : monture du jockey
`rarete`	oui	`commun`, `rare`, `epique` ou `legendaire`

Donner des compagnons

/compagnon give <joueur> <id>
/compagnon give <joueur> aleatoire
/compagnon give <joueur> aleatoire:<rareté>
/compagnon remove <joueur> <id|tous>

aleatoire tire d’abord une rareté selon les chances configurées (60/28/10/2 par défaut), puis un compagnon au hasard dans cette rareté.
aleatoire:<rareté> (par exemple aleatoire:legendaire) tire directement dans la rareté indiquée — pratique pour les box ou les récompenses de vote.
La possession est la permission cobaltia.compagnon.<id>, ajoutée de façon permanente (fonctionne hors ligne).
remove … tous retire tous les compagnons ; si le compagnon équipé fait partie des retirés, il est rangé.

Toutes ces sous-commandes demandent cobaltia.compagnon.admin. Le joueur reçoit un message avec le nom du compagnon coloré selon sa rareté.