AskHelper

Плагин для Bukkit/Paper серверов Minecraft — AI-помощник для игроков на базе DeepSeek. Игрок задаёт вопрос в чате или командой — получает ответ от AI, знающего всё о вашем сервере.

Возможности

• Триггер в чате: пишешь ?как скрафтить меч — AI отвечает
• Команда /ask <вопрос> — то же самое
• Кулдаун между запросами (настраивается)
• Ответ только тебе или всем игрокам (настраивается)
• Системный промпт полностью под твой сервер — всё в config.yml
• Поддержка /askhelper reload без перезапуска сервера

Требования

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

Быстрая установка

Вариант 1 — через мастер настройки (рекомендуется)

python3 setup.py

Скрипт спросит название сервера, IP, моды, команды, правила и API ключ — и сгенерирует готовый config.yml.

Вариант 2 — вручную

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

   mvn clean package

2. Скопируй target/AskHelper-1.0.0.jar в plugins/
3. Запусти сервер — создастся plugins/AskHelper/config.yml
4. Заполни config.yml: укажи API ключ и опиши свой сервер в system-prompt
5. Выполни /askhelper reload или перезапусти сервер

Использование

Способ	Пример
Чат	?как скрафтить стальной меч
Команда	/ask сколько стоит железо в магазине

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

Ключевые параметры config.yml:

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

ask:
  trigger: "?"          # Символ-триггер в чате
  cooldown: 5           # Секунд между вопросами
  broadcast: false      # true = ответ видят все
  system-prompt: |      # Описание ВАШЕГО сервера для AI
    Ты — AI-помощник сервера "МОЙ СЕРВЕР"...

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

AskHelper/
├── setup.py                              # Мастер настройки
├── pom.xml
└── src/main/
    ├── java/ru/nashserver/askhelper/
    │   ├── AskHelper.java                # Основной класс
    │   ├── AskListener.java              # Обработчик триггера в чате
    │   ├── AskCommand.java               # Команда /ask
    │   ├── DeepSeekClient.java           # HTTP-клиент к DeepSeek API
    │   └── CooldownManager.java          # Кулдауны игроков
    └── resources/
        ├── plugin.yml
        └── config.yml                    # Шаблон конфигурации