# 🗣️ Report

La commande /report permet aux joueurs de signaler des problèmes sur le serveur, qu'il s'agisse de problèmes liés à un joueur spécifique ou de problèmes généraux. Les administrateurs peuvent ensuite consulter, prendre en charge et gérer ces rapports via une interface graphique intuitive.

• Aucune permission requise - Tous les joueurs peuvent créer des rapports

• horizons.report.see - Permet de voir le GUI des rapports et de consulter tous les rapports
• horizons.report.delete - Permet de supprimer des rapports

Syntaxe: /report <joueur> <raison>

Description: Signale un joueur spécifique pour un problème

Paramètres:

• joueur - Nom du joueur à signaler (doit être en ligne)
• raison - Raison du signalement (peut contenir plusieurs mots)

Exemple:

/report Steve Il triche avec des mods

Syntaxe: /report <raison>

Description: Signale un problème général qui n'est pas lié à un joueur spécifique

Paramètres:

• raison - Description du problème (peut contenir plusieurs mots)

Exemple:

/report Le serveur lag beaucoup

Syntaxe: /report ou /report list

Description: Ouvre l'interface graphique pour consulter et gérer tous les rapports

Permission requise: horizons.report.see

Exemple:

/report
/report list

Le GUI des rapports affiche tous les rapports actifs avec les informations suivantes :

• Tête du joueur (pour les rapports de joueurs) ou Enclume (pour les rapports globaux)
• ID du rapport - Identifiant unique du rapport
• Joueur signalé - Nom du joueur signalé (si applicable)
• Type - Indique si c'est un rapport de joueur ou un problème global
• Raison - Raison du signalement
• Statut - Indique si le rapport est traité ou non
• Traité par - Nom de l'administrateur qui a pris en charge le rapport (si applicable)
• Date - Date et heure de création du rapport

• Si le rapport n'est pas encore traité, le prend en charge
• Change le statut du rapport à "traité"
• Enregistre votre nom comme celui qui a traité le rapport
• Envoie une notification à tous les autres administrateurs en ligne
• Envoie un webhook Discord (si configuré)

• Permission requise: horizons.report.delete
• Ouvre un GUI de confirmation pour supprimer le rapport
• Le GUI de confirmation affiche :
  • Bouton Confirmer (vert) - Supprime définitivement le rapport
  • Bouton Annuler (rouge) - Annule la suppression et retourne au GUI principal

Le GUI affiche jusqu'à 27 rapports par page. Les rapports sont triés par ID décroissant (les plus récents en premier).

Lorsqu'un joueur crée un rapport, tous les administrateurs en ligne avec la permission horizons.report.see reçoivent une notification dans le chat :

• Pour un rapport de joueur: [REPORT] Joueur a signalé AutreJoueur pour: raison (ID: #123)
• Pour un rapport global: [REPORT GLOBAL] Joueur a signalé un problème: raison (ID: #123)

Lorsqu'un administrateur prend en charge un rapport, tous les autres administrateurs en ligne sont notifiés :

[REPORTS] Le report #123 a été pris en charge par Administrateur

Le système de rapports peut envoyer des webhooks Discord pour notifier les administrateurs même lorsqu'ils ne sont pas en jeu.

Dans le fichier config.yml :

reports:
  webhook:
    enabled: true                # Activer ou désactiver les webhooks
    url: "https://discord.com/api/webhooks/..."  # URL du webhook Discord

• Couleur: Rouge (#FF0000)
• Titre: "Nouveau report de joueur"
• Contenu:
  • Joueur reporté
  • Par (auteur du rapport)
  • Raison
  • ID du rapport

• Couleur: Rouge (#FF0000)
• Titre: "Nouveau report global"
• Contenu:
  • Type: Problème global
  • Par (auteur du rapport)
  • Raison
  • ID du rapport

• Couleur: Vert (#00FF00)
• Titre: "Report pris en charge"
• Contenu:
  • Informations du rapport (joueur ou type global)
  • Par (auteur du rapport)
  • Raison
  • Traité par (administrateur)
  • ID du rapport

Tous les rapports sont automatiquement enregistrés dans des fichiers de logs séparés :

• Emplacement: plugins/Horizons/logs/reports/
• Format: Un fichier par action (création, prise en charge, suppression)
• Contenu: Horodatage, ID du rapport, type, joueur signalé (si applicable), auteur, raison, statut, traité par (si applicable)

Les fichiers de logs incluent :

• Création de rapports
• Prise en charge de rapports
• Suppression de rapports

La commande peut être activée ou désactivée dans le fichier config.yml :

commands:
  report:
    enabled: true  # Passer à false pour désactiver la commande report

reports:
  webhook:
    enabled: false                # Activer ou désactiver les webhooks Discord
    url: ""                       # URL du webhook Discord (laisser vide pour désactiver)

• ❌ Impossible de se signaler soi-même
• ❌ Le joueur signalé doit être en ligne (pour les rapports de joueurs)
• ✅ La raison est obligatoire

• /reports - Alias pour /report

Utilisez /report sans arguments pour ouvrir rapidement le GUI des rapports (en tant qu'admin)

Cliquez gauche sur un rapport non traité pour le prendre en charge instantanément

La suppression nécessite une confirmation pour éviter les erreurs

Configurez les webhooks pour être notifié même hors jeu

Consultez les logs dans plugins/Horizons/logs/reports/ pour un historique complet