**GetPerWorldPlugin** is a lightweight, high-performance Paper plugin designed to give server administrators control over where plugin commands can be used. It creates a “per-world plugin” experience by intercepting commands and checking if the player is in an allowed world, without the instability of trying to load\/unload plugins dynamically.<\/p>\n
Stop players from using economy commands in creative mode, prevent mcMMO grinding in the hub, and keep your minigame worlds clean\u2014all with a simple whitelist configuration.<\/p>\n
***<\/p>\n
**THE PROBLEM IT SOLVES**<\/p>\n
On servers with multiple worlds (Survival, Creative, Hub, Minigames), global plugins can cause chaos:
\n* **Economy Exploits:** Players selling creative items in survival shops.
\n* **Skill Grinding:** Leveling up skills in low-risk worlds.
\n* **Chat Spam:** Players using command-heavy features in lobbies.<\/p>\n
**THE SOLUTION**<\/p>\n
GetPerWorldPlugin acts as a gatekeeper. When a player types a command:
\n1. It identifies which plugin owns the command.
\n2. It checks if that plugin is restricted in the config.
\n3. If restricted, it checks if the player is in an allowed world.
\n4. If not allowed, the command is **silently blocked**.<\/p>\n
***<\/p>\n
**KEY FEATURES**<\/p>\n
* **Whitelist System:** You only list the worlds where a plugin *should* work. All other worlds are automatically blocked.
\n* **Tab Completion Hiding:** Restricted commands are removed from the tab-complete list, making the restriction feel native.
\n* **Performance Optimized:** Caches configurations and command mappings to ensure 0.1ms overhead.
\n* **Global Bypass:** Admins can bypass restrictions with a single permission.
\n* **Alias Support:** Blocks the main command and all its aliases automatically.
\n* **Multiverse Ready:** Works seamlessly with Multiverse-Core and other world managers.<\/p>\n
***<\/p>\n
**HOW TO INSTALL**<\/p>\n
1. Download the `.jar` file.
\n2. Place it in your server’s `plugins\/` folder.
\n3. Restart your server.
\n4. Configure the `config.yml`.
\n5. Run `\/gpw reload`.<\/p>\n
**Requirements:**
\n* **Server:** Paper (or forks like Purpur).
\n* **Java:** Java 21 or higher.
\n* **Minecraft:** 1.21.x +<\/p>\n
***<\/p>\n
**CONFIGURATION**<\/p>\n
The configuration uses a simple whitelist format. If a plugin is **not** listed in the config, it works everywhere. If it **is** listed, it only works in the worlds you specify.<\/p>\n
**File:** `plugins\/GetPerWorldPlugin\/config.yml`<\/p>\n
“`yaml
\nplugin-restrictions:
\n mcMMO will only work in these worlds
\n mcMMO:
\n – survival
\n – survival_nether
\n – survival_the_end<\/p>\n
Jobs restricted to the main world
\n Jobs:
\n – survival<\/p>\n
Economy plugins restricted to prevent creative exploits
\n EssentialsX:
\n – survival
\n – shops<\/p>\n
Slimefun only in the dedicated world
\n Slimefun:
\n – slimefun_world<\/p>\n
blocked-message: “&c&lBlocked! &7This command is not available in this world.”
\ndebug: false
\n“`<\/p>\n
**Tip:** Plugin names are **case-sensitive**. Use the exact name shown when you run `\/plugins` in-game.<\/p>\n
***<\/p>\n
**COMMANDS**<\/p>\n
* `\/getperworld help` – Show the help menu. **Aliases:** `\/gpw`, `\/perworld`<\/p>\n ***<\/p>\n **PERMISSIONS**<\/p>\n * `getperworld.admin` – Allows access to reload and list commands (Default: OP). ***<\/p>\n **FAQ**<\/p>\n **Does this unload the plugin?** **Why can I still see the commands in Tab Complete?** **Does this work with Vanilla commands?** **My config isn’t working!** A perworldplugin management plugin enabling whitelist for a pluign to work in a specific world…..<\/p>\n","protected":false},"featured_media":75417,"template":"","meta":{"_minecraft_slug":"getperworldplugin","_minecraft_project_id":"aQZFcuJE","_minecraft_author":"geturplugins","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":90,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"getperworldplugin.zip","_minecraft_size_bytes":13693,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T19:54:27.332901Z","_minecraft_date_created":"2025-12-21T05:08:10.193730Z","_minecraft_date_modified":"2025-12-13T06:24:08.787341Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/getperworldplugin","_minecraft_icon_attachment_id":75417,"_minecraft_imported_at":"2026-06-04T08:55:02+00:00","_minecraft_import_hash":"9c97a58bfdb037229c8a3c9fb76a3025","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127],"mod_loader":[132],"minecraft_version":[37,73,74,38,78,79,80,81],"class_list":["post-75416","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-paper","mod_loader-paper","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8"],"yoast_head":"\n
\n* `\/getperworld reload` – Reload the configuration file.
\n* `\/getperworld list` – View all active restrictions.
\n* `\/getperworld info
\n* `getperworld.bypass` – Allows the player to use any command in any world, ignoring restrictions (Default: OP).
\n* `getperworld.*` – Grants all permissions.<\/p>\n
\nNo. The plugin is still running in the background. This plugin only blocks the **execution of commands**.<\/p>\n
\nThe client caches tab completions. Switch worlds or relog to update the tab list.<\/p>\n
\nNo. Vanilla commands (like `\/gamemode` or `\/tp`) do not belong to a specific plugin and cannot be restricted by this tool. Use a permissions plugin like LuckPerms for those.<\/p>\n
\nCheck the capitalization of the Plugin Name. `mcmmo` will not work if the plugin is actually named `mcMMO`. Use `\/plugins` to check.<\/p>\n","protected":false},"excerpt":{"rendered":"