report system [ Plugins ] - Report Player System

[@LeX]

View File

Report Player System

---

🔹"> Nume: Report Players  (Sistem de tickete)
🔹"> Versiune: 1.6 - Open Source  
🔹"> Autor: Yvezzaint + Edit: @LeX 

 

 

---

 

 

🔹"> Module necesare  

• easy_http
• nvault
• regex
• json
   

 

---

 

 

🔹">📜"> Introducere  
Acest plugin a fost creat initial de Yvezzaint si editat de mine pentru a elimina dependenta de API-ul sau.

Puteti descarca pluginul original mai jos:

 

 

---

 

 

🔹">❓"> Ce face acest plugin?  
Acest plugin adauga un sistem de raportare a jucatorilor, oferind o metoda rapida si eficienta pentru jucatori de a raporta comportamente suspecte, incalcari ale regulilor sau alte probleme direct administratorilor.  

• Jucatorii pot raporta alti jucatori folosind comanda say /report
• Administratorii primesc notificari despre rapoarte in joc si pe Discord.
• Rapoartele sunt trimise catre un webhook Discord, permitand monitorizarea externa a plangerilor.
• Sistem de cooldown pentru a preveni abuzurile de raportare.
• Interfata meniului interactiva, permitand jucatorilor sa selecteze jucatorul si sa completeze motivul raportului.

 

 

---

 

 

🔹">🛠️"> Caracteristici principale  

• Meniu interactic de raportare – Jucatorii pot selecta un jucator din lista, specifica motivul raportului si marca raportul ca fiind urgent, daca este necesar.  
• Trimiterea automata a rapoartelor catre Discord – Rapoartele sunt trimise catre un webhook Discord, incluzand mai multe informatii de baza.
• Sistem de notificare pentru administratori – Administratorii online primesc notificari instantanee despre rapoartele trimise, permitand interventia rapida.  
• Sistem de cooldown pentru rapoarte – Un jucator nu poate trimite rapoarte repetate intr-un interval scurt de timp, prevenind abuzurile.  
• Filtrare si gestionare de rapoarte pentru administratori – Pluginul identifica administratorii online si ii afiseaza jucatorilor inainte de a trimite un raport, incurajand trimiterea de mesaje directe in loc de raportare.

 

 

---

 

 

🔹">🔧"> CVAR-uri importante si configurare  

report_webhook - URL-ul webhook-ului Discord unde sunt trimise rapoartele. Trebuie sa fie un URL valid pentru webhook-ul Discord.
report_image - URL-ul imaginii afisate in embed-ul Discord al raportului. Trebuie sa fie un URL valid pentru imagine.
report_advanced_cvar_check - Activeaza/dezactiveaza verificarea avansata. Valoarea pozitiva ( 1 - Implicit) permite verificarea avansata, Valoarenegativa sau 0 permite doar verificare standard.
report_admin_flags - Specifica flag-urile pe care un administrator trebuie sa le aiba pentru a primi notificari despre rapoarte. De exemplu, "d" pentru administratorii cu flag-ul "d".
report_min_flags - Numarul minim de flag-uri necesare pentru ca un jucator sa fie considerat administrator. De exemplu, "6" inseamna ca un jucator trebuie sa aiba cel putin 6 flag-uri pentru a fi considerat administrator.
report_admin_display - Numarul maxim de administratori afisati atunci cand un jucator incearca sa trimita un raport. De exemplu, "4" inseamna ca vor fi afisati pana la 4 administratori online.
report_cooldown - Perioada (in minute) dupa care un jucator poate trimite un alt raport. De exemplu, "30" inseamna ca un jucator trebuie sa astepte 30 de minute inainte de a trimite un nou raport.
report_admin_notify - Activeaza/dezactiveaza notificarea pentru administratori atunci cand un raport este trimis (1 = activat, 0 = dezactivat). De exemplu, "1" inseamna ca administratorii vor primi notificari.
report_display_image - Activeaza/dezactiveaza afisarea unei imagini in embed-ul Discord al raportului (1 = activat, 0 = dezactivat). De exemplu, "1" inseamna ca va fi afisata o imagine in embed-ul Discord.
report_display_footer - Activeaza/dezactiveaza afisarea unui footer in mesajul Discord (1 = activat, 0 = dezactivat). De exemplu, "1" inseamna ca va fi afisat un footer in mesajul Discord.
report_footer_type - Reprezinta tipul de footer in embend-ul reportului, 0 (implicit) va prelua dns-ul server-ului din numele server-ului / 1 se va folosi textul setat la cvar-ul 'report_footer_text'
report_footer_text - Seteaza textul footer din embedul report-ului
report_advanced_cvar_check - Activeaza/Dezactiveaza verificarea avansata 0 (implicit) verificare standard, 1 Verificare avansata (Get Request)

 

 

