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 🚀