DiscordSocialSpy Remastered – Async Command Logger

EN
DiscordSocialSpy – Async Event & Command Logger
A high-performance, fully asynchronous Discord command logging and filtering system for Paper 1.20+ and Java 21.

This plugin forwards selected private commands (such as /msg, /tell, /w), sign placements/edits, and filters regular chat to a Discord channel via webhook — without impacting the main server thread.
Ideal for staff teams who need real-time monitoring, anti-ad, and anti-swear capabilities while keeping the server safe and completely lag-free.

Features
Fully Asynchronous
All processing (queue, dispatch, retries) runs off the main server thread.
Zero TPS drop, even under incredibly heavy load.

Advanced Content Filtering (Anti-Swear & Anti-Ad)
Filter commands, signs, and regular chat all at once!
Supports Regex (for blocking IPs and Domains) and Plain Text exact word blocking.
Blocked messages are cancelled in-game, and "Blocked Alerts" are sent directly to your Discord!
Discord prefixes like [BLOCKED] and [BLOCKED CHAT] are fully customizable via language files.

Sign Logging & In-Game Notifications
Captures all text written on signs and logs them to Discord.
Staff members can enable in-game notifications for sign placements and click the chat message to instantly teleport to the sign's location!

Exact Command Matching
Only exact registered commands are logged.
Example:

Command Logged?
/w Yes
/w Hi Yes
/whisper No
/warp No
Fixes false positives from prefix-matching plugins.

Anti-Spam Protection
Prevents spam from flooding your Discord logs:

Detects repeated identical messages
Stops logging after 3 repeats
Only one warning per player
Warning text is fully editable via lang files

Language System
Two language files included: en.yml and tr.yml.

Features:
Auto-load based on config language: en
Auto-repair damaged language files
Safe fallback to EN if invalid
Fully configurable text messages and discord prefixes

Async Tab Completion
Command suggestions are now cached asynchronously:
Faster tab complete
No main thread blocking
Shows “loading…” while cache builds

Customizable Command Filters
Choose exactly which commands to log:

logged-commands:
- msg
- tell
- w

Permission-Based Exclusion
Players with this permission bypass logging:

exclude-permission: "discordspy.bypass"

Safe Webhook Handling
Security-focused design:
Webhook URL never exposed to players
JSON escape protection
allowed_mentions disabled to prevent @everyone ping abuse
No reflective invocation
Fully async processing

Installation
Download the plugin
Place it in /plugins/
Restart the server
Edit config.yml
Run:
/discordsocialspy reload

Commands
Command Description
/discordsocialspy reload - Reloads configuration & language files
/dss cmd add/remove - <command> - Adds/removes the command you want to log.

Requirements
Paper 1.20+
Java 21
(Paper recommended due to async scheduler compatibility)

TR
DiscordSocialSpy – Asenkron Komut & Olay Günlükleyici
Paper 1.20+ ve Java 21 uyumlu, tamamen asenkron ve yüksek performanslı Discord komut loglama ve filtreleme sistemi.

Seçtiğiniz komutların (örn: /msg, /tell, /w) içeriklerini, sunucudaki tabelaları ve genel sohbeti Discord’a güvenli şekilde iletir.
Tüm işlemler asenkron olduğundan sunucuyu asla kasmaz ve TPS düşürmez. Yetkili ekibiniz için mükemmel bir koruma ve loglama aracıdır!

Özellikler
Tam Asenkron İşleme
Kuyruk, gönderim ve retry mekanizması tamamen main thread dışında çalışır.

Gelişmiş İçerik Filtreleme (Anti-Küfür ve Anti-Reklam)
Komutları, tabelaları ve genel sohbeti aynı anda güçlü bir filtre testinden geçirin!
IP veya sunucu adresleri için Regex desteği; küfürler veya istenmeyen kelimeler için Düz Metin kelime engelleme seçeneği sunar.
Tespit edilen ihlaller oyunda engellenir ve anında Discord sunucunuza [BLOCKED] uyarısı ile loglanır!
Discord'a atılan bu "[BLOCKED]" başlığını dil dosyalarınızdan dilediğinizce tasarlayabilirsiniz.

Tabela Loglama & Sunucu İçi Bildirimler
Oyuncuların koyduğu veya düzenlediği tüm tabelaları Discord'a gönderir.
Aktif yetkililer oyun içindeyken tabela konulduğu an sohbete bir bıldırım alır, bildirime tıklayarak anında tabelanın olduğu koordinata ışınlanabilir!

