ServerChan

ServerChan - это дружелюбный AI-помощник для твоего сервера Майнкрафт. Он слушает чат, реагирует на события в игре и даже может выполнять команды, если дать ему разрешение. Неважно, уютный ли у тебя SMP или оживленный публичный сервер - ServerChan поддерживает беседу, не заспамливая игроков.

По сути, это готовое решение для тех, кто хочет добавить на сервер умного бота, который не тупит и правда понимает контекст. Вместо того чтобы ставить костыли с триггер-фразами, ты получаешь полноценную нейросеть, которая сама решает, когда ответить, а когда промолчать.

Основные фишки

• AI-чат - использует OpenAI-совместимые API (OpenAI, Azure, локальные LLM и т.д.) для осмысленных разговоров
• Умный отклик - опциональный проверяльщик интенций определяет, стоит ли боту отвечать, чтобы не бесить игроков лишними сообщениями
• Реакция на события - видит вход/выход игроков, смерти, прочие серверные ивенты
• Выполнение команд - AI может сам запускать майнкрафтовские команды через function calling (с контролем прав)
• Кроссплатформенность - работает на Fabric, Forge, NeoForge и Spigot/Paper
• Любые версии - от Minecraft 1.12 до 1.21
• Гибкая настройка - меняй промпты, модели, поведение ответов и многое другое
• Мультиязычность - встроена поддержка английского, китайского, японского

Совместимость по загрузчикам

Версия	Java	Fabric	Forge	NeoForge	Spigot/Paper
1.12.x	8	-	❌	-	✅
1.13.x	8	-	❌	-	✅
1.14.x	8	✅	❌	-	✅
1.15.x	8	✅	❌	-	✅
1.16.x	8	✅	✅	-	✅
1.17.x	16	✅	✅	-	✅
1.18.x	17	✅	✅	-	✅
1.19.x	17	✅	✅	-	✅
1.20.x	21	✅	✅	✅	✅
1.21.x	21	✅	✅	✅	✅

- означает, что загрузчик не существовал для этой версии (Fabric появился с 1.14, NeoForge - с 1.20).

Установка

Всё делается за пару минут:

1. Скачай jar-файл, подходящий под твой загрузчик, с Modrinth или CurseForge
2. Кидай его в папку mods/ (или plugins/ для Spigot/Paper)
3. Запусти сервер один раз, чтобы появился конфиг
4. Пропиши API-ключ и при необходимости другие настройки
5. Перезапусти сервер или сделай /reload - и можно общаться

Настройка

Конфиг лежит тут:

• Fabric/Forge/NeoForge: config/serverchan.yaml
• Spigot: plugins/ServerChan/config.yml

Обязательные параметры

Параметр	Описание
openaiApiKey	Твой API-ключ OpenAI (или совместимого провайдера)
openaiBaseUrl	Базовый URL API (по умолчанию https://api.openai.com/v1). Важно: должен содержать путь /v1

Опциональные параметры

Параметр	По умолчанию	Описание
model	gpt-5.1	Модель для ответов
temperature	1.0	Случайность ответов (0.0 - 2.0)
contextSize	20	Сколько последних сообщений помнить
botColor	b	Цвет сообщений бота (код цвета Minecraft)
timeZone	UTC	Часовой пояс для временных меток
locale	en	Язык сообщений бота

Проверка интенций

Используется быстрая/лёгкая модель, чтобы решить, стоит ли AI отвечать.

Параметр	По умолчанию	Описание
useIntentionChecker	true	Включить умную фильтрацию ответов
intentionCheckerModel	gpt-4o-mini	Модель для проверки интенций
responseProbabilityThreshold	0.5	Минимальная вероятность для ответа
useFastPathIntentionChecker	false	Начинать генерацию ответа заранее
intentionCheckerApiKey	(пусто)	Отдельный API-ключ (если пусто - используется основной)
intentionCheckerBaseUrl	(пусто)	Отдельный базовый URL (если пусто - основной). Должен содержать /v1

События

Параметр	По умолчанию	Описание
enableGameEvents	true	Реагировать на игровые события
enableJoinLeaveEvents	true	Реагировать на вход/выход игроков
enableDeathEvents	true	Реагировать на смерти игроков

Права

Параметр	По умолчанию	Описание
inheritCmdSourcePermission	true	AI наследует права игрока, вызвавшего команду

Кастомные промпты

Можешь изменить системные промпты, чтобы подстроить бота под атмосферу сервера:

• intentionCheckingSystemMessage - управляет тем, когда AI решает ответить
• responseGenerationSystemMessage - определяет личность и поведение бота

Примеры промптов лежат в папке example/. Например, example/OnlyMyRedstone-system-prompt.txt показывает полную настройку генерации ответов для сервера OnlyMyRedstone, а example/OnlyMyRedstone-intention-checking.txt - как этот сервер ограничивает ответы через проверку интенций. Можешь брать их за основу и адаптировать под себя.

Команды

Все команды требуют прав оператора (4 уровень).

Команда	Описание
/serverchan reload	Перезагрузить конфиг
/serverchan reset	Очистить контекст/память сообщений
/serverchan kill	Сбросить соединение с OpenAI
/serverchan disable	Приостановить ответы ServerChan (сообщения не обрабатываются)
/serverchan enable	Возобновить ответы ServerChan

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

1. Игрок пишет сообщение в чат
2. Проверяльщик интенций (если включен) оценивает, стоит ли отвечать
3. Если надо - основная модель генерирует ответ
4. AI может опционально выполнить команды через function calling
5. Ответ отправляется всем игрокам

Бот помнит контекст беседы в пределах заданного числа сообщений.

Требования

• Сервер Minecraft 1.12 - 1.21 (см. талицу совместимости)
• Один из: Fabriс, Forge, NeоForgе, Spigot/Papеr (доступность зависит от версии)
• APi-ключ OpenAI ии совместимого провайдера (Azurе ОpеnАI, Оllаmа и т.д.)

---

ServerChan - это реально крутая вещь для тех, кто хочет оживить сервер. Вместо скучного автоматического модератора ты получаешь собеседника, который может и пошутить, и помочь, и даже сам сходить в ад. На слабых серверах тоже норм, главное - выбрать правильную модель. Если хочешь, чтобы игроки не скучали и было что обсудить - смело ставь. Скачайте мод ServerChan и попробуйте сами - настройка простая, а эффект вау.