Installation

Mise en place

1. Arrêtez le serveur.

2. Copiez CobaltiaAnnonces.jar dans le dossier plugins/ du serveur.

3. Ajoutez, si vous en avez besoin, les plugins optionnels : WorldGuard (zones par région), PlaceholderAPI (placeholders dans les annonces) et Nexo (glyphes des cadres). Ils sont déclarés en dépendances douces : CobaltiaAnnonces se charge après eux s’ils sont présents, et fonctionne sans eux.

4. Démarrez le serveur. Le dossier plugins/CobaltiaAnnonces/ est créé avec un fichier annonces.json d’exemple.

5. Vérifiez la console : si le fichier contient une erreur, le plugin l’indique au démarrage (voir ci-dessous).

6. Modifiez annonces.json, puis appliquez vos changements en jeu avec /annonces reload, sans redémarrer.

Fichiers du plugin

Fichier	Rôle
annonces.json	Toute la configuration : titre, cadres, annonces, zones, rotations et entrées. Créé une seule fois ; il n’est jamais écrasé ensuite.
etat.json	État allumé ou coupé de chaque rotation. Écrit par le plugin au rechargement, à chaque bascule d’une rotation et à l’arrêt du serveur. Vous n’avez pas à le modifier.

Le fichier d’exemple contient deux cadres (simple et simple_petit), deux annonces de test, deux zones d’exemple (spawn par région WorldGuard, exemple_cube par coordonnées), deux rotations coupées et une entrée de zone. Rien n’est donc diffusé automatiquement tant que vous n’avez pas activé une rotation.

Fichier invalide au démarrage

Si annonces.json contient une erreur au démarrage, le plugin se charge sans aucune annonce et liste chaque erreur dans la console (annonces.json invalide (N erreur(s)), plugin sans annonces). Corrigez le fichier puis lancez /annonces reload.

Comportement sans les dépendances optionnelles

• Sans WorldGuard : les zones de type région ne contiennent jamais aucun joueur. Les rotations ciblées sur elles ne touchent personne et leurs entrées ne se déclenchent pas. Les zones en cube ne sont pas concernées.
• Sans PlaceholderAPI : les placeholders %…% restent affichés tels quels.
• Sans Nexo : les balises <glyph:…> ne sont pas converties en glyphes. Utilisez dans ce cas des annonces sans cadre, ou des cadres et un titre écrits en texte MiniMessage.

Étape suivante : créer sa première annonce