AutoPluginLoader » 1.13 - 1.21.11 - AutoPluginLoader - 自动插件加载器

AutoPluginLoader (APL) 是一款强大的 Bukkit/Spigot/Paper 插件，它能自动检测并加载或重载你上传到服务器插件文件夹中的插件，无需重启服务器，极大简化了插件管理流程。

💡核心特性

• 自动插件管理：上传插件文件后自动加载新插件，或自动重载已更新的插件。
• 依赖处理：支持自动重载插件的依赖项，确保功能完整。
• 广泛兼容：支持小型、大型服务器以及模组服务器，兼容各种大小的插件。
• 高度可配置：所有消息和设置均可通过配置文件自定义。
• 灵活控制：可开关提示消息，并可指定忽略某些插件。
• 便捷操作：支持命令补全（Tab Completion）。
• 无依赖：开箱即用，无需其他前置插件。
• Folia 支持：兼容 Folia 服务器核心。

提示消息

当以下事件发生时，拥有权限的玩家会收到提示

• 插件被自动重载。
• 插件被自动加载。

🎮权限列表

使用以下权限节点来控制对插件功能的访问

• AutoPluginLoader.Alerts - 当插件被自动重载/加载时接收提示。
• AutoPluginLoader.Commands - 查看和使用所有命令（使用其他命令的前提）。
• AutoPluginLoader.Load - 加载一个插件。
• AutoPluginLoader.Unload - 卸载一个插件。
• AutoPluginLoader.Reload - 重载一个插件。
• AutoPluginLoader.Usage - 查看指定插件的命令列表。
• AutoPluginLoader.Info - 查看指定插件的详细信息。
• AutoPluginLoader.List - 查看服务器上的插件列表。
• AutoPluginLoader.ReloadConfig - 重载 config.yml 配置文件。
• AutoPluginLoader.Version - 查看 APL 当前加载的版本。
• AutoPluginLoader.History - 查看 APL 的操作历史记录。

🔧配置文件 (config.yml)

配置文件允许你深度定制插件行为，主要分为以下几个部分：

消息自定义

你可以修改插件发送的所有提示和消息的格式与颜色，包括：

• 核心提示（插件自动更新/加载）
• 命令列表框架
• 通用响应（如无权限、无效插件等）
• 历史记录显示格式
• 插件状态消息（如加载成功、失败等）
• 命令用法提示

更新检查器

• update-check.enabled：是否启用更新检查。
• update-check.permission：接收更新提示所需的权限（默认为 autopluginloader.update）。
• update-check.message：发现新版本时发送的消息。

核心设置

• Your-Plugins-Folder：插件文件夹路径（通常为 plugins）。
• Automatically-Load-Plugins：是否自动加载新插件。
• Automatically-Update-Plugins：是否自动更新（重载）已修改的插件。
• 请注意：此功能仅检测本地插件文件的更改并重载，不会从网络自动下载更新。
• 任务计时（单位：秒）：
• Load-Data-Delay：初始数据加载延迟（必须小于 Timer-Delay）。
• Task.Timer-Delay：首次扫描前的等待时间（必须大于 Load-Data-Delay）。
• Task.Timer：检查插件文件夹的时间间隔。
• Seconds-Before-Reloading：修改后的 jar 文件触发重载前的最小存在时间。
• Seconds-Before-Loading：上传新 jar 文件后，尝试加载前的等待时间。
• 依赖与提示：
• Always-Reload-A-Plugins-Dependencies：是否总是重载插件的依赖。若为 false，则需在卸载时使用 -d 标志来重载依赖。
• Send-Players-Alerts：是否向玩家发送提示（玩家需有 AutoPluginLoader.Alerts 权限）。
• 忽略插件列表 (Plugins-To-Ignore)：指定不会被自动加载或更新的插件。默认已包含 AutoPluginLoader（防止递归问题）以及 Skript、WorldEdit 等。

✨API 接口

开发者可以通过以下 API 方法集成或扩展 APL 功能：

• APLMain.PluginAPI.loadPlugin(File plugin); - 加载一个插件（必须在启用插件之前调用）。
• APLMain.PluginAPI.enablePlugin(Plugin plugin); - 启用一个插件（必须先加载）。
• APLMain.PluginAPI.getPlugin(String s); - 根据字符串名称获取 Plugin 对象。
• APLMain.PluginAPI.getPlugins(); - 以 ArrayList<Plugin>() 形式返回所有插件。
• APLMain.PluginAPI.getPluginsInAlphabeticalOrder(); - 以字母顺序返回所有插件的 ArrayList<Plugin>()。
• APLMain.PluginAPI.disablePlugin(Plugin plugin); - 禁用一个插件（建议先卸载）。
• APLMain.PluginAPI.reloadPlugin(Plugin plugin); - 禁用然后启用一个插件（不会刷新插件中的新代码）。
• APLMain.PluginAPI.unloadPlugin(Plugin plugin, Boolean ReloadDependents); - 卸载一个插件，并选择是否重载其依赖项。
• APLMain.PluginAPI.getDescription(File file); - 返回一个文件的 PluginDescriptionFile。
• APLMain.PluginAPI.getFile(JavaPlugin plugin); - 从插件对象获取其文件。

❓支持与反馈

获取支持的最快方式是加入资源 Discord 服务器：

» https://discord.gg/2vUqykD

**重要提示**

• 请不要因遇到的问题留下差评。请直接私信我或在讨论区留言，谢谢。
• 你的评价和反馈对我们非常重要！

**我的其他插件**

（此处可列出作者的其他插件链接）