Piggy Lib

Piggy Lib

Общая библиотека, предоставляющая базовую инфраструктуру и высокопроизводительные утилиты для всех модов Piggy. Она централизует общие системы для обеспечения согласованности, стабильности и соответствия анти-читу.

⚡ Центральная очередь действий Piggy

Самый важный компонент набора Piggy. Все взаимодействия игрока (клики по слотам, установка блоков, использование предметов) должны проходить через эту очередь.

• Действия с состоянием: Взаимодействия оборачиваются в объекты IAction (например, InteractBlockAction, MoveItemAction).
• Проверка вместо предположения: Действия не считаются «выполненными» после отправки пакета. Они используют фазу onExecute для запуска и фазу verify для опроса результата (например, проверка, действительно ли предмет переместился в целевой слот).
• Ограничение скорости и CPS: Глобальный ограничитель кликов в секунду (CPS) следует настраиваемым правилам сервера. Рутинные действия (сортировка) замедляются, а спасительные действия (MLG) используют ActionPriority.HIGHEST для обхода ограничителя.
• Объединение пакетов: Группирует связанные взаимодействия в однотиковые выполнения, когда это безопасно, минимизируя сетевые накладные расходы.

📊 Производительность и телеметрия

PerfMonitor

Надёжная утилита для отслеживания состояния сервера и сетевых условий.

• Динамическое отслеживание TPS: Вычисляет серверные тики в секунду в реальном времени.
• Расчёт задержки: Предоставляет стабильные, сглаженные данные пинга, используемые piggy-build для упреждающего запуска действий.

Сессии мета-действий

Сложный движок телеметрии для диагностики комплексных сбоев.

• Контекстное логирование: Захватывает состояния инвентаря, позиции игрока и метаданные мира до и после действий.
• Криминалистические отчёты: Генерирует подробные отчёты в формате JSON/Markdown для неудачных операций (например, неудачная сортировка инвентаря или пропущенный MLG).
• Богатое форматирование: Использует PiggyTelemetryFormatter для предоставления интерактивных, кликабельных чат-компонентов для административной проверки.

🎒 API инвентаря

InventorySearcher

Модульный, высокопроизводительный движок для поиска предметов в нескольких контейнерах.

• Поиск по условиям: Фильтрация предметов по типу, тегу, NBT или пользовательским предикатам.
• Разрешение нескольких слотов: Обрабатывает сложные поиски, включающие разделённые стеки или «мега-стеки» (>64 предметов).

🎨 Интерфейс и конфигурация

• Унифицированные радиальные меню: Стандартизированный GenericRadialMenuScreen для согласованных интерфейсов выбора.
• Обёртки конфигурации YACL: Упрощённый шаблон фабрики для создания красивых, категоризированных экранов конфигурации с использованием Yet Another Config Lib.
• Обратная связь анти-чита: Оверлеи HUD и всплывающие уведомления, информирующие игроков, когда функции ограничены сервером.

Зависимости

• Fabric API
• YACL (Требуется для интерфейса конфигурации)

Лицензия

CC0-1.0