Piggy Admin

Piggy Admin

Серверный мод для администрирования, предназначенный для управления и принудительного применения настроек совместимых клиентских модов (таких как Piggy Build и Piggy Inventory). На данный момент служит центральной точкой для управления античитом, логированием и обнаружением, но в будущем будет включать больше инструментов администрирования.

⚠️ Отказ от ответственности

Это личный проект. Он предоставляется КАК ЕСТЬ и может вызывать проблемы.

• Без поддержки: Не рассчитывайте на регулярную поддержку или исправление багов.
• Без порта на Forge: Планов по портированию этого мода на Forge НЕТ.
• Используйте на свой страх и риск. Не стесняйтесь форкать проект или отправлять Pull Request, если хотите внести исправления или новые функции!

Возможности

🛡️ Принудительный античит

• Централизованное управление: Настраивайте, разрешены ли на вашем сервере «читерские» функции (например, быстрое размещение, смена инструментов).
• Автоматическая синхронизация: Когда игрок заходит, конфигурация античита сервера автоматически отправляется его клиенту.
• Строгое применение: Если сервер отключает читы, клиентские переопределения игнорируются, что обеспечивает честную игру.
• Гранулярное управление: Включайте и отключайте отдельные функции по отдельности (например, разрешить смену инструментов, но запретить быстрое размещение).

🕵️ Продвинутое обнаружение X-Ray

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

• Менеджер кэша руды: Асинхронно отслеживает местоположения ценных руд в эффективном ConcurrentHashMap, минимизируя нагрузку на главный поток.
• Векторная корреляция: Использует HeuristicsMathUtil для вычисления математической корреляции между вектором взгляда игрока и расстоянием до невидимых руд.
• Гибридный детектор: Сочетает сырые показатели добычи с семантическим анализом «подозрительных поворотов» и путей «напрямую к руде».
• Уровни чувствительности: От LOW (расслабленный) до PARANOID (строгий), настраивается через xraySensitivity.
• Оповещения для админов: Уведомления в реальном времени для админов с кликабельными ссылками для телепортации к координатам подозреваемого.

📜 Криминалистические данные и атрибуция

Мод служит мощным инструментом расследования гриферства.

• Атрибуция взрывов: Отслеживает истинного владельца TNT, даже если оно было подожжено кремнем и огнивом, огненным шаром или другими сущностями.
• Принадлежность Creeper: Определяет игроков, которые намеренно поджигают Creeper (с помощью кремня и огнива) для уничтожения территории.
• Ответственность за лаву и огонь: Специализированные трекеры для потоков жидкости и распространения огня по блокам. Даже если исходный блок исчез, мод хранит историю о том, кто его поставил.
• Отслеживание раздатчиков: Кастомные миксины на уровне раздатчика приписывают все выпущенные снаряды или операции с ведрами игроку, который поставил раздатчик или последним с ним взаимодействовал.
• Интерактивные уведомления: AdminNotifier отправляет насыщенные, кликабельные компоненты чата операторам, позволяя мгновенно выполнить «поиск виновника» прямо из оповещения.

📜 Движок модерации

• Модерация на базе ИИ: Интегрируется с Google Gemini AI для автоматической фильтрации токсичного или неуместного текста в чате и на табличках.
• Динамическая система правил: Определяйте собственные правила модерации и категории (например, нецензурная лексика, домогательства, разжигание ненависти).
• Оптимизированная производительность: Включает высокопроизводительный кэш и систему ограничения частоты запросов для минимизации задержек API и корректной обработки лимитов бесплатного тарифа API.
• Гибридная проверка: Сочетает быстрые локальные проверки Regex с глубоким семантическим анализом от Gemini.
• Категоризированные логи: Все заблокированные сообщения логируются с указанием их конкретной категории для удобного просмотра.

🤖 Настройка Gemini AI

Чтобы использовать функции модерации на базе ИИ, вам нужен ключ API Google Gemini.

1. Получите ключ API: Посетите Google AI Studio и создайте бесплатный ключ API.

2. Настройте мод:

   • Запустите сервер один раз, чтобы сгенерировать файл конфигурации.
   • Откройте config/piggy-admin-server.json.
   • Вставьте ваш ключ в поле "geminiApiKey".
   • Установите "moderationEnabled": true.

3. Дополнительные параметры:

   • geminiModel: по умолчанию gemini-1.5-flash (рекомендуется для скорости и экономии).
   • geminiSystemPrompt: Здесь вы можете настроить «личность» и строгость ИИ.

