LoraGuard

# LoraGuard > 🛡️ **Enterprise-grade AI chat moderation for Minecraft servers** LoraGuard is a comprehensive chat moderation solution powered by advanced AI technology. Designed for servers of all sizes, it provides real-time content moderation with minimal configuration and maximum effectiveness. --- ## 🎯 Why LoraGuard? | Feature | Benefit | |---------|---------| | **AI-Powered** | Understands context, not just keywords | | **19 Categories** | Comprehensive coverage of harmful content | | **Zero Config** | Works out of the box with free API key | | **Lightweight** | Optimized for performance with smart caching | | **Multilingual** | Turkish & English support | --- ## 🤖 AI Moderation Engine LoraGuard uses state-of-the-art language models to analyze chat messages in real-time. ### Detection Categories `hate` · `violence` · `sexual` · `self_harm` · `harassment` · `profanity` · `spam` · `scam` · `toxicity` · `bullying` · `cheating` · `doxxing` · `advertising` · `threats` · `discrimination` · `illegal` · `inappropriate_username` · `griefing` · `irl_trading` ### Available AI Models **Free Models:** - `gemini-2.5-flash-lite` (Google Gemini) - `grok-4-1-fast-reasoning` (xAI Grok) - `gpt-oss-120b` (OpenAI OSS) **Premium Models:** - Google Gemini: gemini-3-pro, gemini-2.5-pro - Anthropic Claude: claude-4.5-sonnet, claude-4.5-haiku - xAI Grok: grok-4-fast-reasoning - Meta Llama: llama-4-maverick, llama-4-scout --- ## 🛡️ Local Protection Filters In addition to AI moderation, LoraGuard includes powerful local filters: - **Anti-Spam** - Blocks repeated messages within configurable timeframe - **Anti-Flood** - Rate limits message frequency - **Caps Lock Filter** - Auto-lowercase or block excessive caps - **Link Filter** - URL blocking with domain whitelist - **IP Filter** - Prevents server IP sharing - **Custom Blacklist** - Your own blocked words with unicode normalization --- ## ⚖️ Intelligent Punishment System ### Escalating Punishments Configurable thresholds with progressive severity: ``` 1 violation → Warning 3 violations → Mute (10 minutes) 5 violations → Mute (1 hour) 7 violations → Kick 10 violations → Ban (1 day) 15 violations → Ban (7 days) 20 violations → Permanent Ban ``` ### Category Weights Different violation types carry different severity weights. Doxxing and illegal content are weighted higher than spam. ### Violation Decay Points automatically decrease over time, giving players a chance to reform. --- ## 🖥️ Administration ### GUI Admin Panel Full graphical interface for server administrators: - **Dashboard** - Real-time statistics and API status - **Player Management** - View, warn, mute, kick, ban players - **Violation Logs** - Searchable history with pagination - **Appeal Management** - Review and process player appeals ### Commands | Command | Description | |---------|-------------| | `/lg gui` | Open admin panel | | `/lg stats` | View statistics | | `/lg history <player>` | View player history | | `/lg mute/unmute <player>` | Mute management | | `/lg whitelist add/remove` | Bypass list | | `/lg toggle` | Enable/disable moderation | | `/lg reload` | Reload configuration | | `/report <player> <reason>` | Report a player | | `/appeal` | Player appeal system | | `/staffchat` | Private staff communication | | `/clearchat` | Clear server chat | --- ## 📋 Appeal System Players can appeal their punishments directly in-game: - Submit appeals with `/appeal create <mute|ban> <reason>` - Check status with `/appeal status` - Staff reviews through GUI or commands - Discord notifications for appeal updates --- ## 🔍 Extended Moderation LoraGuard monitors more than just chat: - **Signs** - Moderate text placed on signs - **Books** - Check written book content - **Anvils** - Monitor item renaming - **Command Spy** - Log player commands for staff review --- ## 🌐 Integrations ### Discord Webhook Real-time notifications to your Discord server: - Violation alerts with player info - Report submissions - Appeal status updates - Customizable embed colors ### PlaceholderAPI ``` %loraguard_violations% - Player's violation count %loraguard_status% - Moderation status ``` ### bStats Metrics Anonymous usage statistics to help us improve. --- ## 💾 Database Support - **SQLite** - Zero configuration, perfect for small servers - **MySQL** - Scalable solution for networks and large servers Stores: violation history, punishment logs, appeals, active mutes --- **Developed by Lora Technologies** 🚀