Skip to content

Ru_README.md

Latest commit

 

History

History
121 lines (79 loc) · 6.66 KB

Ru_README.md

File metadata and controls

121 lines (79 loc) · 6.66 KB
Raw
DSPlugMan

DSPlugMan — Ультимативный аддон для PlugMan

🇺🇸 English Version

🔄 Дистанционное управление сервером Minecraft через Discord с полной интеграцией PlugMan

⚠️ Важное требование

DSPlugMan является аддоном для PlugManX.
Для работы большинства функций управления плагинами ОБЯЗАТЕЛЬНО должен быть установлен PlugMan или его современный форк PlugManX.

🚀 Основные возможности

🛠️ Интерактивное управление (GUI)

  • Меню выбора – команда /plugins выводит интерактивный список с выпадающим меню.
  • Кнопки управления – быстрые действия для каждого плагина: Включить, Выключить, Перезагрузить, Удалить.
  • Живое обновление – кнопка 🔄 Обновить мгновенно актуализирует список без повторного ввода команды.

📝 Удаленная консоль и мониторинг

  • Выполнение команд – команда /console позволяет отправлять любые команды в консоль сервера прямо из Discord.
  • Мониторинг статуса – /status показывает загрузку памяти, онлайн, аптайм и версию ядра сервера.
  • Управление конфигом – просматривайте и изменяйте настройки плагина через /config на лету.

📥 Умная загрузка плагинов

  • Загрузка по URL – /upload_plugin скачивает JAR-файл по прямой ссылке и автоматически активирует его.
  • Drag‑and‑drop – просто перетащите .jar в Discord-канал, и бот сам установит его на сервер.
  • Авто-релоад – если файл заменяет существующий плагин, бот автоматически его перезагрузит.

🔐 Безопасность и логирование

  • Роли и пользователи – доступ к командам можно ограничить по ID пользователя или по ID роли.
  • Белый список – команды /add_admin и /remove_admin для быстрого управления доступом.
  • Канал логов – все важные действия (удаление, консоль, загрузки) дублируются в отдельный лог-канал для аудита.

💻 Список команд

Управление плагинами

  • /plugins — вывести список всех плагинов с кнопками управления.
  • /reload_plugin <название> — перезагрузить конкретный плагин.
  • /enable <название> — включить плагин.
  • /disable <название> — выключить плагин.
  • /delete_plugin <название> — полностью удалить файл плагина с сервера.
  • /upload_plugin <url> [filename] — загрузить плагин по прямой ссылке.

Системные команды

  • /status — информация о состоянии сервера (RAM, игроки, аптайм).
  • /console <команда> — выполнить команду от имени консоли.
  • /reload — общая перезагрузка сервера (/reload).

Администрирование

  • /config [свойство] [значение] — просмотр и изменение настроек DSPlugMan.
  • /add_admin <user> — добавить пользователя в список администраторов бота.
  • /remove_admin <user> — удалить пользователя из списка администраторов.

📋 Требования

  • Ядро: Paper/Spigot 1.21.4
  • Java: 21
  • Зависимости: PlugManX (рекомендуется)
  • Discord: бот с включенным Message Content Intent в панели разработчика.

🛠️ Установка

  1. Соберите проект: ./gradlew shadowJar (JAR будет в build/libs/).
  2. Поместите JAR-файл в папку plugins/ вашего сервера.
  3. Запустите сервер для генерации config.yml.
  4. В конфигурации укажите:
    • token – токен вашего Discord бота.
    • guild-id – ID вашего сервера Discord.
    • channel-id – ID канала для управления сервером.
    • admin-users – (опционально) список Discord ID администраторов.
    • management-role-id – (optional) ID роли с доступом к командам.
  5. Перезагрузите плагин или перезапустите сервер.

🌐 Настройка языка

Вы можете изменить язык бота в config.yml. Поддерживаемые языки: en (английский), ru (русский).

language: "ru"

Известные проблемы

  • Удаление плагинов: в некоторых окружениях удаление плагина может завершиться ошибкой из-за блокировки файлов или ограничений PlugManX (JAR-файл остается на диске или используется). Более надежный процесс удаления запланирован в будущих обновлениях.

🔗 Ссылки

DSPlugMan — твой Minecraft-сервер всегда под рукой. 🔌✨