Comparator

Comparator интегрирует в сервер полностью функционального ИИ-агента, способного поддерживать сложные диалоги с памятью и выполнять игровые действия через инструменты.

Comparator предоставляет полноценного разговорного ИИ-агента для Paper серверов, который отличается наличием многоходовой памяти и встроенных инструментов. В отличие от простых систем, дающих разовые ответы, плагин поддерживает контекст предыдущих сообщений для ведения естественного и связного диалога. 🤖

Агент может использовать специальные инструменты для получения точных и актуальных данных:

Плагин включает встроенную веб-панель, работающую через встроенный сервер. Она позволяет администраторам в реальном времени отслеживать диалоги, работу инструментов и зарегистрированные функции. Для запуска необходимо настроить хост и порт в comparator.conf, после чего использовать команду /comparator panel start.

Сторонние плагины могут регистрировать собственные инструменты через API Comparator. Процесс регистрации упрощен за счет аннотации функций:

@ToolFunction("give_item", "Gives an item to the requesting player")
suspend fun giveItem(
    @ToolParameter("The item to give") item: String,
    context: ToolContext
): GiveResult {
    val player = context.bukkitPlayer ?: throw ToolException("No player context", null)
    // ...
}

API автоматически обрабатывает валидацию параметров, проверку типов, сериализацию и отчетность об ошибках.

Проект ориентирован на безопасное использование ИИ:

• Доступ ограничен правами (permissions) Bukkit — администраторы могут гибко настраивать доступ к командам и чату.
• Настраиваемый системный промпт определяет поведение, личность и ограничения агента.
• Изоляция контекста: история диалогов разделена для каждого игрока, консоли и публичного чата.
• Автоматическое удаление истории по истечении периода неактивности.
• Валидация входных данных инструментов перед выполнением.
• Очередь сообщений предотвращает перегрузку сервера при спаме запросов.
• Структурированная обработка ошибок: модель получает описание сбоя вместо сырых стектрейсов.

Использование Kotlin coroutines обеспечивает полностью неблокирующее выполнение. Запросы к ИИ, вызовы инструментов и операции с контекстом не нагружают основной поток сервера (tick thread). ⚡

Поддерживается интеграция с Ollama (облачные и локальные модели). Настройка модели, базового URL и API-ключа выполняется в comparator.conf.

Для общения с агентом в личных сообщениях используйте:

/ask <prompt>

Для упоминания в публичном чате:

@bot <prompt>