ClearDrops

Серверный мод для Minecraft Forge 1.20.1, который решает извечную проблему замусоривания мира дропом. На любом сервере - будь то выживание или мини-игры - после боя с мобами, рубки деревьев или просто разбросанных ресурсов куча предметов остаётся лежать на земле. Это не только портит вид, но и создаёт лишнюю нагрузку на сервер. ClearDrops автоматически собирает все дропнутые вещи в один виртуальный контейнер - корзину на 54 слота (как ванильный двойной сундук). Игроки могут в любой момент заглянуть туда и забрать свои ценности. А через заданное время (по умолчанию 2 минуты после сбора) корзина очищается - лишний хлам уходит без следа.

Ключевые возможности

• Автосбор - предметы собираются каждые N тиков (настраивается). Можно отключить.
• Ручной сбор - команда /cleardrops collect мгновенно подберёт всё с земли.
• Корзина (54 слота) - открывается командой /cleardrops gui как обычный сундук. Никаких модов на клиенте!
• Горячая перезагрузка конфига - правишь файл world/serverconfig/cleardrops-server.toml, сохраняешь - и изменения применяются на лету. Либо /cleardrops reload.
• Гибкие сообщения - поддерживают градиентные цвета вида <gradient:#00E5FF:#00FF7F>текст</gradient>. Можно перевести на любой язык.
• Чёрный список предметов - если что-то не должно попадать в корзину (звезда Незера, тотем бессмертия), добавь ID в blacklist.items - такие вещи никогда не соберутся и не будут удалены при очистке корзины.
• Защита от пропажи в пустоте - предметы, упавшие ниже минимальной высоты, автоматически телепортируются обратно в безопасное место (настраивается высота подъёма).
• Предупреждения - за 60, 30, 10... секунд до сбора игроки видят сообщение: "Дроп будет собран через 5 секунд!".

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

• Minecraft: 1.20.1
• Forge: 47.4.x
• Java: 17
• Мод ID: cleardrops
• Клиент не требуется - чистая ванила спокойно заходит, видит GUI сундука и всё работает.

Команды (уровень доступа op level ≥ 2)

• /cleardrops help - справка с градиентным оформлением.
• /cleardrops gui - открыть корзину.
• /cleardrops status - статус: сколько слотов занято, когда очистка, включён ли автосбор.
• /cleardrops collect - собрать дроп прямо сейчас.
• /cleardrops purge - очистить корзину сейчас (чёрный список игнорируется).
• /cleardrops reload - перезагрузить конфиг.

Конфигурация (с горячей перезагрузкой)

Файл <WOLRD>/serverconfig/cleardrops-server.toml. Сохрани - и всё применится сразу (или выполни команду /cleardrops reload).

[general]
# Включить автоматический сбор
enableAutoCollect = true
# Тиков между сборами (20 тиков = 1 секунда)
ticksPerCollect = 6000
# Сколько тиков предметы живут в корзине до очистки
ticksKeepAfterCollect = 2400
# Показывать ли сообщения игрокам
announceMessages = true

[blacklist]
# ID предметов, которые не собираются и не удаляются при очистке
items = ["minecraft:nether_star", "minecraft:totem_of_undying"]

[void_protection]
# Поднимать ли предметы из пустоты
enableVoidProtect = true
# Максимум блоков вверх для поиска безопасного места
raiseMaxSteps = 6
# Сбрасывать ли скорость предмета при спасении
resetVelocity = true