---

 

 

🔹">⚠️"> Configurare incorecta  
Daca pluginul nu este configurat corect, jucatorii vor primi un mesaj de eroare in joc, informandu-i ca pluginul nu este configurat corect si sa contacteze administratorul serverului.

De exemplu, daca URL-ul webhook-ului Discord nu este valid, pluginul va afisa un mesaj de eroare si nu va trimite raportul.

De asemenea se for afisa in consola serverului si mesaje informative despre acest lucru si ce nu a fost configurat corect

 

 

---

 

 

🔹">Alte Caracteristici  

Sistemul este capabil sa faca si o verificare avansata a valorilor cvar pentru 'report_webhook' cat si 'report_image'.
Aceasta verificare consta in anumiti factori ce pot influenta in anumite cazuri performanta dar este mai sigur.
Aceasta verificare consta in general prin trimiterea de GET Request catre link-urile setate in cvar.

• Verificare webhook Discord:
  • Daca Webhook ID este valid
  • Daca Token-ul este valid
  • La final poate determina daca ambele criterii sunt valide, daca acestea sunt valide, link-ul este valid
• Verificare URL imagine ( indisponibil momentan ) :
  • Daca se poate face o conexiune catre acel link
  • Daca returneaza fisier si daca acesta este o imagine
  • La final va determina daca link-ul este intradevar o imagine, si daca returneaza content de tip imagine (orice format de imagine)

 

Verificarea standard consta doar in verificarea string-ului link-urilor cat si verificarea prin regex daca link-ul de discord webhook respecta formatarea standard a acestuia
( Ex: https://discord.com/api/webhooks/ID_webhook/Token_webhook )

🔹">🖼️">Imagini  

Click pentru a vedea imagini

Configuratie Incorecta:


Meniu Report:

 

Non Urgent (fara @everyone) :


Urgent (cu @everyone) :


Cooldown:

 

 

---

 

 

🔹"> Concluzie  
Acest plugin ofera o solutie eficienta pentru gestionarea plangerilor.

Ofera o interfata usor de utilizat, notificari automate pentru administratori si o metoda rapida de raportare a problemelor.  
Integratia cu Discord permite gestionarea usoara a plangerilor si luarea masurilor necesare in timp real.

 

🔹"> Usor de folosit 🔹"> Personalizabil prin CVAR-uri 🔹"> Eficient pentru administratori

 

Change Log - Istoricul versiunilor

Change Log - Istoricul versiunilor

Versiunea 1.6

• Eliminat temporar: Verificarea avansata a link-urilor de imagini.
• Motiv: Link-urile de pe Imgur returneaza raspunsuri eronate din cauza masurilor anti-spam.
• Setare implicita: O imagine valida este deja inclusa în sursa pluginului.

 

Versiunea 1.5

• Adaugat: Validare avansata a URL-urilor
• Îmbunatatit: Sistemul de raportare pentru o performanta mai buna.
• Fix: Bug unde unele rapoarte nu erau trimise corect.

 

Versiunea 1.4

• Adaugat: Posibilitatea de a configura un footer custom.
• Optimizat: Notificarile pentru administratori.
• Fix: Probleme legate de cooldown-ul rapoartelor.

 

---

• Submitter
  @LeX
• Submitted
  02/09/2025
• Category
  Plugins