WorldEaterNotifier

--- ## Что это? Мод для Fabric, который следит за пожирателями мира (на основе TNT), траншерами и разрушителями бедрока (на основе разрушения блоков) и отправляет уведомления через вебхук Discord с настройкой пинга для каждого события и полностью настраиваемыми сообщениями, когда они останавливаются, запускаются или встречают препятствие. ## Документация Полное руководство по настройке всех функций смотрите в документации: Документация WorldEaterNotifier ## Возможности - Мониторинг в реальном времени: отслеживает пожиратели мира (по количеству TNT), траншеи и разрушители бедрока (по разрушению блоков). - Интеграция с Discord: мгновенно отправляет уведомления, когда машина запускается, останавливается, возобновляет работу или остановлена вручную. - Настраиваемые сообщения: каждое сообщение уведомления настраивается для каждого типа машины через JSON — используйте плейсхолдеры {type} и {name}. - Уведомления по ролям: упоминание конкретных ролей Discord с переключателями для каждого события (глобально, запуск, ручная остановка, застревание, возобновление, выключение сервера). Всё настраивается в игре через команды. - Режим бота Discord: бот на JDA с интерактивной кнопкой-переключателем и слэш-командами (/config, /worldeater start|stop|list, /trencher start|stop|list, /bedrockbreaker start|stop|list) с автодополнением. - Настраиваемые пороги: таймаут остановки, минимальное количество TNT / разрушенных блоков для каждого типа машины. - Поддержка нескольких миров: отслеживание машин в разных измерениях. - Сохранение конфигурации: определения машин, настройки и переключатели пинга переживают перезапуск сервера. Сообщения редактируются в JSON. - Определение выключения сервера: автоматически останавливает все активные машины при выключении и уведомляет Discord. ## Установка 1. Клонируйте репозиторий: bash git clone https://github.com/CodeW4VE/WorldEaterNotifier.git cd WorldEaterNotifier 2. Соберите мод: bash ./gradlew build 3. Скопируйте полученный .jar из build/libs/ в папку mods вашего сервера: bash cp build/libs/worldeaternotifier-*.jar /path/to/server/mods/ 4. Создайте файл worldeaternotifier-config.json в папке config вашего сервера с настройками вебхука Discord и пожирателя мира. ## Конфигурация Мод создаёт config/worldeaternotifier.json при первом запуске. Вы можете редактировать его вручную или использовать команды в игре. Пример: json { "webhookUrl": "https://discord.com/api/webhooks/...", "pingRoleId": "123456789012345678", "notificationMode": "webhook", "botToken": "", "guildId": "", "channelId": "", "showSubscriptionButton": true, "memberDiscordRole": "", "worldEaterSettings": { "stopTimeoutSeconds": 60, "minTntCount": 3, "pingSettings": { "enabled": true, "onStart": true, "onStop": true, "onStuck": true, "onResumed": true, "onShutdown": true }, "messages": { "start": "{type} **'{name}'** has started.", "stuck": "{type} **'{name}'** has stopped due to an obstruction.", "resumed": "{type} **'{name}'** has started again.", "manualStop": "{type} **'{name}'** was stopped manually.", "shutdown": "{type} **'{name}'** was shut down with the server and may have broken." } }, "trencherSettings": { "stopTimeoutSeconds": 180, "minBlocksBroken": 20, "pingSettings": { "enabled": true, "onStart": true, "onStop": true, "onStuck": true, "onResumed": true, "onShutdown": true }, "messages": { "start": "{type} **'{name}'** has started.", "stuck": "{type} **'{name}'** has stopped due to an obstruction.", "resumed": "{type} **'{name}'** has started again.", "manualStop": "{type} **'{name}'** was stopped manually.", "shutdown": "{type} **'{name}'** was shut down with the server and may have broken." } }, "bedrockBreakerSettings": { "stopTimeoutSeconds": 60, "minBlocksBroken": 1, "pingSettings": { "enabled": true, "onStart": true, "onStop": true, "onStuck": true, "onResumed": true, "onShutdown": true }, "messages": { "start": "{type} **'{name}'** has started.", "stuck": "{type} **'{name}'** has stopped due to an obstruction.", "resumed": "{type} **'{name}'** has started again.", "manualStop": "{type} **'{name}'** was stopped manually.", "shutdown": "{type} **'{name}'** was shut down with the server and may have broken." } }, "worldEaters": [], "trenchers": [], "bedrockBreakers": [], "whitelist": [] } - webhookUrl: URL вебхука Discord. - pingRoleId: ID роли Discord для упоминания. Оставьте пустым или "0", чтобы отключить все упоминания. - notificationMode: "webhook" (по умолчанию) или "bot" — переключает между доставкой через вебхук и через бота JDA. - botToken: токен бота Discord (нужен для режима бота). - guildId / channelId: сервер и канал Discord для уведомлений бота и слэш-команд. - showSubscriptionButton: показывать ли кнопку "Toggle Ping" в сообщениях о запуске (режим бота). - memberDiscordRole: ID роли Discord, дающей доступ к /worldeater start|stop|list (и аналогам для траншера/разрушителя бедрока) через слэш-команды; у админов доступ всегда есть.

