# FlorestDiscordPro (FDP)
**FlorestDiscordPro** — это профессиональный плагин для бесшовной интеграции Minecraft-сервера (Spigot/Paper) с вашим Discord-сообществом. Это мощная и асинхронная эволюция проекта *FlorestTelegramPRO*, созданная для полного контроля над сервером через Discord.
> **Лицензия:** [The Unlicense]( https://unlicense.org/) (Public Domain). Код свободен для любого использования.
---
## ✨ Основные возможности
* ** Синхронизация чата:** Трансляция сообщений между игрой и Discord (с поддержкой ответов/replies).
* ** Поддержка Webhooks:** Сообщения в Discord отправляются с никами и скинами игроков (интеграция с *SkinsRestorer*).
* ** Мониторинг TPS:** Автоматическое отслеживание производительности. Уведомление в Discord, если сервер начинает лагать.
* ** Дистанционная модерация:** Управление банами и мутами прямо из Discord-канала.
* **️ Трекер команд:** Логирование действий игроков (команд) в реальном времени.
* ** Динамический статус:** Отображение текущего онлайна сервера в статусе бота.
* ** Достижения и события:** Трансляция получения достижений, входа и выхода игроков на сервер.
---
## Команды и права
| Команда | Описание | Право (Permission) |
| :--- | :--- | :--- |
| `/fdp reload` | Перезагрузить конфигурацию | `florestdiscord.admin` |
| `/fdp ban <ID>` | Забанить пользователя через систему бота | `florestdiscord.admin` |
| `/fdp mute <ID>` | Замутить пользователя через систему бота | `florestdiscord.admin` |
---
## ⚙️ Документация конфигурации (config.yml)
Ниже представлен разбор основных узлов конфига:
### 1. Подключение
* `discord_bot_token`: Токен вашего бота из панели разработчика Discord.
* `discord_channel_id`: ID канала, куда будут транслироваться все логи и чат.
### 2. Статус бота (`bot_status`)
* `status_type`: Визуальный статус (`online`, `idle`, `dnd`).
* `activity_text`: Текст активности (поддерживает плейсхолдер `{online}`).
* `activity_type`: Тип активности (`PLAYING`, `WATCHING`, `LISTENING`).
### 3. Мониторинг лагов (`tps_check`)
* `min_tps`: Если TPS упадет ниже этого значения, администрация получит уведомление.
* `alert_message`: Текст уведомления о лагах.
### 4. Вебхуки (`webhooks`)
* `enabled`: Включение красивого чата через вебхуки.
* `webhook_url`: Ссылка на вебхук из настроек канала Discord.
### 5. Трекер команд (`command_tracking`)
* `whitelist`: Команды, которые нужно логировать (напр. `all`).
* `blacklist`: Команды, которые логировать **нельзя** (пароли от `/login`, `/reg`).
### 6. Модерация (`moderation`)
* `admin_role_id`: ID роли в Discord, которой разрешено управлять ботом.
* `commands_from_discord`: Список доступных команд для исполнения через бота.
---
## Установка
1. Закиньте файл `FlorestDiscordPro.jar` в папку `/plugins/`.
2. Запустите сервер и настройте сгенерированный `config.yml`.
3. Перезагрузите плагин командой `/fdp reload`.
---
**Разработчик:** [FlorestDev]( https://github.com/florestdev)
*«Logic is my only law. Code is my only weapon.»*