- 支持核心
- Paper / Purpur / Folia / Spigot / CraftBukkit
- 原创/转载
- 原创插件
- 作者
- Alignment
- 前置
- 无前置
- 支持版本
- 1.8-1.26
RanLoader —— 免重启热加载插件管理器(全版本 1.8–1.26)
目录
插件特性
真·热加载:把新插件 jar 放进 plugins 目录,一条命令即可加载运行,全程无需重启服务器,在线玩家不掉线。
热重载配置:对已加载插件执行 disable + enable,刷新配置文件不用重启。
热启用 / 热停用:随时启用或停用某个已加载插件(停用后 jar 仍在,重启会自动恢复)。
智能扫描:一键列出 plugins 目录下尚未加载的 jar,直接给出加载命令。
插件详情:查看任意已加载插件的版本、作者、主类、状态。
安全更新模式:检测到同名插件已在运行时,拒绝危险的类替换并给出 3 种安全方案,绝不污染服务器状态。
全版本兼容:编译为 Java 8 字节码,仅依赖 1.8 起就存在的 Bukkit 标准 API,1.8.x ~ 最新版服务端通吃。
适用版本与兼容性
| 服务端 | 支持情况 |
| Paper / Purpur / Folia(1.8 – 1.26,Java 8+) | |
| Spigot / CraftBukkit(1.8 – 1.26) | |
| BungeeCord / Velocity(代理端) | |
| Forge / Fabric / NeoForge(纯模组端) |
安装方法
- 下载 RanLoader-1.0.0.jar。
- 放入服务器的 plugins 目录。
- 重启一次服务器(仅首次安装需要,让 RanLoader 自身被加载)。
- 之后所有插件操作都可以通过 /hl 命令免重启完成。
命令一览
主命令:/hotload(简写别名 /hl),需权限 ranloader.admin(默认 OP 拥有)。| 命令 | 说明 |
| /hl scan | 列出 plugins 目录里尚未加载的 jar,并给出加载命令 |
| /hl load <文件.jar> | 热加载并启用一个 jar(不用重启服务器) |
| /hl reload <插件名> | 重载已加载插件(disable+enable,刷新配置,代码不变) |
| /hl update <文件.jar> | 热替换已加载插件(换新版 jar,含安全模式保护) |
| /hl enable <插件名> | 启用一个已加载但未启用的插件 |
| /hl disable <插件名> | 停用插件(不卸载,jar 仍在,重启自动启用) |
| /hl list | 列出所有插件及启用状态 |
| /hl info <插件名> | 查看插件详情(版本 / 作者 / 主类 / 状态) |
权限
| 权限节点 | 说明 | 默认 |
| ranloader.admin | 允许使用全部 /hl 命令 | OP |
使用示例
重要说明与边界
- “热加载新 jar”是 100% 安全的:只要这个插件名当前没在服务器里,RanLoader 就能免重启加载它。
- “热替换同名插件”走安全模式:以 Paper 1.19+ 为代表的新版服务端,插件以 provider 为单位注册,运行期替换同名插件的类会破坏内部状态。因此当同名插件已在运行时,RanLoader 不会强行替换,而是提示你三选一:
- 只刷新配置 → /hl reload <插件名>
- 真正换代码 → 重启服务器(新版 jar 已在 plugins,重启即生效)
- 必须免重启 → 先 /hl disable <插件名>,再把新 jar 以不同插件名放置后 /hl load
- 老版本 Spigot / CraftBukkit 同样支持加载“从未加载过的新 jar”,但重复加载同名类容易冲突——这是服务端固有限制,非本插件缺陷。
- 热加载后的 jar 已经落到 plugins 目录,下次服务器重启会按常规流程自动正常加载,无需额外处理。
常见问题 FAQ
Q:这个插件会让我的服务器变卡或崩服吗?A:不会。它只调用 Bukkit / Paper 公开的 PluginManager.loadPlugin / enablePlugin / disablePlugin API,不做任何反射改造运行中的服务端,行为稳定可控。
Q:能热加载带 Lib 依赖的插件吗?
A:可以。只要把插件 jar 及其依赖按该插件原作者要求放好(通常依赖 jar 也要在 plugins 目录或指定 lib 目录),再 /hl load 即可。
Q:为什么 /hl update 有时会提示“不执行热替换”?
A:见上方“重要说明与边界”——这是为了保护服务器状态的安全设计,不是 bug。按提示三选一即可。
Q:支持 1.7.10 或更早版本吗?
A:本插件编译目标为 Java 8,最低支持 1.8.x。更早的服务端(1.7.10 等)需 Java 7 及以下,不在支持范围。
更新日志
- v1.0.0(2026-11)
- 首版发布:热加载 / 热重载 / 热启用 / 热停用 / 扫描 / 详情。
- 编译目标降至 Java 8,依赖 spigot-api 1.8.8,实现 1.8–1.26 全版本兼容。
- 引入 update 安全模式,规避同名插件运行期类替换风险。