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

• Permission: ipr.admin

---

Installation

1. Download ItsHimsPluginReloader-Paper.jar (for Paper/Folia) or ItsHimsPluginReloader-Bungee.jar (for BungeeCord).
2. Drop the jar file into your server's plugins/ folder.
3. Start your server or proxy.
4. 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!