Sueta

⭐️ Darik Chat Manager ⭐️ AI-Powered Chat Moderation ⭐️ GEMIN

1.1

Powerful chat moderation plugin that uses Gemini AI

·Plugin

Darik Chat Manager
Advanced Chat Management with AI-Powered Moderation




Darik Chat Manager is a powerful chat moderation plugin that combines traditional word filtering with cutting-edge AI technology using Google's Gemini AI to provide intelligent, context-aware chat moderation.

System Demonstration

  • AI Moderation in Action:



  • GUI Overview:

✨ Key Features

  • AI-Powered Moderation: Advanced content filtering with Google’s Gemini AI.

  • Multi-Language Support: Supports English, Spanish, German, French, Italian, and Portuguese.

  • Smart Pattern Learning System: Adapts to new patterns and reduces false positives.

  • Interactive GUI Management: Simplified configuration and monitoring.

  • ⚡ Real-Time Chat Analysis: Process messages instantly for secure interactions.

  • ️ Advanced Word Filtering: Efficient detection of harmful content.

  • ✍️ Detailed Logging System: Comprehensive record of flagged messages and moderation actions.

Commands

commands
  • /dcm reload - Reload plugin configuration.

  • /dcm add <word> - Add a forbidden word/pattern.

  • /dcm remove <word> - Remove a forbidden word/pattern.

  • /dcm stats - View moderation statistics.

  • /dcm gui - Open the management GUI.

Permissions

permissions
  • darikchatmanager.admin - Access to all commands.

  • darikchatmanager.bypass - Bypass chat moderation.

  • darikchatmanager.notify - Receive notifications about detected content.

GUI Interface

The plugin features an intuitive GUI with three main sections:

  1. Top Offenders: Players with the most violations.

  2. Most Detected Patterns: Commonly flagged content.

  3. Auto-Learning System: AI-detected patterns pending review.

Setting Up AI Moderation

  1. Visit Google MakerSuite.
  2. Create a new free API key.
  3. Add the key to your config.yml.
  4. Reload the plugin using /dcm reload or reload the server.

Features in Detail

AI-Powered Analysis

Spoiler
  • Context-aware content moderation.

  • Multi-language support.

  • Automatic pattern learning.

  • False positive reduction.

  • Real-time message processing.

Pattern Learning System

Spoiler
  • Automatically detects new inappropriate patterns.

  • Stores example messages for context.

  • Tracks detection frequency.

  • Staff review system via GUI.

Moderation Actions

Spoiler
  • Customizable warning messages.

  • Automatic muting system.

  • Custom command execution.

  • Staff notifications.

Performance

Spoiler
  • Lightweight and optimized.

  • Async message processing.

  • Minimal impact on server performance.

  • Efficient pattern matching.

Requirements

  • Java 21 or higher.

  • Gemini AI API key (for AI features).

Support & Documentation

Installation

  1. Stop your server.

  2. Place the plugin in your plugins folder.

  3. Start the server.

  4. Configure your settings in config.yml.

  5. Reload the plugin or your server.

Common Issues

  • AI not working: Check if your API key is correctly configured, enable debug and restart your server.

  • Commands not working: Verify permissions.

  • Performance issues: Enable debug mode for detailed logs.

Future Updates

  • Enhanced pattern detection.

  • Additional AI models. Done! (All Gemini models)

  • Analytics dashboard.

Contextual Analysis System

The AI analyzes messages considering their context and distinguishes between:

✅ Safe Messages (Not Flagged)

  • Reporting hackers/cheaters.

  • Bug reports.

  • General game discussions.

  • Questions about game mechanics.

❌ Inappropriate Messages (Flagged)

  • Promoting cheats/hacks.

  • Seeking exploits.

  • Attempting to bypass filters.

  • Harmful behavior.
Examples

Examples:
Safe Messages:
- "please ban that hacker"
- "I found a bug in the game"
- "how to report hackers?"
- "someone is using cheats"

Flagged Messages:
- "anyone knows good hacks?"
- "I will use hacks to win"
- "selling ch3ats dm me"
- "looking for exp1oits"

Smart Detection Features

  1. Context Understanding: Differentiates between reporting and promoting harmful content.

  2. Multi-Language Support: Works in any language.

  3. Pattern Learning: Adapts to new bypass attempts.

  4. False Positive Reduction: Understands game-related terminology.

  5. Real-Time Analysis: Immediate response to messages.