Kesin Komut Eşleşmesi
Artık yalnızca tam eşleşen komutlar loglanır.

Komut Loglanır mı?
/w
/w Merhaba
/whisper
/warp

Spam Koruması
Aynı komutu 3 kez tekrar eden oyuncu Discord'da spam yaratmaz:
Loglanmaz
Konsola sadece 1 kez uyarı düşer
Uyarı metni lang dosyasından düzenlenebilir

Dil Sistemi
en.yml ve tr.yml dil dosyaları kurulu gelir.
language: tr ile tek satırdan seçilebilir
Bozuk dil dosyalarını otomatik onarır
EN diline güvenli şekilde düşer (çökmez)

Asenkron Tab-Complete
Komut önerileri ve liste tamamlamaları arka planda hazırlanır ve main threadi bloklamaz.

Loglanacak Komutları Belirleme
logged-commands:
- msg
- tell
- w

Yetki ile Hariç Tutma
exclude-permission: "discordspy.bypass" iznine sahip kişiler loglanmaz ve filtrelere yakalanmaz.

Güvenli Webhook İşleme
Webhook URL asla oyunculara görünmez
JSON escape koruması vardır
allowed_mentions kapalıdır (everyone ping'i atılarak sunucu patlatılamaz)
Dosya/RCE (Uzaktan Kod Çalıştırma) riski yoktur
HTTP istekleri tam asenkrondur

Config Örneği
############################################################
# DISCORD SOCIAL SPY #
############################################################

# ----------------------------------------------------------
# Language / Dil
# ----------------------------------------------------------
# TR: Pluginin kullanacağı dil dosyası.
# en = İngilizce
# tr = Türkçe
# Bu ayarı değiştirdikten sonra /discordsocialspy reload yapın.
#
# EN: Language file used by the plugin.
# en = English
# tr = Turkish
# Run /discordsocialspy reload after changing this setting.
language: "en"

# ----------------------------------------------------------
# Webhook URL
# ----------------------------------------------------------
# TR: Discord webhook URL’nizi buraya yazın.
# Geçerli bir webhook adresi olmadan mesajlar gönderilemez.
#
# EN: Put your Discord webhook URL here.
# Messages will not send if this value is empty.
webhook: "PUT_YOUR_DISCORD_WEBHOOK_URL_HERE"

# ----------------------------------------------------------
# Username Override
# ----------------------------------------------------------
# TR: Discord’da gözükecek kullanıcı adını belirler.
# Boş bırakılırsa Discord varsayılan kullanıcı adını kullanır.
#
# EN: Username displayed in Discord messages.
# If left empty, Discord will use its default name.
username: "SocialSpy"

# ----------------------------------------------------------
# Avatar URL
# ----------------------------------------------------------
# TR: Discord’da mesaj atan kullanıcının avatar URL'si.
# PNG, JPG ve GIF desteklenir.
#
# EN: URL of the avatar shown in Discord messages.
# Accepts PNG, JPG, GIF.
avatar_url: " https://www.spigotmc.org/data/resource_icons/131/131648.jpg"

# ----------------------------------------------------------
# Prefix
# ----------------------------------------------------------
# TR: Her mesajın başına eklenen bir metin.
# Örnek: [Spy] Oyuncu1: /msg Oyuncu2 Merhaba
#
# EN: Prefix added to every logged message.
# Example: [Spy] Player1: /msg Player2 Hello
prefix: "[Spy] "
message-prefix: "[DSS] "
sign-prefix: "[Sign] "

# ----------------------------------------------------------
# Sign Webhook
# ----------------------------------------------------------
# Opsiyonel: Sadece tabelaların düşeceği farklı bir Discord kanalı webhook.
sign-webhook: ""

############################################################
# COMMAND FILTERING #
############################################################

# ----------------------------------------------------------
# Logged Commands
# ----------------------------------------------------------
# TR: Discord’a gönderilecek komutları listeleyin.
# Sadece listedeki komutlar loglanır (/msg, /tell, /w vb.)
# Örneğin oyuncu /msg yazarsa Discord'a gönderilir.
#
# EN: Commands to capture and send to Discord.
# Only commands listed here will be logged (/msg, /tell, /w etc.)
# For example, /msg executed by a player will be logged.
logged-commands:
- msg
- tell
- w

# ----------------------------------------------------------
# Excluded Permission
# ----------------------------------------------------------
# TR: Bu izne sahip oyuncular loglanmaz.
# Moderatörler veya yöneticiler için bypass izni olarak kullanılır.
#
# EN: Players with this permission will NOT be logged.
# Useful for staff members or admins.
exclude-permission: "discordspy.bypass"

############################################################
# FILTER SETTINGS #
############################################################

filter:
enabled: true
check-chat: true
regex:
- "(?i)\\b(?:mc|play|oyna|craft)\\.[a-z0-9-]+\\.(?:com|net|org|tc|xyz|me)\\b"
- "\\b(?:[0-9]{1,3}\\.){3}[0-9]{1,3}(?::[0-9]{1,5})?\\b"
words:
- "aternos"
- "oyna."
- "play."
- "mc."
- "craft."
- ":255"

############################################################
# ASYNC SETTINGS #
############################################################

async:
# --------------------------------------------------------
# Sender Threads
# --------------------------------------------------------
# TR: Discord’a mesaj göndermek için kullanılan thread sayısı.
# -1: Sunucu CPU çekirdeklerinin yarısını kullanır.
# Çok yüksek değer sunucu CPU kullanımını artırabilir.
#
# EN: Number of threads used for sending messages to Discord.
# -1: Uses half of available CPU cores.
# Setting too high can increase CPU usage.
sender_threads: -1

# --------------------------------------------------------
# Dispatcher Threads
# --------------------------------------------------------
# TR: Kuyruğu işleyen thread sayısı.
# Bu değer message kuyruk hızını belirler.
#
# EN: Number of threads used to process the message queue.
# Controls how fast queued messages are sent out.
dispatcher_threads: -1

# --------------------------------------------------------
# Queue Size
# --------------------------------------------------------
# TR: Henüz gönderilmemiş mesajların maksimum sayısı.
# Sunucu çok fazla komut loglarsa kuyruğun dolmasını engeller.
#
# EN: Maximum number of queued messages not yet sent.
# Prevents memory overload on very busy servers.
queue_size: 5000

# --------------------------------------------------------
# Maximum Retries
# --------------------------------------------------------
# TR: Discord mesaj gönderimi başarısız olursa kaç kez tekrar denensin?
# 0 = tekrar yok
# 3 = önerilen değer
#
# EN: Number of times to retry sending after failure.
# 0 = no retry
# 3 = recommended
max_retries: 3

# --------------------------------------------------------
# Retry Interval
# --------------------------------------------------------
# TR: Retry denemeleri arasında beklenecek saniye miktarı.
# EN: Seconds to wait between retry attempts.
retry_interval: 2

# --------------------------------------------------------
# Rate Limit Wait Time
# --------------------------------------------------------
# TR: Discord 429 rate-limit hatası verdiğinde kaç saniye beklenmeli?
# Discord genellikle 2–5 saniye ister.
#
# EN: Seconds to wait after Discord rate-limit error (429).
# Discord usually needs 2–5 seconds.
rate_limit_wait: 3

############################################################
# SIGN LOGGING #
############################################################

log-signs: true
log-signs-to-console: false
sign-notify: false

############################################################
# DEBUG SETTINGS #
############################################################

# ----------------------------------------------------------
# Debug Mode
# ----------------------------------------------------------
# TR: Debug modu aktifken plugin her HTTP isteğini ve yanıtını konsola yazar.
# Hataları tespit etmek için kullanışlıdır fakat normal kullanımda kapalı tutun.
#
# EN: When enabled, the plugin logs all HTTP requests and responses.
# Useful for debugging but should be off in production.
debug: false

Kurulum
Plugin’i indir
/plugins/ klasörüne ekle
Sunucuyu başlat
config.yml dosyasını kendi Webhook'unuza göre düzenleyin
Oyunda, /discordsocialspy reload çalıştırın.

Komutlar
Komut Açıklama
/dss reload - Ayarları ve dil dosyalarını yeniler.
/dss cmd add/remove - <komut> - Loglanmasını istediğin komutu hızlıca ekler/kaldırır.

Gereksinimler
Paper 1.20+
Java 21
(Asenkron API gereksinimi nedeniyle Paper önerilir)