Модерация Minecraft

Один серверный JVM-мод для игровых чатов. Игрокам ничего устанавливать не нужно.

Версия 1.0.0 · Java 8 и новее

Подключение сервера

Создайте проект и подключите Minecraft в разделе «Площадки». В разделе «Ключи» создайте ключ этого проекта с правами moderate:write и logs:read. Ключ показывается один раз — сохраните его только на сервере.
Скачайте jar и положите рядом со скриптом запуска. Сохраните конфигурацию в config/automod.json и заполните api.project_id и api.api_key. Адрес API уже указан в примере.
Добавьте аргумент JVM перед -jar или перед @.../unix_args.txt и перезапустите сервер. Для Forge и NeoForge аргумент можно добавить в user_jvm_args.txt.
Отправьте сообщение в игровой чат и проверьте его в логах проекта. Настройте правила и санкции в кабинете.

Аргумент запуска

-javaagent:automod-universal-1.0.0.jar=config/automod.json

Подключить Minecraft

Совместимость

Платформа	Версии Minecraft Java
Bukkit / Spigot / Paper и гибридные серверы с Bukkit API	1.7.10–26.3 · версия Java должна подходить вашей сборке сервера
Vanilla / Fabric / Quilt / Forge / NeoForge	1.7.10, 1.12.2, 1.16.5, 1.18.2, 1.19.2, 1.20.1, 1.20.4, 1.20.6, 1.21.1, 1.21.4, 1.21.8, 1.21.11, 26.1–26.3

Загрузчик должен существовать для выбранной версии игры. Поддержка нестандартных модпаков требует проверки. Bedrock, Folia и прокси BungeeCord/Velocity не поддерживаются: мод устанавливается на игровой backend.

Как работает модерация

Мод проверяет общий игровой чат по политике вашего проекта: пропускает, маскирует, блокирует сообщения, применяет мут и бан. Решения видны в логах. Сообщения одного игрока сохраняют порядок, сетевые запросы выполняются вне игрового потока.

Замаскированный подписанный чат отправляется системным сообщением: исходный текст не появляется в подсказке. Разрешённый чат сохраняет обычную обработку сервером.

При недоступности сервиса по умолчанию чат продолжает работать. Чтобы блокировать непроверенные сообщения, задайте universal.failure_action: block. Муты и баны сохраняются рядом с конфигурацией и переживают перезапуск.

Команды, личные сообщения, книги, таблички и отдельные каналы сторонних модов не перехватываются этой сборкой. Для них можно использовать HTTP API. Устанавливайте один экземпляр: агент заменяет прежние отдельные плагины и моды Automod.