# 🛡️ AntiGriefSystem v3.0 — Changelog > Полная переработка с нуля. Новая архитектура, движки ядра, система доверия и глубокая интеграция с Discord. --- ## 🏗️ Новая модульная архитектура Плагин переписан как многомодульный Gradle-проект: - **`api`** — публичные интерфейсы (`AGModule`, `Check`, `PlayerContext`, …) - **`common`** — общие типы (`ActionInfo`, `ActionType`, …) - **`core`** — все движки, пайплайн, trust-система, хранилище, алерты - **`modules/detection`** — модуль детекции (Lava, Fire, Explosive, Redstone) - **`modules/trust`** — поведенческая аналитика - **`platform-paper`** — Paper-платформа: плагин, команды, Discord Ядро полностью изолировано от платформы — основа для будущей поддержки Folia/Velocity. --- ## 🔐 Система доверия — Trust Tiers Автоматическое повышение уровня по наигранному времени: | Tier | Название | Условие | |:----:|:--------------------|:--------------| | 0 | Недоверенный | < 60 мин | | 1 | Огнеопасно | 60 – 120 мин | | 2 | Взрывоопасно | 120 – 240 мин | | 3 | Редстоун | 240+ мин | Администратор может вручную выставить или сбросить уровень:

bug-fix

# Changelog ## [2.4.1] - 2026-02-13 ### 🚀 Improvements & Fixes (Улучшения и Исправления) - **Critical Locations (Критические Локации)**: - **FIX**: Исправлена логика выделения регионов. Теперь команды `/critical pos1` и `/critical pos2` используют блок, на который смотрит игрок (RayTrace), что предотвращает ошибки с "незащищенным полом". - **FIX**: Исправлено отображение пинга роли в Discord (`<@&ID>`). - **FIX**: Улучшена проверка нарушений внутри региона (теперь корректно учитывается только использование запрещенных предметов). - **Merge & Compatibility (Слияние и Совместимость)**: - Успешно объединены изменения версии **2.3.0** (Alerts, Feedback) и **2.4.0** (Critical Locations). - Единая система инициализации менеджеров (`AlertManager`, `FeedbackManager`, `CriticalLocationManager`). - Исправлены конфликты в `build.gradle` и `plugin.yml`. ### 🛠 Migration Guide (Миграция на 2.4.1) Если вы обновляетесь с **2.3.0** или **2.4.0**, выполните: 1. **Обновите `discord.yml`**: Убедитесь, что у вас есть секция `critical-location-alert` (добавлена в v2.4.0). Если нет, добавьте её (см. пример ниже). 2. **Пересоздайте критические регионы (Рекомендуется)**: Если у вас были проблемы с высотой региона (пол/потолок), удалите старые регионы (`/critical remove`) и создайте новые, глядя прямо на блоки углов. 3. **Права (Permissions)**: Убедитесь, что у администраторов есть права: - `antigrief.admin.critical` (управление критическими зонами) - `antigrief.bypass.critical` (обход) - `ags.alerts` (уведомления о подозрительных действиях) --- ### 🇬🇧 English Version #### 🚀 Improvements & Fixes - **Critical Locations**: - **FIX**: Improved region selection logic. Commands `/critical pos1` and `/critical pos2` now use the target block (RayTrace), preventing "unprotected floor" issues. - **FIX**: Fixed role ping display in Discord (`<@&ID>`). - **FIX**: Improved violation check within the region (now correctly checks only for restricted items). - **Merge & Compatibility**: - Successfully merged changes from v2.3.0 (Alerts, Feedback) and v2.4.0 (Critical Locations). - Unified manager initialization (`AlertManager`, `FeedbackManager`, `CriticalLocationManager`). - Fixed conflicts in `build.gradle` and `plugin.yml`. #### 🛠 Migration Guide (v2.4.1) If upgrading from **2.3.0** or **2.4.0**, please: 1. **Update `discord.yml`**: Ensure `critical-location-alert` section exists. If missing, add it (see example in changelog history). 2. **Recreate Critical Locations (Recommended)**: If facing floor/ceiling protection issues, remove old regions (`/critical remove`) and recreate them by looking directly at corner blocks. 3. **Permissions**: Ensure admins have: - `antigrief.admin.critical` (manage critical zones) - `antigrief.bypass.critical` (bypass protection) - `ags.alerts` (suspicious activity alerts)

