Agency-Reports: Gerçekten Kullanılan FiveM Yönetici Raporlama Aracı

2026'da FiveM Reports'un Durumu

Çoğu sunucu oyuncu bildirimleri için hâlâ Discord biletlerini veya bir oyun içi sohbet komutunu kullanır. İkisi de yetersizdir. Discord'da oyuncu bağlamı yoktur; sohbet komutu ise bildiren oyuncu bağlantıyı kestiği an her şeyi kaybeder. Yöneticiler hakemlik yapmaları gerekirken dedektiflik yapmak zorunda kalır. Agency-Reports, kendi sunucumuzda yetkili olduğumuz dönemde var olmasını dilediğimiz araçtır.

Bağlam Otomatik Olarak Yakalandı

Bir oyuncu bir rapor ilettiğinde, koordinatlarını, yakındaki oyuncu ID'lerini, kuşanılan silahı, aracı ve son 60 saniyelik sohbet geçmişini otomatik olarak yakalarız. Yöneticiler yalnızca iddiayı değil, tüm olay anını görür. Yalnızca bu bile inceleme süresini yarı yarıya azaltır.

Akıllı Yönlendirme

Raporlar türe, önceliğe ve çevrimiçi yetkili durumuna göre ilgili ekibe yönlendirilir. Hile bildirimleri teknik yetkililere, RP anlaşmazlıkları RP yetkililerine, taciz ise görevdeki yetkiliye iletilir. Çevrimdışı raporlar sıraya alınır ve Discord üzerinden bildirim gönderir. Yetkili sohbetinde "bununla ilgilenen var mı?" sorularına son.

Çözüm Takibi

Her raporun bir durumu vardır: açık, üstlenildi, inceleniyor, çözüldü, kapatıldı. Yöneticiler, raporla birlikte sonsuza dek kalan çözüm notları yazar. Altı ay sonra aynı oyuncu başka bir rapor açtığında, geçmişi tek tık uzaktadır. Profesyonel moderasyon ekipleri MMO'larda bu şekilde çalışır, FiveM için gecikmiş bir durumdur.

Oyuncu Geri Bildirim Döngüsü

Bir rapor çözümlendiğinde, raporu ileten kişiye ne olduğunu açıklayan kısa bir mesaj gider. Yanıt "incelendi, işlem yapılması gerekmedi" olsa bile, oyuncular görmezden gelinmek yerine seslerinin duyulduğunu hisseder. Dinlendiğini hisseden topluluklar bağlı kalır, iyi denetim araçlarının arkasındaki asıl oyuncu tutma mekaniği de budur.

Kurulum & Yapılandırma

Agency-Reports, rapor geçmişinin kalıcılığı için oxmysql gerektirir. İçe aktarın reports.sql, resource klasörünü bırakın ve şunu ekleyin: ensure agency-reports kime server.cfg. Discord webhook'unuzu şuraya bağlayın: config.lua çevrimdışı uyarı iletme için. İlk başlatmada yönlendirme kuralları yapılandırmanızdan başlatılır, ek veritabanı kurulumu gerekmez.

Oyun içi raporlama arayüzü, oyuncular tarafından yapılandırılabilir bir tuş atamasıyla açılır (varsayılan: F9 veya bir sohbet komutu). Yönetici paneli ise yalnızca yönetici yetki bayraklarına sahip oyuncuların erişebileceği ayrı bir paneldir.

Yapılandırma Seçenekleri

The config.lua yönlendirmeyi, saklama süresini ve arayüz davranışını denetler:

• Rapor kategorileri, kategori başına yönlendirme kurallarıyla dilediğiniz kadar kategori tanımlayın (hile, taciz, RP anlaşmazlığı, hata bildirimi vb.).
• Personel yönlendirmesi, her kategori belirli yetki kademelerine yönlendirilir. Hile teknik yöneticilere, RP anlaşmazlıkları RP moderatörlerine vb.
• Otomatik yakalama listesi, hangi bağlam alanlarının otomatik olarak yakalanacağı (koordinatlar, yakındaki oyuncular, son 60 saniyelik sohbet, araç, silah). Alan bazında açıp kapatın.
• Discord webhook, Çevrimdışı rapor yönlendirmesi için URL. İlgili rotayla eşleşen çevrimiçi yetkili bulunmayan raporlar Discord'a iletilir.
• Çözüm mesajı şablonları, raporları kapatıldığında oyuncuların alacağı mesajı özelleştirin.
• Anonim ihbar, bildirimde bulunanların kimliklerini diğer oyunculara açıklamadan bildirim gönderip gönderemeyeceğini açıp kapatın (yöneticiler bildiren kişiyi her zaman görür).

Framework Uyumluluğu

Agency-Reports; QBCore, ESX ve standalone üzerinde çalışır. Framework ile temas eden tek bileşen, yönetici paneli erişimi için yapılan yetki kontrolüdür. Standalone kurulumlar için uygulayın Config.IsAdmin(src, level) config.lua içinde. Tüm rapor depolama, yönlendirme ve kullanıcı arayüzü framework'ten bağımsızdır.

Roleplay İçin Bu Neden Önemli