[messages]
# Префикс сообщений (поддерживает градиент)
prefix = "<gradient:#00E5FF:#00FF7F>[Cleardrops]</gradient>"
# Секунды перед сбором для предупреждения
warnSeconds = [60, 30, 10, 5, 4, 3, 2, 1]
# Шаблон предупреждения (плейсхолдер {time})
msgPreCollect = "Сбор дропа через {time} секунд! Заберите ценности!"
# Сообщение о сборе ({entities} - кол-во предметов, {keep} - секунд до очистки)
msgCollected = "Собрано {entities} предметов. Используйте /cleardrops gui чтобы забрать. Очистка через {keep} секунд."
# Сообщение об очистке корзины ({slots} - кол-во слотов)
msgPurged = "Корзина очищена. Удалено {slots} слотов."
# Статус (много плейсхолдеров)
msgStatus = "Корзина: {slotsUsed}/{slotsTotal} слотов, {items} предметов; очистка через {keep}; авто={auto}, интервал={interval}с, хранение={keepCfg}с, оповещения={announce}."
# Справка (с градиентом и \n)
msgHelp = "<gradient:#7AD7F0:#4FC3F7>Помощь ClearDrops</gradient>\n<gradient:#A8FF78:#78FFD6>/cleardrops gui</gradient> - Открыть корзину\n<gradient:#A8FF78:#78FFD6>/cleardrops status</gradient> - Статус\n<gradient:#FFD54F:#FF8A00>/cleardrops collect</gradient> - Собрать сейчас (perm 2)\n<gradient:#FFD54F:#FF8A00>/cleardrops purge</gradient> - Очистить сейчас (perm 2)\n<gradient:#B388FF:#7C4DFF>/cleardrops reload</gradient> - Перезагрузить конфиг (perm 2)"
# /cleardrops collect
msgCmdCollect = "Собрано {entities} предметов. У вас {keep} секунд, чтобы забрать их из корзины."
# /cleardrops purge
msgCmdPurge = "Корзина очищена: {slots} слотов освобождено. Чёрный список не тронут."

Форматирование сообщений

• Градиент: <gradient:#RRGGBB:#RRGGBB>текст</gradient> - цвета плавно перетекают по символам.
• Плейсхолдеры: {time}, {entities}, {keep}, {slots}, {slotsUsed}, {slotsTotal}, {items}, {auto}, {interval}, {keepCfg}, {announce}.

Чёрный список и защита пустоты

• Чёрный список: предметы из списка не собираются при уборке и не удаляются при очистке корзины. Навсегда остаются в мире - никакой мод их не тронет.
• Защита пустоты: если предмет провалился ниже минимальной высоты мира, он телепортируется наверх в безопасное место. Можно настроить, на сколько блоков поднимать и сбрасывать ли скорость.

Установка

1. Закинь .jar файл мода в папку mods/ на сервере.
2. Запусти сервер один раз - сгенерируется конфиг.
3. Отредактируй <MIR>/serverconfig/cleardrops-server.toml под себя.
4. Конфиг перезагружается автоматически при сохранении; можно и командой /cleardrops reload.

FAQ - частые вопросы

Нужен ли мод на клиенте? Нет, это серверный мод. Игроки заходят с обычного ванильного Майнкрафта и видят GUI сундука.

Не конфликтует ли с другими модами на уборку? Несколько систем очистки могут накладываться. Лучше оставить один главный уборщик или настроить разные таймеры.

Конфиг не применяется? Убедись, что редактируешь файл serverconfig/cleardrops-server.toml именно в папке текущего мира. Сохрани - горячая перезагрузка сработает. Или пропиши /cleardrops reload.

Для разработчиков

• JDK 17, Forge 1.20.1 (47.4.x)
• Сборка: ./gradlew build (артефакты в build/libs/)
• Ключевые пакеты:
  • cn.alini.cleardrops.server.ServerScheduler - расписание, сбор, очистка, предупреждения, защита пустоты, чёрный список.
  • cn.alini.cleardrops.config.CDConfig - спецификация конфига и горячая перезагрузка.
  • cn.alini.cleardrops.command.CleardropsCommands - команды и обработчики.
  • cn.alini.cleardrops.util.MessageUtil - градиент и плейсхолдеры.
  • cn.alini.cleardrops.storage.TrashStorage - хранение корзины.

Лицензия

Проект распространяется под лицензией Creative Commons Attribution 4.0 International (CC BY 4.0). Вы можете копировать, изменять и распространять мод при условии указания авторства.