# Changelog ## [2.3.0] - 2026-01-16 ### ✨ Новые возможности (Features) - **Система слежки и Алертов (Alerts & Spectator)**: - 🎨 **Premium Design**: Новые красивые градиенты для уведомлений. - 👁️ **Click-to-Spectate**: Кнопка **[СЛЕЖКА]** в чате для мгновенного перехода в режим наблюдения за подозреваемым. - 📡 **Discord Integration**: Улучшенные вебхуки с указанием ника игрока и действия. - Команда `/ags internal spectate <player>` (внутренняя). - **Стабильность и Исправления**: - ✅ Исправлено отключение плагина при первом запуске (авто-создание `messages.yml`). - ✅ `DatabaseManager`: Добавлен авто-реконнект к базе данных (fix `connection closed`). - ✅ `LocaleManager`: Исправлена ошибка "Message not found" для ключей в корне файла. - ✅ `Dependency Loading`: Автоматическая загрузка драйверов SQLite через `libraries` (Paper 1.21+). ### 🇬🇧 Added (EN) - **Alerts & Spectator System**: - 🎨 **Premium Design**: New gradient colors for in-game notifications. - 👁️ **Click-to-Spectate**: Clickable **[SPECTATE]** button to instantly teleport to potential griefers. - 📡 **Discord Integration**: Enhanced webhooks with player names. - **Stability & Fixes**: - ✅ Fixed plugin disabling on first launch (auto-create `messages.yml`). - ✅ `DatabaseManager`: Added auto-reconnect logic to prevent `connection closed` errors. - ✅ `LocaleManager`: Fixed "Message not found" error for root keys. - ✅ `Dependency Loading`: Native support for `libraries` loading (SQLite/HikariCP) on Paper 1.21+.

# Changelog ## [2.2.0] - 2026-01-14 ### Added - **Secure Feedback System**: New feature allowing players to send feedback/bug reports directly to Discord. - Command: `/feedback send <message>` (Permission: `plugin.feedback.send`). - Command: `/feedback history` (Permission: `plugin.feedback.history`). - **Security**: - AES/GCM encryption for Discord Webhook URL. - Obfuscated key generation to prevent string analysis. - Zero plain-text tokens in source code. - **Database**: - Migrated to **HikariCP** for connection pooling and better performance. - Added `feedback_history` table. - **Architecture**: - New package `features.feedback` following Package by Feature. - Async execution for all network and DB operations. ### Добавлено (RU) - **Безопасная система обратной связи**: Новая функция для отправки отзывов/баг-репортов в Discord. - Команда: `/feedback send <сообщение>` (Право: `plugin.feedback.send`). - Команда: `/feedback history` (Право: `plugin.feedback.history`). - **Безопасность**: - AES/GCM шифрование для URL вебхука Discord. - Обфускация генерации ключа для защиты от строкового анализа. - Полное отсутствие токенов в открытом виде в коде. - **База Данных**: - Переход на **HikariCP** для пулинга соединений (лучшая производительность). - Добавлена таблица `feedback_history`. - **Архитектура**: - Новый пакет `features.feedback` (Package by Feature). - Асинхронное выполнение всех операций с сетью и БД. ## [2.1.0] - Initial refactoring and cleanup.

