SerendiClear

SerendiClear

SerendiClear — серверный мод для Fabric на Minecraft 26.2+, который поддерживает чистоту в мире: автоматически удаляет выпавшие предметы и ограничивает скопление мобов — всё это с обратным отсчётом на BossBar и удобным GUI мусорки, куда попадают предметы перед исчезновением.

Возможности

• 🧹 Автоочистка — настраиваемый интервал (по умолчанию: каждые 30 минут) убирает выпавшие предметы и лишних мобов.
• ⏲️ Обратный отсчёт на BossBar — видимая полоса BossBar предупреждает всех игроков перед очисткой (по умолчанию: 60 секунд).
• 🗑️ GUI мусорки — удалённые предметы сохраняются в постраничном сундучном GUI (/垃圾桶), чтобы игроки могли их забрать.
• 👾 Ограничение скопления мобов — ограничивает количество мобов одного типа в настраиваемом радиусе (по умолчанию: ≤24 на 16 блоков).
• 🛡️ Умная защита — именованные сущности/предметы и настраиваемые ID предметов никогда не удаляются.
• 🌍 Мультимир — работа с конкретными мирами или сразу со всеми.
• 🎮 Ручной запуск — /serendiclear clear запускает очистку по требованию.
• ⚙️ Горячая перезагрузка конфига — /serendiclear reload применяет изменения конфига без перезапуска.
• 🔌 Чисто серверный — установка на клиент не требуется.

Команды

Команда /垃圾桶 — китайское слово, означающее «мусорка». В будущей версии её можно будет переименовать или добавить псевдоним.

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

Файл конфига находится по пути config/serendiclear.json. Он создаётся автоматически со значениями по умолчанию при первом запуске.

Общие параметры

Параметр	Тип	По умолчанию	Описание
worlds	string[]	["all"]	Миры для очистки. Укажите ["all"] для всех измерений или перечислите конкретные (например, ["minecraft:overworld"]).
intervalMinutes	int	30	Интервал между автоматическими очистками (в минутах). Минимум: 1.
broadcastSeconds	int	60	Длительность отсчёта в секундах. Укажите 0 для мгновенной очистки.
prefix	string	"§9SerendiClear >> "	Префикс сообщений в чате.
bossbarTitle	string	"§e即将清理！倒计时: §c{time} §e秒"	Заголовок BossBar. {time} заменяется на оставшиеся секунды.

Параметры предметов и мобов

Параметр	Тип	По умолчанию	Описание
clearDrops	bool	true	Удалять ли выпавшие предметы.
clearMobs	bool	true	Применять ли ограничение скопления мобов.
maxMobStack	int	24	Максимальное количество мобов одного типа в пределах mobStackRadius.
mobStackRadius	int	16	Радиус (в блоках) для обнаружения скоплений мобов.
protectNamed	bool	true	Пропускать ли именованные сущности или переименованные стопки предметов.
protectedItems	string[]	[]	ID предметов, которые никогда не удаляются (например, ["minecraft:diamond", "minecraft:netherite_ingot"]).

Параметры мусорки

Параметр	Тип	По умолчанию	Описание
trashEnabled	bool	true	Включить мусорку. Если выключено, выпавшие предметы просто удаляются.
trashMaxPages	int	5	Максимальное количество страниц мусорки (каждая страница — сетка на 54 слота размером с сундук).
trashTitle	string	"§9§l垃圾桶 §7(第{page}/{max}页)"	Заголовок GUI мусорки. {page} и {max} — плейсхолдеры.
trashOpenButton	string	"§e§l【点我打开垃圾桶】"	Кликабельное сообщение в чате, отправляемое после очистки.
trashExcludedWorlds	string[]	[]	Миры, в которых сообщение о мусорке не отправляется.

Когда в мусорке заканчивается место (все страницы заполнены), она автоматически очищается и начинает заполняться заново. При этом рассылается уведомление.

Установка

1. Установите Fabric Loader для Minecraft 26.2+.
2. Поместите `SerendiClear-.jarв папкуmods/` вашего сервера.
3. Запустите сервер — мод чисто серверный и не требует установки на клиент.
4. Настройте config/serendiclear.json по своему вкусу (он создаётся автоматически).

Зависимости

• Fabric API (любая версия, совместимая с вашим Minecraft)
• Minecraft 26.2+

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

1. Цикл тиков — каждый тик сервера мод проверяет, прошло ли intervalMinutes.
2. Отсчёт — при срабатывании появляется BossBar и идёт отсчёт в течение broadcastSeconds. Тем временем игроки могут использовать /垃圾桶.

3. Очистка — мод перебирает все загруженные чанки в целевых мирах:

   • Предметы: удаляет незащищённые ItemEntity и сохраняет их в мусорку.
   • Мобы: группирует живые сущности по типу, находит скопления в пределах mobStackRadius и удаляет самых дальних лишних, пока скопление не достигнет maxMobStack.
4. Уведомление о мусорке — после очистки в чате появляется кликабельная кнопка, приглашающая игроков открыть мусорку и забрать свои предметы.

---

Система прав

Мод использует встроенный API прав Fabric API на уровне commands.gamemaster. Игроки со статусом оператора (или получившие это право через мод прав) могут использовать административные команды.

Лицензия

Этот проект распространяется под лицензией MIT.