Çözümsüz kalan her oyuncu raporu bir güven kaybıdır. Bir oyuncu rapor oluşturup geri dönüş alamadığında, ya olayı kendi yöntemleriyle çözer (durumu tırmandırır) ya da sunucudan tamamen kopar. Agency-Reports, çözüm mesajı sistemi aracılığıyla bu geri bildirim döngüsünü kapatır: Sonuç umdukları gibi olmasa bile oyuncular raporlarının alındığını ve işleme konduğunu bilirler.

Bağlam yakalama sistemi, moderasyon için pratik bir güç çarpanıdır. Olaydan beş dakika sonra inceleme yapmak için sahneye gelen adminler tam bir durumsal bağlama sahip olur: herkesin nerede durduğu, ne konuşulduğu, suçlanan kişinin ne taşıdığı. Olayları yeniden canlandırmak yerine karar vermeye vakit ayırırlar. İnceleme süresindeki bu kısalma, bir admin ekibinin saat başına çözebileceği rapor sayısını doğrudan artırır.

Altı aylık geçmiş erişimi, toplulukları uzun vadede koruyan ve genellikle göz ardı edilen bir özelliktir. Rapor geçmişindeki aylar süren örüntü tanıma, kuralları açıkça değil yavaş yavaş ihlal eden oyuncuları yakalar: ayda üç rapor oluşturan ve kendisine karşı üç rapor bulunan, işlem eşiğinde sürekli gezinen ılımlı kural ihlalcileri. Geçmiş, bu örüntüyü görünür kılar.

Sıkça Sorulan Sorular

Oyuncular bir rapora ekran görüntüsü veya video kanıtı ekleyebilir mi?

Oyuncular, harici kanıtlara (Imgur, YouTube, Medal.tv) ait bir URL ekleyebilir. Güvenlik ve depolama nedenleriyle sunucuya doğrudan dosya yükleme desteklenmez. Discord bağlantılı raporlar, kolay inceleme için kanıt URL'sini Discord bildirimine dahil eder.

Bildiren oyuncu oyundan çıktığında raporlara ne olur?

Raporlar, oyuncunun bağlantı durumundan bağımsız olarak veritabanında saklanır. Rapor anında yakalanan tüm bağlam (koordinatlar, sohbet vb.) kaydedilir. Yetkililer, bildiren oyuncu ayrıldıktan sonra da raporları inceleyip çözüme kavuşturabilir ve çözüm mesajı oyuncunun bir sonraki girişinde iletilir.

Agency-Reports sistemini mevcut ticket botumuzla entegre edebilir miyiz?

Evet, Discord webhook yönlendirmesi yoluyla. Ticket botunuz bir Discord kanalından okuma yapıyorsa, webhook'u bu kanala yönlendirin, böylece raporlar botunuzun işleyebileceği Discord mesajları olarak görünür. Daha sıkı entegrasyon için resource, sunucu tarafında bir event tetikler: agency-reports:onNewReport herhangi bir sunucu tarafı scriptin dinleyebileceği.

Toplu rapor durumları için toplu kapatma özelliği var mı?

Evet. Yönetici paneli, rapor listesinde çoklu seçim içerir. Kıdemli yöneticiler birden fazla raporu seçebilir, tek bir çözüm notu uygulayabilir ve bunları toplu olarak kapatabilir. Aynı olay hakkında mükerrer raporlar oluşturan sunucu etkinliklerinden sonra kullanışlıdır.

Gereksinimler

• FiveM sunucusu (QBCore, ESX veya standalone)
• oxmysql
• geçerli Agency-Reports lisansına sahip cfx.re hesabı
• Discord webhook URL'si (çevrimdışı uyarılar için)

Agency-Reports ile Personel Oryantasyonu

Yeni moderatörler özellikle Agency-Reports'un yapılandırılmış iş akışından büyük fayda sağlar. Sistem, kapsamlı bir eğitim gerektirmeden onlara inceleme sürecinde rehberlik eder. İlk raporunu devralan yeni bir yetkili tüm bağlama otomatik olarak sahip olur, tek bir kelime yazmadan önce önceden toplanmış veriler soruların çoğunu yanıtladığından "ne oldu?" diye sormalarına gerek kalmaz.

Çözüm notu zorunluluğu (isteğe bağlıdır, ancak config üzerinden önerilir) bir eğitim aracıdır. Çözüm notu olarak "kayıtlar incelendi, oyuncu kural 3.2'yi açıkça ihlal ediyordu, 24 saat ban uygulandı" yazmak, moderatörü gerekçesini açıkça belirtmeye zorlar. Bu gerekçelendirme, zamanla karar kalitesini artırır ve üst yönetime bildirme veya itirazlar için yazılı bir kayıt oluşturur.

Discord taleplerine dayalı moderasyondan Agency-Reports sistemine geçen topluluklar için her iki sistemi iki ila dört hafta boyunca paralel çalıştırın. Çözüm süresini ve bildiren memnuniyetini takip ederken yetkililerin istediklerini kullanmalarına izin verin. Veriler genellikle Agency-Reports sisteminin talepleri daha hızlı çözdüğünü gösterir; geçişi zorunlu kılmak yerine gönüllü benimsemeyi teşvik etmek için bu verileri kullanın.