Installation

Installer le plugin

1. Vérifiez que le serveur tourne sous Paper 1.21.x avec Java 21.

2. Installez de préférence LuckPerms (hiérarchie du staff hors ligne, contextes) et PlaceholderAPI (placeholders). Les autres dépendances sont facultatives, voir la présentation.

3. Arrêtez le serveur, puis copiez CobaltStaff-1.0.0.jar dans le dossier plugins/.

4. Démarrez le serveur. Le plugin crée son dossier de configuration et sa base de données, puis active ses six modules.

5. Vérifiez l’installation en jeu ou depuis la console :

   /cobaltstaff version

   La réponse indique la version et la liste des modules actifs.

6. Donnez les permissions à votre équipe (voir Permissions), puis adaptez la configuration (voir Configuration).

Fichiers générés

Au premier démarrage, les fichiers par défaut sont extraits dans le dossier du plugin. Ils ne sont jamais écrasés ensuite : vos modifications sont conservées lors des mises à jour, et une clé absente reprend sa valeur par défaut.

• Répertoireplugins/CobaltStaff/

  • config.yml réglages généraux (langue, base, hiérarchie, modules…)
  • commands.yml commande d’administration /cobaltstaff
  • data.db base SQLite (mode WAL)
  • Répertoirecommands/ noms, alias et permissions des commandes de chaque module

    • sanctions.yml
    • reports.yml
    • staffmode.yml
    • investigation.yml
    • chat.yml
  • Répertoireconfig/ options de chaque module

    • sanctions.yml
    • reports.yml
    • staffmode.yml
    • investigation.yml
    • chat.yml
    • integration.yml
  • Répertoirelang/ textes FR et EN (MiniMessage)

    • fr.yml
    • en.yml
    • sanctions.fr.yml
    • …
  • Répertoirestaffmode/ modes et items du mode staff

    • modes.yml
    • modules.yml
    • custom-modules.yml
  • Répertoirebans/ modèles d’écran de ban

    • permanent.txt
    • temporaire.txt
    • ip-permanent.txt
    • ip-temporaire.txt
  • Répertoiretraces/ journaux de /trace (créé à la première trace)

    • …

Premiers réglages conseillés

Langue

Choisissez la langue des textes dans config.yml :

language: fr   # ou en
date-format: "dd/MM/yyyy HH:mm"
timezone: Europe/Paris

Hiérarchie

Déclarez les rangs de votre équipe, du plus bas au plus haut. Chaque rang correspond à la permission cobaltstaff.rank.<nom> :

ranks:
  - guide
  - moderateur
  - supermodo
  - responsable
  - admin

Un staff ne peut bannir, muter, kicker, warn, geler ou examiner qu’un joueur de rang strictement inférieur (ou sans rang).

Modules

Désactivez les modules dont vous n’avez pas besoin :

modules:
  sanctions: true
  reports: true
  staffmode: true
  investigation: true
  chat: true
  integration: true

Un module désactivé n’enregistre ni commandes, ni écouteurs, ni tâches.

Commandes existantes

Par défaut, CobaltStaff remplace les commandes homonymes d’autres plugins (/ban, /mute, /vanish…) :

commands:
  override-existing: true
  hide-vanished-in-tab: true

Passez override-existing à false pour laisser la priorité aux autres plugins.

Recharger la configuration

/cobaltstaff reload            recharge tout le plugin
/cobaltstaff reload chat       recharge un seul module

Attention

Le renommage d’une commande ou d’un alias dans commands.yml ou commands/*.yml demande un redémarrage du serveur. Les canaux du chat staff, eux, se rechargent avec /cobaltstaff reload chat.

Migrer depuis un autre plugin

• LiteBans : /cobaltstaff import litebans [gravité] lit la base décrite dans la configuration de LiteBans (H2, MySQL/MariaDB ou PostgreSQL) et importe bans, mutes, kicks et warns. La commande peut être relancée : les sanctions déjà importées sont ignorées. Les warns importés reçoivent la gravité indiquée (par défaut LEGER).
• Bans vanilla : /bans migrer et /ipbans migrer importent les bans et bans IP du serveur vanilla.

Voir Sanctions pour le détail.