Плагин SvortexTimeClear 2025-08-03

Исправлен критический баг:
В предыдущих версиях при включении очистки мобов плагин удалял всех игроков на сервере. Этот баг полностью исправлен в версии 1.2.

Исправлены кракозябры в консоли:
Больше никаких нечитаемых символов в логах сервера - все сообщения теперь отображаются корректно.

---

Умная очистка - главная фишка плагина

Система автоматического мониторинга производительности сервера:

Что отслеживается:

• TPS (тики в секунду) - производительность сервера
• Использование RAM - нагрузка на память
• Количество предметов - контроль захламления
• Количество мобов - оптимизация производительности

Автоматическая активация при:

Код:

TPS < 18.0
RAM > 80%
Предметов > 500
Мобов > 200

Умные уведомления:

Код:

УМНАЯ ОЧИСТКА: Производительность снижена! (TPS: 16.2, RAM: 85%)
Производительность восстановлена!

---
GUI меню настроек
Управляйте плагином через удобный графический интерфейс!
Команда: /clearresources gui
Что можно настроить:

• / Очистка предметов (зеленая/красная шерсть)
• / Очистка мобов (живая индикация)
• Умная очистка (факел/красный факел)
• Звуковые эффекты (нотный блок/барьер)
• Просмотр статистики (книга)

Все изменения сохраняются автоматически!
---
Звуковые эффекты
Атмосферные уведомления для игроков:
Типы звуков:

• Предупреждение - за 60, 30, 10, 5 секунд до очистки
• Завершение очистки - приятный звук завершения
• Умная очистка - специальный звук активации

Настройка в config.yml:

YAML:

sounds:
  enabled: true
  warning: "BLOCK_NOTE_BLOCK_PLING"
  cleanup: "ENTITY_EXPERIENCE_ORB_PICKUP"
  smart-mode: "BLOCK_BELL_USE"
  volume: 1.0
  pitch: 1.0

---
Команды и диагностика
Основные команды:

Код:

/clearresources - мгновенная очистка
/clearresources stats - статистика очистки
/clearresources gui - открыть меню настроек
/clearresources reload - перезагрузить конфиг

Диагностические команды:

Код:

/clearresources debug - полная диагностика плагина
/clearresources test - тест всех сообщений и звуков
/clearresources performance - данные производительности

Пример вывода performance:

Код:

=== ПРОИЗВОДИТЕЛЬНОСТЬ ===
• TPS: 19.95 (ОК)
• RAM: 45% (ОК)
• Предметов: 127/500 (ОК)
• Мобов: 89/200 (ОК)

---
Расширенная конфигурация
Базовые настройки:

YAML:

# Интервал очистки в секундах
cleanup-interval: 300
# Сообщения для игроков (поддержка цветов)
messages:
  - "&6Очистка ресурсов через &c{seconds} &eсекунд!"
  - "&aОчищено: &b{items} &fпредметов и &d{mobs} &fмобов!"
# Что очищать
clear-items: true
clear-mobs: false
# Исключения
excluded-mobs:
  - VILLAGER
  - WOLF
  - CAT
excluded-items:
  - DIAMOND
  - NETHERITE_INGOT
# Миры для очистки (пустой = все миры)
included-worlds: []
# Интервалы предупреждений
countdown-intervals:
  - 60
  - 30
  - 10
  - 5

Умная очистка:

YAML:

smart-cleanup:
  enabled: false
  tps-threshold: 18.0          # Порог TPS
  memory-threshold: 80         # Порог RAM (%)
  entity-limits:
    items: 500                 # Лимит предметов
    mobs: 200                  # Лимит мобов

Расписание очистки:

YAML:

schedule:
  enabled: false
  times: [6, 12, 18, 0]        # Время в часах (4 раза в день)
  force-cleanup: true          # Принудительная очистка

Мировые фильтры:

YAML:

world-filters:
  mode: "include"              # "include" или "exclude"
  worlds: []                   # Список миров
  per-world-settings:          # Настройки для каждого мира
    world_nether:
      clear-items: true
      clear-mobs: true
    world_the_end:
      clear-items: false
      clear-mobs: false

