yaddu guard

YadduGuard is an advanced AI-powered chat moderation plugin for Velocity proxy servers. It uses cutting-edge AI models to detect toxic messages, Hindi/Hinglish gaaliyan, English abuses, harassment, and hate speech in real-time — and automatically punishes offenders with escalating consequences.

🤖 AI Providers Supported

Groq (LLaMA 3.3 70B) — Free, ultra-fast
Google Gemini 2.0 Flash — Free tier available
OpenAI GPT-4o Mini — Premium option
Auto-fallback: if one provider fails, automatically switches to next

🛡️ How It Works

Every chat message passes through a 3-layer system:
QuickFilter — 200+ normalized gaali patterns checked instantly (no API call)
Message Cache — repeated toxic messages blocked from cache (no API call)
AI Check — only suspicious messages sent to AI for deep analysis
This means minimal API usage while maximum detection accuracy.

⚖️ Escalating Punishments

Severity 3-4 → Soft Mute (5 minutes)
Severity 5-6 → Kick
Severity 7-8 → Temp Ban
Severity 9-10 → IP Ban
3+ violations in a session → automatic escalation

🔍 Smart Detection

Understands context — "mc" alone is fine, "mc tu" is toxic
Detects leet speak — b s d k, bh0$d1k, b.s.d.k all caught
Hindi, Hinglish, and English detection
Works across all backend servers simultaneously

⚙️ Admin Commands

/yg status — View plugin status

/yg reload — Reload config live

/yg test — Test AI on any message

/yg unmute — Remove soft mute

/yg violations — View player history