Module Sanctions

Fichier : modules/sanction/config.yml

Le module Sanctions est un système de modération complet qui propose les bans, mutes, kicks, freezes, un historique des sanctions par joueur ainsi que les commandes de recherche /seen et /seenip. Il inclut des raisons par défaut configurables, une liste de joueurs protégés, des options d'affichage pour /seen et des icônes de matériaux personnalisables pour l'interface d'historique des sanctions.

Configuration SourceCopier le lien vers ce titre

enable: true

# List of nicknames that cannot be sanctioned, even if they do not have permission.
protections:
  - "Maxlego08"
  - "Notch"

# Default reason for /kick
kick-default-reason: "You have been kicked"

# Default reason for /mute
ban-default-reason: "The ban hammer has spoken"

# Default reason for /ban
mute-default-reason: "You have to turn your tongue 7 times before speaking"

# Default reason for /unmute
unmute-default-reason: "You have the right to talk to us"

# Default reason for /unban
unban-default-reason: "The ban hammer gives you the right to return"

# Date format used for sanctions
date-format: "yyyy-MM-dd HH:mm:ss"

# Settings of the /seen command.
# Each line can be disabled globally here, even for operators.
# The permissions below are still required when the option is enabled.

# Show the UUID of the player
seen-show-uuid: true

# Show the IP addresses used by the player
# Requires the permission essentials.seen.show.ip
# Set this to false if you never want the IP to be displayed, even to an operator
seen-show-ip: true

# Show the last known location of the player
# Requires the permission essentials.seen.show.last.location
seen-show-last-location: true

# Show the date of the first connection of the player
# Requires the permission essentials.seen.show.created.at
seen-show-created-at: true

# Show the total playtime of the player
seen-show-playtime: true

# Materials are used for sanction_history inventory

# Material used for kicks
kick-material: IRON_INGOT

# Material used for ban
ban-material: DIAMOND

# Material used for mute
mute-material: EMERALD

# Material used for unban
unban-material: IRON_INGOT

# Material used for unmute
unmute-material: COPPER_INGOT

# Material used for warn
warn-material: COAL

# Material used for freeze
freeze-material: ICE

# Material used for mute if it is active
current-mute-material: EMERALD_BLOCK

# Material used for ban if it is active
current-ban-material: DIAMOND_BLOCK

OptionsCopier le lien vers ce titre

Options GénéralesCopier le lien vers ce titre

Raisons par DéfautCopier le lien vers ce titre

La raison par défaut est utilisée lorsque le modérateur ne précise pas de raison dans la commande.

Options d'affichage de /seenCopier le lien vers ce titre

Chaque ligne de /seen peut être désactivée globalement. Lorsqu'une option est activée, la permission associée (s'il y en a une) reste nécessaire.

Icônes de MatériauxCopier le lien vers ce titre

Ces matériaux servent d'icônes dans l'interface d'historique des sanctions pour distinguer visuellement les différents types de sanctions.

FonctionnementCopier le lien vers ce titre

1. Un modérateur exécute une commande de sanction (par exemple /ban, /mute, /kick, /freeze).
2. Le plugin vérifie si le joueur ciblé figure dans la liste protections. Si c'est le cas, l'action est refusée.
3. La sanction est appliquée au joueur ciblé et enregistrée dans la base de données avec la date, la raison et l'auteur.
4. Si aucune raison n'est fournie, la raison par défaut correspondante est utilisée.
5. Les membres du staff ayant la permission notify correspondante reçoivent une notification.
6. Les modérateurs peuvent consulter l'historique complet d'un joueur avec /sanction <joueur>, qui ouvre une interface avec des entrées identifiées par leur matériau.

Commandes AssociéesCopier le lien vers ce titre

Permissions SupplémentairesCopier le lien vers ce titre

Pour la liste complète des commandes, consultez Commandes & Permissions.

Placeholders AssociésCopier le lien vers ce titre

Pour la liste complète des placeholders, consultez Placeholders.

Joueurs ProtégésCopier le lien vers ce titre

La liste protections empêche certains joueurs d'être sanctionnés par n'importe quel modérateur, y compris ceux qui possèdent toutes les permissions. C'est utile pour protéger les propriétaires du serveur ou des comptes système contre des sanctions accidentelles ou malveillantes.

protections:
  - "Maxlego08"
  - "Notch"

Exemple : /seen respectueux de la vie privéeCopier le lien vers ce titre

seen-show-uuid: true
seen-show-ip: false
seen-show-last-location: false
seen-show-created-at: true
seen-show-playtime: true

/seen n'affiche jamais les adresses IP ni la dernière position, même aux opérateurs, mais affiche toujours l'UUID, la date de première connexion et le temps de jeu.