• stopTimeoutSeconds: Сколько секунд без активности должно пройти, прежде чем машина считается застрявшей.
• minTntCount / minBlocksBroken: Минимальная активность за проверку, чтобы машина продолжала работать.
• pingSettings: Переключатели пингов для каждого типа машины (enabled, onStart, onStop, onStuck, onResumed, onShutdown) — теперь они сохраняются между перезапусками.
• messages: Настраиваемые сообщения уведомлений в Discord для каждого типа машины. Используй {type} для названия типа машины и {name} для имени экземпляра машины.

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

1. Установи мод и запусти сервер.

2. Настрой доставку:

   • Режим вебхука (по умолчанию): `/worldeater settings setWebhookUrl `
   • Режим бота: `/worldeater settings setBotToken , задай setGuildIdиsetChannelId, затем /worldeater settings setNotificationMode bot`

3. Создай машины:

   • `/worldeater create `
   • `/trencher create `
   • `/bedrockbreaker create (Координаты автоматически подставляют блок, на котором ты стоишь; Tab` дополняет имена.)
4. Запусти мониторинг командой `/worldeater start , /trencher start или/bedrockbreaker start `.
5. Мод автоматически отправляет сообщения в Discord, когда машина неожиданно останавливается (застревает), возобновляет работу или останавливается вручную.

6. В режиме бота слэш-команды Discord повторяют команды Minecraft:

   • `/worldeater start , /worldeater stop , /worldeater list` (автодополнение подсказывает существующие имена)
   • То же самое для /trencher и /bedrockbreaker
   • /config pings — интерактивный процесс переключения настроек пингов для каждого типа машины

7. Меняй настройки на лету:

   • /worldeater settings show, /trencher settings show, /bedrockbreaker settings show
   • `/worldeater settings setStopTimeout `
   • `/trencher settings setMinBlocksBroken `
   • /worldeater settings discordPings enable true и отдельные события вроде onStuck false
   • /worldeater settings showSubscriptionButton <true|false> (режим бота)
   • `/worldeater settings setMemberDiscordRole ` (режим бота)
   • Редактируй сообщения уведомлений прямо в JSON-файле.
   • Используй Tab, чтобы изучить все подкоманды.
8. Управляй машинами: list, stop, delete для всех трёх типов.
9. При выключении сервера все активные машины останавливаются и отправляется уведомление о завершении работы.

Зависимости

• Fabric Loader
• Fabric API
• Стандартные библиотеки Minecraft и Java

Сборка из исходников

Требуется:

• Gradle 8.10.2 или выше (скачивается автоматически через gradlew)
• Java 21 или выше Команда сборки:

./gradlew clean build

Созданный артефакт: build/libs/worldeaternotifier-*.jar

Лицензия

MIT © froyln