---
Установка и настройка
Установка:
1. Скачайте плагин
2. Поместите JAR файл в папку plugins
3. Перезапустите сервер
4. Настройте config.yml под свои нужды
Обновление с версии 1.1:
1. ОБЯЗАТЕЛЬНО остановите сервер
2. Замените JAR файл
3. Удалите старый config.yml (создастся новый)
4. Запустите сервер
5. Выполните /clearresources debug для проверки
### Первая настройка:

Код:

/clearresources gui      # Откройте меню настроек
/clearresources test     # Протестируйте все функции
/clearresources debug    # Проверьте корректность работы

---
Совместимость
Поддерживаемые версии:

• Minecraft: 1.17.1 - 1.21+
• Серверы: Spigot, Paper, Purpur
• Java: 17+ (рекомендуется)

---
Статистика и мониторинг
Что отслеживается:

• Общее количество очищенных предметов
• Общее количество очищенных мобов
• Активации умной очистки
• Данные производительности в реальном времени

Пример статистики:

Код:

=== СТАТИСТИКА ОЧИСТКИ ===
• Предметов очищено: 15,847
• Мобов очищено: 3,291
• Умная очистка: ВКЛЮЧЕНА
• Режим: ОБЫЧНЫЙ

---
Особенности интерфейса
Цветовые коды:

• Предупреждения: Золотой (&6)
• Успех: Зеленый (&a)
• Ошибки: Красный (&c)
• Информация: Голубой (&b) и розовый (&d)

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

• Поддержка русского и английского языка
• Адаптивные сообщения для разных ситуаций

---
Безопасность
Защита игроков:

• Плагин НИКОГДА не удаляет игроков
• Безопасная фильтрация по типам энтити
• Дополнительные проверки в коде

Защита данных:

• Сохранение статистики
• Автоматические бэкапы настроек
• Защита от некорректных конфигураций

---
Устранение неполадок
Диагностика проблем:
```
/clearresources debug # Полная диагностика
/clearresources test # Тест всех функций

Что нового в версии 1.1?

Мы значительно улучшили плагин SvortexTimeClear, добавив новые функции, повысив производительность и обеспечив полную совместимость с Minecraft 1.17.1 и выше. Вот список изменений:

- Совместимость с Minecraft 1.17.1+:
Плагин теперь полностью поддерживает версии от 1.17.1 до 1.21 (по состоянию на май 2025). Использованы только стабильные методы Bukkit API для надежной работы на Spigot.

- Фильтрация миров:
Добавлена настройка included-worlds в config.yml. Теперь вы можете указать, какие миры очищать. Если список пуст, очищаются все миры.

- Черный список предметов:
Новая настройка excluded-items позволяет исключить определенные предметы (например, DIAMOND, NETHERITE_INGOT) из очистки, чтобы сохранить ценные ресурсы.

- Гибкие интервалы предупреждений:
Добавлена настройка countdown-intervals в config.yml. Вы можете задать, за сколько секунд выводить предупреждения об очистке (по умолчанию: 60, 30, 10, 5 секунд).

- Команда статистики:
Новая команда /clearresources stats показывает общее количество очищенных предметов и мобов за всё время работы плагина.

- Автодополнение команд:
Реализована поддержка автодополнения для команды /clearresources с вариантами reload и stats, что упрощает управление для админов.

- Оптимизация производительности:
Добавлена асинхронная обработка сущностей для снижения нагрузки на сервер, особенно при очистке большого количества предметов и мобов.

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

Обновленный config.yml
Добавлены новые параметры: excluded-items, included-worlds, countdown-intervals. Пример:

YAML:

cleanup-interval: 300
messages:
  - "Очистка ресурсов через {seconds} секунд!"
  - "Очищено {items} предметов и {mobs} мобов!"
clear-items: true
clear-mobs: false
excluded-mobs:
  - VILLAGER
  - WOLF
  - CAT
excluded-items:
  - DIAMOND
  - NETHERITE_INGOT
included-worlds: []
countdown-intervals:
  - 60
  - 30
  - 10
  - 5

Как обновить?
1. Замените старый JAR-файл в папке plugins на новый.
2. Удалите старый config.yml, чтобы сгенерировать новый с дополнительными настройками.
3. Перезапустите сервер или используйте /plugman reload SvortexTimeClear.
4. Настройте новый config.yml под ваши нужды.

Баги или идеи?
Пишите в обсуждение.