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 | |---------|---------| | Multilingual | Understands context, not just keywords | | Multilingual | Comprehensive coverage of harmful content | | Multilingual | Works out of the box with free API key | | Multilingual | 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:

- Custom Blacklist - Blocks repeated messages within configurable timeframe - Custom Blacklist - Rate limits message frequency - Custom Blacklist - Auto-lowercase or block excessive caps - Custom Blacklist - URL blocking with domain whitelist - Custom Blacklist - 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: - Appeal Management - Real-time statistics and API status - Appeal Management - View, warn, mute, kick, ban players - Appeal Management - 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: - Command Spy - Moderate text placed on signs - Command Spy - Check written book content - Command Spy - 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

- MySQL - 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 🚀