ServerUtils

插件

· 作者 FrankHeijden

重新加载插件 - 卸载未使用的命令 - PluginWatcher - Command/PluginInfo - 自动更新器

0 本站下载 0 关注 更新于 3 年前

最新 3.5.4 · 1.19.3 · Bukkit / BungeeCord

一键开服(送7天)

ServerUtils

ServerUtils 允许你在游戏中管理你的插件。 支持在运行时从 plugins 文件夹重新加载、卸载和加载插件。 ServerUtils 还提供便捷的方法来查找命令和插件, 并提供有关它们的有用信息。

GitHub Actions

功能特性

  • 兼容 Spigot/Paper、BungeeCord/Waterfall 和 Velocity!
  • 替换(可禁用)/pl 和 /plugins (bukkit) 命令为自定义消息格式的插件版本列表。添加 -v 标签将在输出中包含所有版本!请注意:命令 [plain]/bukkit:pl[/plain] 和 [plain]/bukkit:plugins[/plain] 不会被替换,因此你仍然可以使用它们!
  • 一个整洁且可配置的 BungeeCord 插件命令 /bpl!使用 -v 标志输出插件的版本,使用 -m 标志在插件列表中包含模块(例如 cmd_send.jar, cmd_server.jar 等)。
  • 通过 /su (load/reload/unload)plugin <plugin> 即时重载插件!(BungeeCord:主命令是 /bsu)支持 Tab 补全,以便快速从 plugins 文件夹中的 jar 包加载新插件 :)
  • 监听插件文件的变化并自动重新加载它们!使用 /su watchplugin!
  • 卸载未使用的命令 (spigot/paper):你可以在配置文件中定义哪些命令将由 ServerUtils 在启动时卸载。这些命令将不再对任何游戏内玩家或控制台可用。
  • 重新加载插件并清理相关资源,如 PluginClassLoader 及其配方。配方清理仅适用于 1.12+ 版本,因为在低于该版本的 Minecraft 中,插件不与特定配方关联,因此 ServerUtils 无法知道某个配方属于哪个插件。
  • ServerUtils 还可以自我重启/更新,作为一个小彩蛋 (:
  • 无需执行整个服务器重载或重启即可即时重载 commands.yml!这对于快速创建别名非常有用。请注意:目前这仅在 1.8 - 1.16 版本上有效。
  • 无需执行整个服务器重载或重启即可即时重载 bukkit 配置文件!请注意:某些配置选项可能不会被重新加载,如果你认为这是错误,请与我联系。Spigot/Paper 配置文件不会被重新加载,你可以使用 /paper reload 或 /spigot reload 来重新加载它们。请注意:目前这仅在 1.8 - 1.16 版本上有效。
  • 自动更新器。插件可以配置为在服务器启动或检查更新时自动下载并安装新版本。此功能默认关闭,但可以在每个配置文件中精确配置。 插件可以监听变化!ServerUtils 提供了一个事件 API,可以精确通知插件各个组件何时被加载、启用、禁用或卸载——并且都包含 Pre(前置)和 Post(后置)阶段。请查看 Bukkit 和 Bungee 的事件!

插件的加载阶段 (Spigot/Paper):

为了理解加载 / 启用 / 禁用 / 卸载插件之间的区别,我将描述以下加载阶段:

完全加载一个插件(如启动时):

  1. 首先,插件从 plugins 目录中的 .jar 文件加载。这称为插件加载。此时插件在 /plugin 列表中显示为“红色”,因为它尚未启用。
  2. 在第二步中,插件被启用。这会导致插件在控制台中输出各种信息(开发者认为在启动时需要通知你的内容),例如设置数据库连接等。

完全禁用一个插件(如同关闭服务器)

  1. 首先,插件会被禁用。这会导致插件失去其所有功能,例如命令、事件监听器等。禁用后,插件仍会保留在内存中加载状态,但在 /plugin 列表中显示为“红色”。
  2. 随后,插件将从内存中卸载,因此它将不再出现在 /plugin 列表中。

免责声明 ‼️

请注意,重新加载可能并不兼容所有插件!依赖于被重新加载的插件的其他插件,在重新加载时很可能出现错误。清理不当或启动实践不规范也可能导致插件(重新/取消)加载失败。请谨慎操作!

统计数据

编译 ServerUtils

有两种方式可以编译 ServerUtils:

1. 安装 Gradle(推荐)

  1. 确保您已安装 Gradle。
  2. 运行 gradle build 以使用依赖项进行编译。

2. 使用 Wrapper

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

开发者 API

仓库 / 依赖

如果您希望使用 ServerUtils 的快照版本,可以使用以下仓库:

https://repo.fvdh.dev/snapshots

Gradle:

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

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

Maven:

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

命令与权限

有关命令和权限的最新概览,请参阅 Wiki 页面。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源