[!NOTE] У бесплатного тарифа Gemini есть ограничения по частоте запросов (примерно 15 запросов в минуту). Мод включает встроенный кэш и ограничитель частоты, чтобы корректно обрабатывать эти лимиты без лагов на сервере.

📜 История и логирование

• История табличек: Отслеживает, кто поставил табличку и что на ней было написано.
• История чата: Логирует все сообщения чата для административного просмотра.
• Логирование взрывов: Подробные логи размещения TNT, поджога и взрывов, включая атрибуцию игроков, когда это возможно.
• Инструмент «Blame»: Осмотрите существующие таблички/блоки, чтобы увидеть, кто и когда с ними взаимодействовал.
• Постоянное хранилище: История сохраняется после перезапусков сервера (сохраняется в config/piggy-admin-history.json).

---

Команды

Все команды требуют уровень OP 2 или выше.

Общее администрирование

• /piggy cheats <allow|forbid>: Глобально разрешить или запретить «читерские» функции для всех игроков.
• /piggy feature list: Показать список всех управляемых функций и их текущий статус.
• `/piggy feature <enable|disable>: Включить или отключить конкретную функцию (например, flexible_placement, tool_swap`).
• /piggy sync: Вручную запустить синхронизацию всех админских настроек и правил модерации для всех подключенных клиентов.

Расследование и логирование

• /blame: Посмотрите на блок или табличку и выполните эту команду, чтобы увидеть историю взаимодействий.

• Работает на: огне, лаве, табличках, контейнерах и областях после взрывов.

• `/logs `: Просмотр истории игрока по категориям (чат, таблички, огонь, взрывы, модерация).

  • Кликабельные телепорты: записи в логе содержат координаты, по которым можно кликнуть, чтобы осмотреть место.
• /piggy xray <clear|stats>: Управление кэшем эвристики X-Ray или просмотр текущего рейтинга игроков.

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

Мод создаёт файл конфигурации по пути config/piggy-admin-server.json (на стороне сервера).

{
  "allowCheats": false,
  "features": {
    "flexible_placement": true,
    "fast_place": false,
    "tool_swap": true
  },
  "xrayCheck": true,
  "xrayMaxRatio": 0.15,
  "xrayMinBlocks": 20,
  "moderationEnabled": true,
  "geminiApiKey": "YOUR_KEY",
  "geminiModel": "gemini-1.5-flash"
}

• "allowCheats": false: Принудительно отключает ограниченные функции у всех подключённых клиентов.
• "allowCheats": true: Позволяет клиентам использовать свои локальные настройки.
• "features":精细 настройка отдельных функций.
• "xrayMaxRatio": Максимально допустимое соотношение редких руд к общему числу блоков (по умолчанию 15%).
• "xrayMinBlocks": Минимальное число добытых блоков до активации обнаружения X-Ray (по умолчанию 20).
• "xrayCheck": Включение/выключение системы обнаружения X-Ray.
• "moderationEnabled": Включение/выключение движка модерации на основе ИИ и регулярных выражений.
• "geminiApiKey": Ваш API-ключ Google Gemini.
• "geminiModel": Используемая модель Gemini (по умолчанию: gemini-1.5-flash).

Зависимости и установка

Требования

• Minecraft: ~1.21.1
• Fabric Loader: >=0.18.1
• Java: >=21

Обязательные моды

• Fabric API: любая версия
• YACL (Yet Another Config Lib): >=3.6.1+1.21-fabric (для просмотра конфигурации клиентами)
• Piggy Lib: >=1.0.1
• (Опционально) Mod Menu: >=11.0.3 — рекомендуется для клиентов.

Установка

1. Скачайте .jar-файл из Releases.
2. Установите Fabric Loader для Minecraft 1.21.1.
3. Поместите jar-файл piggy-admin (вместе с Fabric API и Piggy Lib) в папку mods вашего сервера.
4. Запустите сервер!

Планы / будущие функции

• [x] Обнаружение XRay: реализовать эвристики/проверки для выявления игроков, использующих XRay-текстурпаки или моды.
• [X] Модерация текста на табличках: добавить инструменты для проверки и фильтрации текста на табличках, чтобы предотвратить неуместный контент.

Вдохновение

Этот мод был вдохновлён:

• ItemSwapper — концепцией серверного управления предметами и механикой обмена.

Лицензия: CC0-1.0