ServerUtils - Manage plugins in-game! - ServerUtils - 插件管理器

ServerUtils 是一款强大的服务器管理插件，兼容 Spigot/Paper、BungeeCord/Waterfall 和 Velocity 平台。它提供了插件热重载、配置管理、自定义插件列表等高级功能，旨在帮助服主更灵活、更安全地管理服务器。

💡核心特性

插件管理

• 热重载插件：使用 /su loadplugin/reloadplugin/unloadplugin <插件名> 命令（BungeeCord 为 /bsu，Velocity 为 /vsu）动态加载、重载或卸载插件，无需重启服务器。
• 插件状态监控：使用 /su watchplugin 监控插件文件变化并自动重载。
• 插件信息查询：使用 /su plugininfo 和 /su commandinfo 查看插件或命令的详细信息。
• 插件生命周期管理：支持独立控制插件的加载、启用、禁用和卸载阶段。

配置与命令管理

• 动态重载配置：使用 /su reloadconfig 重载 commands.yml 和 Bukkit 配置文件（仅限 1.8-1.16 版本）。
• 命令清理：可在配置中定义需要卸载的命令，ServerUtils 将在启动时移除它们。
• 自定义插件列表：替换原版 /pl 或 /plugins 命令，输出可自定义的插件列表。使用 -v 标志可显示插件版本，BungeeCord 的 /bpl 命令还支持 -m 标志来显示模块。

其他实用功能

• 自动更新器：可配置在服务器启动或检查更新时自动下载并安装 ServerUtils 的新版本。
• 自我重载：ServerUtils 可以完全卸载并重新加载自身。
• 事件 API：为其他插件提供事件，以便监听插件组件的加载、启用、禁用和卸载状态（包含 Pre 和 Post 阶段）。

🎮命令与权限

主要命令

• /su 或 /su help - 显示帮助页面。权限：serverutils.help
• /su reload - 重载 ServerUtils 插件配置。权限：serverutils.reload
• /su restart - 重启 ServerUtils 插件。权限：serverutils.restart
• /su reloadconfig - 重载服务器配置文件。权限：serverutils.reloadconfig
• /su loadplugin <插件名> - 加载并启用插件。权限：serverutils.loadplugin
• /su unloadplugin <插件名> - 卸载插件。权限：serverutils.unloadplugin
• /su enableplugin <插件名> - 启用插件。权限：serverutils.enableplugin
• /su disableplugin <插件名> - 禁用插件。权限：serverutils.disableplugin
• /su plugininfo <插件名> - 显示插件信息。权限：serverutils.plugininfo
• /su commandinfo <命令> - 显示命令信息。权限：serverutils.commandinfo
• /su reloadplugin <插件名> - 重载插件。权限：serverutils.reloadplugin
• /su watchplugin <插件名> - 监控插件文件变化。权限：serverutils.watchplugin
• /su unwatchplugin <插件名> - 停止监控插件。权限：serverutils.watchplugin

插件列表命令

• /pl 或 /plugins - 显示服务器插件列表。权限：serverutils.plugins
• /pl -v - 显示带版本的插件列表。权限：serverutils.plugins.version

跨平台命令

• BungeeCord/Waterfall：主命令为 /bsu，插件列表命令为 /bpl。
• Velocity：主命令为 /vsu，插件列表命令为 /vpl。

所有命令均支持别名和标签补全，具体可在 commands.yml 中配置。

🔧配置说明

config.yml 主要选项

settings:
  disable-plugins-command: false # 是否禁用原版插件命令
  check-updates-boot: true # 启动时检查更新
  download-updates-boot: false # 启动时下载更新
  install-updates-boot: false # 启动时安装更新
disabled-commands: [] # 需要卸载的命令列表
unload-after-startup:
  delay-ticks: 20
  plugins: [] # 启动后延迟卸载的插件
hide-plugins-from-plugins-command: [] # 在插件列表中隐藏的插件
protected-plugins: [] # 受保护的插件（禁止操作）

messages.yml

此文件用于自定义插件发送的所有消息格式，包括前缀、错误提示、成功信息等。

commands.yml

此文件用于自定义所有命令的主命令、别名、权限和描述。

❓重要须知与兼容性

插件重载说明

• 加载阶段：从 JAR 文件加载插件，此时插件在列表中显示为红色（未启用）。
• 启用阶段：启用插件，执行其 onEnable() 方法。
• 禁用阶段：禁用插件，使其功能失效，但仍在内存中（列表中显示为红色）。
• 卸载阶段：将插件从内存中完全移除。

注意事项

• 插件重载可能不兼容所有插件。依赖被重载插件的插件容易出错。
• 不规范的清理或启动实践也可能导致重载失败，请谨慎操作。
• /bukkit:pl 和 /bukkit:plugins 命令不会被替换，可作为备用。
• 配方清理功能仅适用于 1.12+ 版本。
• 动态重载 commands.yml 和 Bukkit 配置的功能仅适用于 1.8-1.16 版本。Spigot/Paper 的配置需使用 /paper reload 或 /spigot reload 重载。

✨支持与反馈

您可以通过 Discord 私信、GitHub 或本插件的讨论帖获取支持。祝您使用愉快！