ChatAIMod

Плагин для Bukkit/Paper серверов Minecraft, реализующий автоматическую AI-модерацию чата через DeepSeek API.

Как это работает

1. Плагин накапливает сообщения чата в очередь (батч)
2. По достижении порога (по умолчанию 100 сообщений) или по таймеру (по умолчанию 5 минут) — пакет отправляется в DeepSeek
3. AI анализирует сообщения согласно правилам сервера из config.yml и возвращает список нарушителей с рекомендуемым наказанием
4. Плагин исполняет наказания (warn/mute) автоматически
5. Игрок может оспорить решение через /appeal — апелляция также рассматривается AI

Возможности

• Пакетная обработка сообщений (экономия API-запросов)
• Гибкие правила модерации в config.yml — не нужно трогать код
• Система апелляций /appeal <аргументы> с повторным AI-анализом
• Асинхронные запросы (сервер не лагает)
• Команды администратора: статус очереди, ручной флуш, перезагрузка конфига
• Поддержка BanManager (опционально)

Требования

Параметр	Значение
Minecraft	1.20.1+
API	Spigot/Paper 1.20.1-R0.1-SNAPSHOT
Java	17+
DeepSeek API ключ	platform.deepseek.com

Установка

1. Собери плагин:

   mvn clean package

2. Скопируй target/ChatAIMod-1.0.0.jar в папку plugins/ сервера
3. Перезапусти сервер — создастся plugins/ChatAIMod/config.yml
4. Укажи свой DeepSeek API ключ в конфиге:

   deepseek:
     api-key: "YOUR_DEEPSEEK_API_KEY"

5. Перезапусти сервер или выполни /chatai reload

Команды

Команда	Описание	Право
/chatai status	Сообщений в очереди	chatai.admin
/chatai flush	Отправить батч немедленно	chatai.admin
/chatai reload	Перезагрузить конфиг	chatai.admin
/appeal <текст>	Подать апелляцию на наказание	Все игроки

Конфигурация

deepseek:
  api-key: "YOUR_DEEPSEEK_API_KEY"   # Ключ с platform.deepseek.com
  model: "deepseek-chat"

moderation:
  batch-size: 100        # Сообщений в одном батче
  flush-interval: 300    # Секунд до принудительной отправки
  log-decisions: true    # Логировать решения AI в консоль

rules: |
  # Здесь описываются правила сервера для AI
  # Именно этот текст передаётся модели как инструкция

Структура проекта

ChatAIMod/
├── pom.xml
└── src/main/
    ├── java/ru/nashserver/chataimod/
    │   ├── ChatAIMod.java           # Основной класс, команды
    │   ├── ChatCollector.java       # Сбор и батчинг сообщений
    │   ├── DeepSeekClient.java      # HTTP-клиент к DeepSeek API
    │   ├── ModerationExecutor.java  # Исполнение наказаний
    │   ├── ModerationAction.java    # Модель действия (warn/mute)
    │   ├── AppealManager.java       # Обработка апелляций
    │   └── AppealResult.java        # Результат рассмотрения апелляции
    └── resources/
        ├── plugin.yml
        └── config.yml