Présentation

Communication Paper 1.21.x v1.0.0

CobaltiaAnnonces diffuse des annonces dans le chat de vos joueurs. Tout se décrit dans un seul fichier, annonces.json : le texte des annonces (en MiniMessage), leur cadre décoratif, les rotations automatiques, les zones et les messages d’accueil déclenchés à l’entrée d’une zone. Un menu en jeu permet ensuite d’envoyer, de prévisualiser et de piloter les rotations sans retoucher le fichier.

Le plugin a été conçu pour le serveur Cobaltia et s’appuie sur sa charte graphique (cadres et glyphes du pack de ressources), mais il fonctionne aussi avec de simples annonces texte sans cadre.

Fonctionnalités

Annonces en JSON

Chaque annonce a un identifiant, un nom lisible, une ou plusieurs lignes MiniMessage (couleurs, dégradés, clic, survol) et un son facultatif.

Cadres centrés

Encadrez une annonce avec un haut et un bas décoratifs : le titre et chaque ligne sont centrés au pixel près dans la largeur du cadre.

Rotations automatiques

Envoyez une liste d’annonces à intervalle régulier, à la suite ou au hasard (jamais deux fois la même d’affilée), à tout le serveur, à un ou plusieurs mondes ou à une zone.

Annonces d’entrée de zone

Affichez une annonce au joueur qui entre dans une région WorldGuard ou dans un cube de coordonnées, avec un délai anti-répétition par joueur.

Menu en jeu

/annonces ouvre un menu : aperçu, envoi ciblé en deux clics, activation ou envoi immédiat des rotations, rechargement du fichier.

Rechargement sûr

Le fichier est entièrement validé au rechargement. À la moindre erreur, l’ancienne configuration reste en place et chaque erreur est indiquée avec son emplacement exact.

À quoi ressemble une annonce

Une annonce avec cadre se compose, de haut en bas, du haut du cadre, du titre centré, des lignes centrées et du bas du cadre :

╭──────────────────────────────╮
          ✦ ANNONCE ✦
   Vote pour le serveur avec /vote !
╰──────────────────────────────╯

Sans cadre, les lignes sont envoyées telles quelles, l’une sous l’autre.

Prérequis

Élément	Statut	Rôle
Paper 1.21.x	Obligatoire	Serveur cible du plugin.
Java 21	Obligatoire	Version d’exécution requise par Paper 1.21.
WorldGuard	Optionnel	Nécessaire pour les zones définies par une région WorldGuard. Les zones en cube fonctionnent sans.
PlaceholderAPI	Optionnel	Remplace les placeholders (`%player_name%`…) dans les lignes, pour chaque destinataire.
Nexo	Optionnel	Fournit les glyphes `<glyph:…>` utilisés par les cadres et le titre par défaut.

Pour aller plus loin

InstallationMettre le plugin en place et comprendre les fichiers créés.

Créer sa première annonceGuide pas à pas, de l’annonce à la rotation.

ConfigurationLe format complet de annonces.json.

Menu en jeuTous les écrans du menu /annonces.