ServerUtils

ServerUtils - это незаменимый инструмент для администраторов Minecraft-серверов. Он решает главную проблему: перезагрузку сервера каждый раз, когда нужно обновить или заменить плагин. С ServerUtils вы можете управлять плагинами прямо в игре: перезагружать, выгружать, загружать новые из папки plugins - всё на лету, без простоев.

Поддерживает Spigot/Paper, BungeeCord/Waterfall и Velocity, так что подойдёт для любых серверов.

Что умеет ServerUtils

• Заменяет стандартные команды /pl и /plugins (Bukkit) на более информативные - с флагом -v показывает версии плагинов. Оригинальные команды /bukkit:pl и /bukkit:plugins остаются доступными.
• Для BungeeCord есть своя команда /bpl с флагами -v (версии) и -m (модули).
• Перезагрузка плагинов на лету: /su loadplugin, /su reloadplugin, /su unloadplugin. Табы работают, можно быстро подгрузить новый .jar.
• Слежение за файлами плагинов: включи /su watchplugin, и ServerUtils сам перезагрузит плагин при изменении файла.
• Выгрузка неиспользуемых команд (Spigot/Paper) - настраивается в конфиге. Команды исчезают для игроков и консоли.
• При перезагрузке плагина чистит PluginClassLoader и рецепты (для версий 1.12+; на более старых рецепты не привязаны к плагину).
• Сам ServerUtils может обновляться и перезагружаться - прикольная фишка.
• Перезагрузка commands.yml без перезапуска сервера (работает на 1.8-1.16).
• Перезагрузка bukkit.yml на лету (тоже 1.8-1.16). Конфиги Spigot/Paper так не перегружаются, для них есть /paper reload или /spigot reload.
• Автоматическое обновление: можно настроить скачивание и установку новых версий при старте сервера или по проверке. По умолчанию отключено.
• API событий для других плагинов: ServerUtils уведомляет о загрузке, включении, выключении и выгрузке компонентов (Pre и Post стадии).

Стадии загрузки плагина (Spigot/Paper)

Чтобы понимать разницу между загрузкой, включением, выключением и выгрузкой:

1. Загрузка - плагин считывается из .jar, появляется в списке, но пока не активен (красный).
2. Включение - плагин запускается, появляются его команды и слушатели.
3. Выключение - плагин теряет функционал, но остаётся в памяти (красный).
4. Выгрузка - плагин полностью удаляется из памяти и списка.

Предупреждение

Перезагрузка плагинов может работать не со всеми плагинами. Если плагин зависит от перезагружаемого, могут возникнуть ошибки. Плохая очистка или кривой код тоже могут сломать процесс. Будьте осторожны.

Статистика

Статистика использования плагина доступна на bStats.

Сборка ServerUtils

Есть два способа собрать плагин из исходников:

1. Установка Gradle (рекомендуется)

• Установите Gradle.
• Выполните gradle build.

2. Через wrapper

Windows: gradlew.bat build Linux/macOS: ./gradlew build

Developer API

Репозиторий и зависимости

Если нужны снапшот-версии, используйте репозиторий:

https://repo.fvdh.dev/snapshots

Gradle:

repositories {
  maven("https://repo.fvdh.dev/releases")
}

dependencies {
  compileOnly("net.frankheijden.serverutils:ServerUtils:VERSION")
}

Maven:

<project>
  <repositories>
    <repository>
      <id>fvdh</id>
      <url>https://repo.fvdh.dev/releases</url>
    </repository>
  </repositories>
  
  <dependencies>
    <dependency>
      <groupId>net.frankheijden.serverutils</groupId>
      <artifactId>ServerUtils</artifactId>
      <version>VERSION</version>
      <scope>provided</scope>
    </dependency>
  </dependencies>
</project>

Команды и права доступа

Подробный список команд и прав доступа описан в вики-разделе проекта.