ClearItems

🧹 ClearItems - Автоматическая очистка сущностей

ClearItems — это production-grade мод для очистки, созданный специально для экосистемы Fabric. Он обеспечивает стабильность в самых суровых условиях и предлагает гибкий механизм вызова прав — идеальный выбор для крупных сборок и серверов с автоматизированным управлением.

💎 Ключевые технические преимущества

🛡️ Архитектура полной совместимости (логика без прав)

• Развязка уровней прав: Логика срабатывания команд переработана, жёсткая проверка isOp() на нижнем уровне убрана. Это позволяет вызывать команды через автоматизированные скрипты, не-OP игроками (в связке с плагинами прав) или командными блоками.
• Мгновенная адаптация к окружению: Глубокая оптимизация под серверные среды с тяжёлой обфускацией гарантирует стабильную работу в крупных модпаках.

🟢 Высокосовместимая архитектура вывода (ActionBar в приоритете)

• Ноль конфликтов UI: Вместо традиционного BossBar используется вставка текста в ActionBar, что полностью исключает визуальные конфликты из-за наложения элементов интерфейса в верхней части экрана.
• Ощущение нативности: Цветной текст динамически меняется со временем (зелёный > жёлтый > красный), визуальная обратная связь интуитивна и ненавязчива.

🚀 Основные функции

• 📋 Запрос в реальном времени (Whitelist Query): Используйте /clearitems list, чтобы в любой момент отслеживать статус защищённых предметов.
• 🛠️ Максимальная стабильность (Extreme Stability): Защитная логика, оптимизированная под высокие нагрузки, точный цикл очистки без дрейфа.
• 📈 Атомарная статистика (Atomic Reporting): Точный подсчёт фактического общего количества стаков выпавших предметов, а не только числа сущностей.
• ⚙️ Минимальные накладные расходы (Minimal Overhead): На базе нативного Fabric API, полная совместимость с оптимизационными модами вроде Lithium и FerriteCore.

🎮 Справочник команд

📦 Установка и лицензия

• Minecraft: 1.21.x
• Requirement: Fabric API
• License: MIT License

⚠️ Предупреждение о безопасности：

Поскольку обязательные требования к уровню прав для команд убраны, при работе на публичном сервере обязательно используйте плагин управления правами (например, LuckPerms) для контроля узлов команды /clearitems, чтобы обеспечить безопасность сервера.

❓ Часто задаваемые вопросы

Q: Почему я больше не вижу отсчёт BossBar?

• Для совместимости с тяжёлыми сборками на 200+ модов, начиная с v1.1.1 мы перевели уведомления в ActionBar (над хотбаром), что эффективно устраняет конфликты наложения UI.

Q: Почему команды доступны не-OP игрокам?

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

Q: Будет ли очищена экипировка на стойках для брони или в рамках?

• Нет. ClearItems работает только с сущностями выпавших предметов (Item Entity) и не затрагивает установленные контейнеры, стойки для брони или рамки.

Q: Как защитить конкретные предметы от очистки?

• Используйте команду /clearitems add <item_id> (например, minecraft:diamond), чтобы добавить их в белый список. Предметы из белого списка защищены навсегда.

Q: Совместим ли с оптимизационными модами вроде Lithium и FerriteCore?

Is it compatible with Lithium or FerriteCore?

• Полностью совместим. Мод написан на нативном Fabric API, не изменяет базовую логику и без проблем работает параллельно с различными низкоуровневыми оптимизационными модами.
• Fully compatible. Built on native Fabric API without core logic modification, ensuring seamless operation alongside major optimization mods.

👀 Скоро / Coming Soon (v1.2.0)

Мы на полной скорости разрабатываем новую систему переключения отображения (Flexible HUD Engine)! В грядущей версии v1.2.0 вас ждёт невиданная ранее свобода настройки:

We are working on a new Display Toggle System (Flexible HUD Engine)! In the upcoming v1.2.0, you will have unprecedented customization options:

• 🚦 Двухрежимный рендеринг (Dual-Mode Rendering): вы сможете свободно переключаться между классическим BossBar (подходит для лёгких сборок) и высокопроизводительным ActionBar (подходит для тяжёлых сборок с 200+ модами). Switch between classic BossBar (for light packs) and high-performance ActionBar (for heavy packs) freely.
• ⚙️ Поддержка конфигурации (Config Support): добавлен config.json, позволяющий навсегда задать режим отображения по умолчанию, с поддержкой динамической загрузки. Introducing config.json to permanently set the default display mode with hot-reload support.
• Команда мгновенного переключения (Hot-Swap Command): добавлена админ-команда для мгновенного изменения вида UI прямо в игре, без перезапуска. New admin command to change UI style in-game instantly without a restart.