Installation

Avant de commencer

Il vous faut	Version
Spigot	`1.8.8`
Java	`21`
PacketEvents	`2.12.0` ou plus récent

PacketEvents est obligatoire. SomaPace lit les paquets de minage envoyés par le client pour savoir où en est réellement un cassage, et sans lui le serveur refuse d’activer le plugin.

Installer

Déposez le jar.

Placez SomaPace.jar dans le dossier plugins/ de votre serveur, à côté de PacketEvents.
Démarrez le serveur une fois.

SomaPace crée plugins/SomaPace/config.yml. Les réglages livrés sont probablement déjà ceux que vous voulez : refuser le FastBreak, journaliser chaque refus, aucun webhook Discord.
Vérifiez qu’il a bien démarré.
```
/sp alerts
```
Il répond que vos alertes sont désormais désactivées ou activées. Cette réponse suffit à prouver que le plugin s’est activé et que la commande est enregistrée. Relancez-la pour revenir à votre réglage d’origine.

Ce qu’il fait avec les réglages d’origine

Réglage	Valeur	Effet
`cancel-breaks`	`true`	Un cassage qui arrive trop tôt est refusé et le bloc est remis en place.
`log-to-file`	`true`	Chaque refus est ajouté à `flags.log`.
`webhook.enabled`	`false`	Rien n’est envoyé sur Discord.

Le staff qui possède soma.pace.alerts reçoit en plus une alerte dans le chat, activée par défaut pour lui.

Une installation neuve protège donc déjà votre serveur. Il n’y a rien à configurer pour cela.

Observer avant d’appliquer

Sur un serveur en production, il vaut la peine de faire tourner SomaPace en observation pendant quelques jours, pour voir ce qu’il attrape avant qu’il ne commence à refuser des cassages :

cancel-breaks: false

Les signalements continuent d’être levés, journalisés et transmis au staff, mais le bloc casse normalement. Lisez flags.log au bout d’un jour ou deux, vérifiez que ce qu’il a attrapé correspond bien à ce que vous pensez, puis repassez le réglage à true.

Les fichiers créés

Fichier	Ce que c’est
`config.yml`	L’application, la journalisation et le webhook Discord.
`flags.log`	Une ligne par cassage refusé, quand `log-to-file` est activé.
`states.yml`	Les membres du staff qui ont coupé leurs alertes. Écrit par le plugin, laissez-le tranquille.

Après avoir modifié config.yml, appliquez vos changements avec :

/sp reload