What PerWorldPlugins works with.
| Platform | Java Edition |
|---|---|
| Loaders | Paper, Purpur |
| Minecraft versions | 1.21, 1.21.5, 1.21.8, 1.21.11, 26.1, 26.2 |
PerWorldPlugins lets a server admin choose which plugins run on which worlds. Instead of a plugin being active across the whole server, it turns on only where it is set to, for example a minigame plugin that runs on one arena world but stays off everywhere else. It targets Paper and Purpur and is free under the MIT license.
What per-world plugin control means
A normal Bukkit-based plugin runs on every world on the server at once, because the server loads plugins globally, not per world. PerWorldPlugins sits in between: it reads a config file that lists which plugins should be active on which world, then blocks the ones that should not be running there. A construction plugin can be limited to a creative world, or a lag-heavy minigame plugin can be confined to its own arena instead of firing checks on a survival world nobody uses it on.
Supported server software and current versions
The actively maintained line targets Paper and Purpur. The latest build, 1.6.2, published June 10, 2026, lists game versions from 1.21 through 26.2 for both loaders. The project also has older Bukkit and Spigot builds, but those stopped at version 1.5.9 in September 2024 and cap out at Minecraft 1.21.5, so a server on Bukkit or Spigot past that point is running an unmaintained build.
Installation and configuration
- 1.Download the jar from the Modrinth project page for your server's version.
- 2.Drop it into the server's plugins folder and restart or reload the server.
- 3.Open the generated config file and list which plugins should be enabled on which world names.
- 4.Run /perworldplugin reload to apply config changes without a restart.
Commands and permissions
- /perworldplugin reload - reloads the config file.
- /perworldplugin version - shows the installed plugin version.
- perworldplugins.reload - permission node for the reload command.
- perworldplugins.version - permission node for the version command.
Compatibility and limitations
PerWorldPlugins has no plugin dependencies across any of its released versions, so it does not require Vault, a permissions plugin, or a database. Its own documentation notes that scoreboards and the tab list are not supported while a plugin is scoped to a world. A server running Multiverse-Core to manage several worlds is the typical setup where per-world plugin control is worth adding, since more worlds usually means more plugins that only make sense on one of them.
PerWorldPlugins setup walkthrough
Questions about PerWorldPlugins.
5 questions
What does PerWorldPlugins do?
It lets a server admin restrict other plugins to specific worlds instead of running them across the whole server. A plugin listed in its config only fires on the worlds an admin assigns it to, which is useful for minigame plugins, world-specific mechanics, or cutting down on plugins checking events on worlds where they serve no purpose.
Does PerWorldPlugins work on Bukkit or Spigot?
Old Bukkit and Spigot builds exist, but the last one shipped in September 2024 at version 1.5.9 and caps out at Minecraft 1.21.5. Active development has moved to Paper and Purpur, where the current build reaches Minecraft 26.2, so Bukkit or Spigot servers are running an unmaintained line.
Does PerWorldPlugins need a permissions plugin?
No. It has no dependencies in any released version. It ships its own permission nodes, perworldplugins.reload and perworldplugins.version, which work with the server's built-in permission system or any permissions plugin already installed.
Is there an updated fork of PerWorldPlugins?
A separately maintained listing calling itself an unofficial update exists on SpigotMC from a different, unnamed maintainer. The actively maintained original is by TonimatasDEV on Modrinth and GitHub, and that is the version this page covers.
How do I reload PerWorldPlugins after changing the config?
Run /perworldplugin reload in-game or from the console with the perworldplugins.reload permission. It reapplies the per-world plugin list from the config file without needing a full server restart.