Smart Pattern Matching System
The plugin employs an intelligent pattern matching system that only flags messages for review when they match previously identified suspicious patterns with a similarity score of at least 0.75 (you can add patterns manually on config.yml or use /dcm add <word>). Messages that do not meet this threshold are not sent for review, ensuring efficient and focused moderation. The system is capable of detecting sophisticated attempts to bypass filters, such as variations like 'haaaaaaaaaacker,' 'h4cker,' or 'h4///cker,' making it robust against creative evasion tactics.

Moderation Mode Selection
DarikChatManager features two distinct moderation modes:

  • AI-Powered System: Sophisticated content analysis with Gemini AI.

  • Traditional Filtering: Efficient word and pattern matching.

These modes operate exclusively, ensuring optimal performance a can switch between modes in the configuration file based on specific needs and server resources.

️ Configuration Files

config.yml
##############################################################
#                                                            #
#    ██████╗  █████╗ ██████╗ ██╗██╗  ██╗                     #
#    ██╔══██╗██╔══██╗██╔══██╗██║██║ ██╔╝                     #
#    ██║  ██║███████║██████╔╝██║█████╔╝                      #
#    ██║  ██║██╔══██║██╔══██╗██║██╔═██╗                      # 
#    ██████╔╝██║  ██║██║  ██║██║██║  ██╗                     #
#    ╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝╚═╝  ╚═╝                     #
#                                                            #
#                  Chat Manager                              #
#                                                            #
#           Advanced Chat Control System                     #
#              NOW WITH GEMINI AI                            #
#                                                            #
##############################################################

#====================#
#   Main Settings    #
#====================#
# Enable or disable the chat censoring system
censor-enabled: true
# Plugin language (en, es, de, fr, it, pt)
language: en
# Defines the suffix format for chat messages.
# Supports Minecraft color codes.
message-sufix: "&f: "

#=========================#
#   Advanced Detection    #
#=========================#
advanced:
  # Maximum number of inappropriate message attempts before taking action
  max-attempts: 3
  # Actions to take when max attempts are reached
  max-attempts-actions:
    # Built-in mute system
    mute:
      # Enable automatic muting (Note: message will always be in English)
      enabled: false
      # Mute duration in seconds (3600 = 1 hour)
      duration: 3600
    # Custom command execution
    command:
      # Enable command execution on max attempts
      enabled: true
      # Command to execute. Available placeholders: {player}
      command: "mute {player} 1h Exceeding inappropriate message attempt limit"
  # Show warning messages to players when inappropriate content is detected
  warn-players: true

#======================#
#   GUI Management    #
#======================#
gui-settings:
  # Number of items to display per page in GUIs
  items-per-page: 28
  # How often to refresh GUI data (in seconds)
  refresh-interval: 30
  # Automatically remove old entries from history
  auto-purge-old: true
  # How many days to keep history before purging
  history-days: 30
  # Color for highlighted items in GUI (uses & color codes)
  highlight-color: "&6"
  # Number of infractions before highlighting a player in the GUI
  warning-threshold: 5

#======================#
#   Word Blacklist     #
#======================#
# List of words or patterns to block
# You can add more patterns following the same format
forbidden-patterns:
  - badword
  - hack
  - cheat
  - exploit

#=================================#
#   Artificial Intelligence AI    #
#=================================#
# The AI system uses Google's Gemini AI to:
# - Detect context-aware inappropriate content
# - Understand multiple languages automatically
# - Learn new patterns from detected violations
# - Adapt to new ways players try to bypass
# - Reduce false positives with smart detection
#
ai-settings:
  # Your Gemini API key (required for AI features)
  # Get it from: https://makersuite.google.com/app/apikey
  gemini-api-key: ""
  # Enable or disable AI detection
  enabled: true
  # Minimum confidence level (0.0 to 1.0) for AI to flag content
  # Higher values = fewer false positives but might miss some violations
  # Recommended: 0.75 for balance, 0.85 for strict, 0.65 for lenient
  # NOTE: This feature (min-confidence) is currently not available and will be enabled in future updates
  min-confidence: 0.75 
  # Gemini AI model to use
  # The flash-exp version provides faster responses and it's free!
  # Please note that another model can be expensive.
  model: "gemini-2.0-flash-exp"
  # Enable debug messages in console (always in English)
  # Only recommended if the system is not working properly
  debug: false
  # Enables or disables the notification for analysis in progress.
  # Set to "false" to hide the message during the scanning process.
  notify-analysis: true

Similar projects

Plugin →