DeepReload Plugin Manager
DeepReload is a dependency-aware live plugin manager for Paper servers. It lets you load, unload, update, rollback, and reactivate plugins without doing a full server restart.DeepReload watches your plugin folder and its dropins folder, detects plugin jar changes, builds a safe reviewed plan, then applies the changes through a controlled scan, status, and confirm workflow.
What DeepReload Can Do
- Live-load new plugin jars
- Fully unload removed plugins
- Reload and reactivate disabled plugins
- Update plugin jars without a full restart
- Stage safer updates through the dropins folder
- Back up plugin jars before changes
- Roll back plugins from backups
- Clean stale commands from unloaded or disabled plugins
- Verify whether a plugin is loaded, removed, or leaving stale commands behind
- Detect classloader, thread, and command leaks
- Show dependency-aware reload plans before applying changes
- Protect itself from being unloaded during an active transaction
- Warn before large or risky lifecycle changes
How It Works
DeepReload does not use the unsafe default /reload command.Instead, it scans your /plugins folder and the DeepReload dropins folder, detects what changed, and builds a detailed plan before touching anything.
Typical workflow:
- Add, remove, or update a plugin jar.
- Run /dr scan.
- Review the plan with /dr status.
- Apply it with /dr confirm.
/dr confirm --force
Dropins Folder
DeepReload includes a dropins system for safer plugin updates.Instead of directly replacing a jar inside /plugins, place the new jar into:
/plugins/DeepReload/dropins/
DeepReload will detect the staged jar, compare it to the current plugin, and prepare an update plan.
Built-In Safety Tools
DeepReload includes multiple safety systems to reduce broken reloads:- Dependency-aware lifecycle ordering
- Required dependency checks
- Soft-dependency warnings
- Large-plan warnings
- Server-wide plan refusal option
- Pending plan expiration
- Confirmation requirement
- Self-protection guard
- Transaction recovery command
- Stale command cleanup
- Rollback history
- Debug logging for testing
Compatibility Engine
DeepReload includes built-in drivers and compatibility profiles for many popular plugins, including:- ProtocolLib
- ItemsAdder
- LoneLibs
- PlaceholderAPI
- LuckPerms
- Vault
- ViaVersion
- ViaBackwards
- ViaRewind
- Geyser
- Floodgate
- WorldEdit
- WorldGuard
- Citizens
- Essentials
- CMI
- DeluxeMenus
- DecentHolograms
- HolographicDisplays
- AdvancedEnchantments
- MythicMobs
- MMOItems
- Oraxen
- Nexo
- ModelEngine
- CoreProtect
- Multiverse-Core
- Lands
- PlotSquared
- TAB
- Skript
- Crate plugins
- Anti-cheat plugins
Main Commands
- /dr help - Show command help
- /dr scan - Scan plugin folder/dropins and build a pending plan
- /dr status - Show the pending plan
- /dr plan - Alias for status
- /dr confirm - Apply the reviewed pending plan
- /dr apply - Alias for confirm
- /dr confirm --force - Force-apply a large or risky reviewed plan
- /dr verify <plugin> - Verify loaded/removed state and stale commands
- /dr leaks <plugin> - Check classloader, thread, and command leaks
- /dr rollback <plugin> - Restore the latest backup and reload the plugin
- /dr history [plugin] - Show backups and reload sessions
- /dr recover - Show and clear unfinished transaction locks
- /dr cleanupcommands - Remove stale commands from disabled/unloaded plugins
- /dr fixcommands - Alias for cleanupcommands
- /dr drivers - Show coded plugin drivers
- /dr adapters - Show config compatibility profiles
- /dr support - Alias for adapters
- /dr doctor - Run global stale command and session checks
- /dr debug <on|off|status|stacktraces> - Manage debug logging
- /dr reload - Reload DeepReload config, adapters, and drivers
- /dr baseline - Refresh the plugin jar baseline
- /dr paths - Show DeepReload folder paths
- /deepreload
- /dr
- /dreload
- /pluginreboot
Permission
deepreload.adminDefault: OP
Requirements
- Paper server recommended
- Minecraft/Paper API 1.21+
- Java 21 recommended
Important Note
DeepReload is designed to make live plugin loading, unloading, updating, rollback, and repair possible without full restarts. Some plugins with deep server hooks, packet injection, custom classloaders, one-time startup registration, or heavy resource-pack systems may still require testing depending on the plugin version.For best results, use the dropins folder, review /dr status, and confirm only the plans you expect.
