ItsHim's Plugin Reloader (IPR)
!!! 此插件仍处于测试阶段,任何问题和数据丢失均由您自行承担风险 !!!
一款专为现代 Minecraft 服务器设计的强大、轻量且稳健的插件重载器。无需重启服务器或 Bungee 代理,即可轻松动态加载、卸载和重载插件。
功能特性
- 自动加载模式(默认开启): 当
plugins/ 文件夹中新增或更新插件 jar 文件时,自动加载新添加的插件 jar 文件并重新加载现有插件。
- 零停机时间: 动态重载、加载或卸载插件,无需重启服务器或代理。
- Folia 支持: 完全兼容 Folia 的多线程区域架构,同时也兼容 Paper、Spigot 和 Bukkit。
- 无内存泄漏卸载: 实施高级内存清理以防止内存泄漏:
- 注销已注册的事件和任务。
- 从服务器的命令映射中移除命令。
- 清理 Bukkit 内部的 SimplePluginManager 和 Paper 的 PluginInstanceManager。
- 移除事件执行器和类加载器(URLClassLoader 清理及 SafeClassDefiner 加载器移除)。
- 调用 JVM 垃圾回收以释放内存。
- 完整的 Tab 补全: 为子命令、已加载的插件名称以及
plugins/ 目录中可用的 .jar 文件提供实时自动补全建议(适用于 /ipr load)。
- 命令同步: 在加载/卸载后,立即自动同步命令并为所有在线玩家更新 Tab 补全。
- 多平台支持: 原生支持 Paper/Folia 和 BungeeCord(即将推出)。
命令与权限
所有命令都需要管理员权限:ipr.admin
主命令别名:/itshim
| 命令 |
描述 |
用法 |
/ipr load <jarFileName> |
从服务器的 plugins/ 目录加载新的或更新的插件(支持对 jar 文件名进行 Tab 补全)。 |
/ipr load MyPlugin.jar |
/ipr unload <pluginName> |
禁用并卸载插件,释放所有关联的系统资源。 |
/ipr unload MyPlugin |
/ipr unload all |
禁用并卸载除 ItsHim's Plugin Reloader 之外的所有插件。 |
/ipr unload all |
/ipr reload <pluginName> |
卸载插件并从其源 jar 文件重新加载。 |
/ipr reload MyPlugin |
/ipr reload all |
从源 jar 文件重新加载服务器上所有已加载的插件。 |
/ipr reload all |
/ipr list |
列出当前所有已加载的插件(按状态着色显示:Enabled / Disabled)。 |
/ipr list |
配置
插件文件夹中将生成默认的 config.yml:
# Auto-Load Mode
# Automatically loads newly added plugin jar files and reloads existing plugins when their jar files are updated.
autoload: true
平台支持
Paper / Folia / Spigot / Bukkit
- Minecraft 版本:
1.21 至 1.21.11 (Java 21) & 26.x.x (Java 25)
- 权限:
ipr.admin
BungeeCord
安装
- 下载
ItsHimsPluginReloader-Paper.jar(用于 Paper/Folia)或 ItsHimsPluginReloader-Bungee.jar(用于 BungeeCord)。
- 将 jar 文件放入服务器的
plugins/ 文件夹中。
- 启动您的服务器或代理。
- 使用
/ipr 或直接放置/更新 jars 来管理您的插件!
作者: _ItsHim_
注意: 虽然 ItsHim's Plugin Reloader 会对命令、监听器、调度任务和类加载器进行深度清理,但某些具有复杂外部库注册或持久化原生资源的插件可能仍会保留内存。在生产环境中,对于重大更新始终建议完全重启服务器,但 IPR 非常适合快速开发和次要更新!
ItsHim's Plugin Reloader (IPR)
!!! THIS PLUGIN IS IN THE TESTING FASE SO ANY ISSUES AND LOSS OF DATA IS AT YOUR OWN RISK !!!
A powerful, light-weight, and robust plugin reloader designed for modern Minecraft servers. Easily load, unload, and reload plugins on the fly without restarting your server or Bungee proxy.
Features
- Auto-Load Mode (On by Default): Automatically loads newly added plugin jar files and reloads existing plugins when their jar files are added or updated in the
plugins/ folder.
- Zero Downtime: Reload, load, or unload plugins dynamically without restarting the server or proxy.
- Folia Support: Fully compatible with Folia's multi-threaded region architecture, as well as Paper, Spigot, and Bukkit.
- Leak-Free Unloading: Implements advanced memory cleanup to prevent memory leaks:
- Unregisters registered events and tasks.
- Removes commands from the server's command map.
- Cleans up Bukkit's internal SimplePluginManager and Paper's PluginInstanceManager.
- Removes event executors and class loaders (URLClassLoader cleanup & SafeClassDefiner loader removal).
- Invokes JVM Garbage Collection to reclaim memory.
- Full Tab Completion: Real-time autocomplete suggestions for subcommands, loaded plugin names, and available
.jar files in the plugins/ directory (for /ipr load).
- Command Syncing: Automatically syncs commands and updates tab-completion for all online players immediately after loading/unloading.
- Multi-Platform Support: Native support for both Paper/Folia and BungeeCord (soon).
Commands & Permissions
All commands require the administrator permission: ipr.admin
Main command alias: /itshim
| Command |
Description |
Usage |
/ipr load <jarFileName> |
Loads a new or updated plugin from your server's plugins/ directory (supports tab-completing jar filenames). |
/ipr load MyPlugin.jar |
/ipr unload <pluginName> |
Disables and unloads a plugin, freeing up all associated system resources. |
/ipr unload MyPlugin |
/ipr unload all |
Disables and unloads all plugins except ItsHim's Plugin Reloader. |
/ipr unload all |
/ipr reload <pluginName> |
Unloads the plugin and loads it again from its source jar file. |
/ipr reload MyPlugin |
/ipr reload all |
Reloads all loaded plugins on the server from their source jar files. |
/ipr reload all |
/ipr list |
Lists all currently loaded plugins (color-coded by state: Enabled / Disabled). |
/ipr list |
Configuration
A default config.yml is generated in the plugin folder:
# Auto-Load Mode
# Automatically loads newly added plugin jar files and reloads existing plugins when their jar files are updated.
autoload: true
Platform Support
Paper / Folia / Spigot / Bukkit
- Minecraft Versions:
1.21 to 1.21.11 (Java 21) & 26.x.x (Java 25)
- Permission:
ipr.admin
BungeeCord
Installation
- Download
ItsHimsPluginReloader-Paper.jar (for Paper/Folia) or ItsHimsPluginReloader-Bungee.jar (for BungeeCord).
- Drop the jar file into your server's
plugins/ folder.
- Start your server or proxy.
- Use
/ipr or just drop/update jars to manage your plugins!
Author: _ItsHim_
Note: While ItsHim's Plugin Reloader performs deep cleanup of commands, listeners, scheduler tasks, and class loaders, some plugins with complex external library registrations or persistent native resources may still retain memory. For production environments, a full restart is always recommended for major updates, but IPR is perfect for fast-paced development and minor updates!
评论 0
登录后参与评分
还没有评论,来抢沙发吧