# Changelog ## [2.1.0] - 2026-01-09 ### ✨ New Features * **Multi-language Support**: Added ability to switch languages in `config.yml`. Pre-installed languages: English (`en`) and Russian (`ru`). * **Discord Webhook Templates**: Completely redesigned Discord notifications. * Added `discord.yml` for fully customizable webhook templates. * Notifications now use rich Embeds with titles, descriptions, footers, and timestamps. * Added support for hex colors and placeholders. * **Tab Completion**: Added smart auto-completion for `/ags` command (subcommands and player names). * **Mechanism Protection**: Added protection against restricted items being used by Redstone mechanisms (Dispensers/Droppers). Discord notifications now include coordinates of the suspicious mechanism. * **Modern Formatting**: Full support for **MiniMessage** (RGB gradients, clickable text, hover events) instead of legacy color codes. ### 🛠️ Key Changes * **Java 21**: Project updated to support Java 21 and Paper 1.21.1 API. * **Thread Safety**: Fixed critical threading issues in DatabaseManager that could cause server crashes. * **Optimization**: Prepared HikariCP integration for better database performance. --- ## ⚠️ Migration Guide (v1.x -> v2.1.0) This update introduces **BREAKING CHANGES** to configuration files. Please follow these steps to migrate safely: 1. **Backup**: Make a backup of your `plugins/AntiGriefSystem` folder and your database (`database.db`). 2. **Delete `messages.yml`**: The old `messages.yml` uses legacy color codes (`&a`, `&c`) which are **no longer supported**. You must delete this file. * *Note*: The plugin will generate new `messages_en.yml` and `messages_ru.yml` files automatically. 3. **Update `config.yml`**: * Add the `language` option to your `config.yml`: ```yaml # Language: en or ru language: en ``` * *Alternatively*: You can delete `config.yml` to let the plugin regenerate it with new defaults. 4. **Configure Discord**: * A new file `discord.yml` will be created. You can customize the look and feel of your Discord notifications there. * Ensure your `discord-webhook-url` in `config.yml` is correct. ### Common Issues * **"Missing message: key"**: This means you are using an old language file. Delete `messages.yml` and restart. * **Colors not working**: Ensure you are using MiniMessage format (e.g., `<red>`, `<gradient:red:blue>`) instead of `&` codes. --- # Список изменений (на русском) ## [2.1.0] - 2026-01-09 ### ✨ Новые функции * **Мультиязычность**: Добавлена возможность переключения языков в `config.yml`. Предустановленные языки: Английский (`en`) и Русский (`ru`). * **Шаблоны вебхуков Discord**: Полностью переработаны уведомления в Discord. * Добавлен файл `discord.yml` для полной настройки шаблонов вебхуков. * Уведомления теперь используют красивые Embed-сообщения с заголовками, описанием, футером и временной меткой. * Добавлена поддержка HEX-цветов и плейсхолдеров. * **Автоподсказки (Tab Completion)**: Добавлено умное автодополнение для команды `/ags` (подкоманды и ники игроков). * **Защита механизмов**: Добавлена защита от использования запрещенных предметов через редстоун-механизмы (Раздатчики/Выбрасыватели). Уведомления в Discord теперь содержат координаты подозрительного механизма. * **Современное форматирование**: Полная поддержка **MiniMessage** (RGB-градиенты, кликабельный текст, наведение) вместо устаревших цветовых кодов. ### 🛠️ Ключевые изменения * **Java 21**: Проект обновлен для поддержки Java 21 и API Paper 1.21.1. * **Потокобезопасность**: Исправлены критические ошибки многопоточности в DatabaseManager, которые могли приводить к падению сервера. * **Оптимизация**: Подготовлена интеграция HikariCP для лучшей производительности базы данных. --- ## ⚠️ Руководство по миграции (v1.x -> v2.1.0) Это обновление вносит **КРИТИЧЕСКИЕ ИЗМЕНЕНИЯ** в файлы конфигурации. Пожалуйста, следуйте инструкции для безопасного перехода: 1. **Бэкап**: Сделайте резервную копию папки `plugins/AntiGriefSystem` и вашей базы данных (`database.db`). 2. **Удалите `messages.yml`**: Старый файл `messages.yml` использует устаревшие цветовые коды (`&a`, `&c`), которые **больше не поддерживаются**. Вы должны удалить этот файл. * *Примечание*: Плагин автоматически сгенерирует новые файлы `messages_en.yml` и `messages_ru.yml`. 3. **Обновите `config.yml`**: * Добавьте опцию `language` в ваш `config.yml`: ```yaml # Language: en or ru language: en ``` * *Альтернативный вариант*: Вы можете удалить `config.yml`, чтобы плагин сгенерировал его заново с новыми настройками по умолчанию. 4. **Настройте Discord**: * Будет создан новый файл `discord.yml`. В нем вы можете настроить внешний вид уведомлений Discord. * Убедитесь, что ваш `discord-webhook-url` в `config.yml` указан верно. ### Частые проблемы * **"Missing message: key"**: Это означает, что вы используете старый файл языков. Удалите `messages.yml` и перезагрузите сервер. * **Цвета не работают**: Убедитесь, что вы используете формат MiniMessage (например, `<red>`, `<gradient:red:blue>`) вместо кодов `&`.

# Changelog All notable changes to the "AntiGriefSystem" project will be documented in this file. ## [2.0] - 2025-12-27 ### Added - **Restricted Items**: Expanded the `restricted-items` list in `config.yml` to include: - `TNT` - `TNT_MINECART` - `END_CRYSTAL` - `RESPAWN_ANCHOR` - `LAVA_BUCKET` - `FLINT_AND_STEEL` - `FIRE_CHARGE` - `HOPPER` - `HOPPER_MINECART` - **Configuration**: Increased `trusted-playtime-needed-minutes` to 360 minutes (6 hours). ### Fixed - **Listeners**: Fixed `RestrictionListener` to correctly prevent interactions with restricted blocks (e.g., Hoppers). - **Logic**: Resolved issues with playtime calculation for the trust system. ### Changed - **Environment**: Updated build configuration to use Java 11 and Paper 1.21.

# Version 1.3 ## Bug Fixes - Fixed trusted player status being lost on server restart ## Improvements - Improved data persistence system using YAML storage - Added automatic data saving every minute - Added immediate data saving when trusted status changes - Improved error handling and logging - Added better UUID validation - Made file operations more robust - Added automatic directory creation - Optimized data saving to prevent unnecessary file writes

# Version 1.2 **Added Features:** * **Data Persistence:** Implemented saving and loading of player playtime and trusted status to `data.yml` to ensure data is kept across server restarts. * **Reload Command:** Added the `/ags reload` command to allow administrators to reload the plugin's configuration and data without needing to restart the server. * **Remove Trusted Command:** Introduced the `/trusted remove <player>` command for administrators to manually remove trusted status from a player. * **Discord Integration:** Added support for sending configurable notifications about specific events (restricted item usage, trusted status changes) to a Discord webhook. * **Configurable Messages:** Messages for in-game commands and Discord notifications are now customizable via language files (`lang/en.yml`, `lang/ru.yml`, etc.). * **Configurable Restricted Items:** The list of items restricted for non-trusted players can now be configured in `config.yml`. * **Language Support:** The plugin now supports multiple languages through separate language files in the `lang` directory. **Improvements:** * Improved handling of player playtime tracking. * Refactored configuration and data management into separate classes (`ConfigManager`, `DataManager`). * Enhanced Discord webhook handling with better error reporting and JSON escaping. **Bug Fixes:** * Fixed issues with message display after plugin reload. * Addressed potential `IllegalArgumentException` related to invalid Discord webhook URLs.