GetPerWorldPlugin

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.

Stop players from using economy commands in creative mode, prevent mcMMO grinding in the hub, and keep your minigame worlds clean—all with a simple whitelist configuration.

---

THE PROBLEM IT SOLVES

On servers with multiple worlds (Survival, Creative, Hub, Minigames), global plugins can cause chaos:

• Economy Exploits: Players selling creative items in survival shops.
• Skill Grinding: Leveling up skills in low-risk worlds.
• Chat Spam: Players using command-heavy features in lobbies.

THE SOLUTION

GetPerWorldPlugin acts as a gatekeeper. When a player types a command:

1. It identifies which plugin owns the command.
2. It checks if that plugin is restricted in the config.
3. If restricted, it checks if the player is in an allowed world.
4. If not allowed, the command is silently blocked.

---

KEY FEATURES

• Whitelist System: You only list the worlds where a plugin should work. All other worlds are automatically blocked.
• Tab Completion Hiding: Restricted commands are removed from the tab-complete list, making the restriction feel native.
• Performance Optimized: Caches configurations and command mappings to ensure 0.1ms overhead.
• Global Bypass: Admins can bypass restrictions with a single permission.
• Alias Support: Blocks the main command and all its aliases automatically.
• Multiverse Ready: Works seamlessly with Multiverse-Core and other world managers.

---

HOW TO INSTALL

1. Download the .jar file.
2. Place it in your server's plugins/ folder.
3. Restart your server.
4. Configure the config.yml.
5. Run /gpw reload.

Requirements:

• Server: Paper (or forks like Purpur).
• Java: Java 21 or higher.
• Minecraft: 1.21.x +

---

CONFIGURATION

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.

File: plugins/GetPerWorldPlugin/config.yml

plugin-restrictions:
   mcMMO will only work in these worlds
  mcMMO:
    - survival
    - survival_nether
    - survival_the_end

   Jobs restricted to the main world
  Jobs:
    - survival

   Economy plugins restricted to prevent creative exploits
  EssentialsX:
    - survival
    - shops

   Slimefun only in the dedicated world
  Slimefun:
    - slimefun_world

blocked-message: "&c&lBlocked! &7This command is not available in this world."
debug: false

Tip: Plugin names are case-sensitive. Use the exact name shown when you run /plugins in-game.

---

COMMANDS

• /getperworld help - Show the help menu.
• /getperworld reload - Reload the configuration file.
• /getperworld list - View all active restrictions.
• /getperworld info <plugin> - See which worlds allow a specific plugin.

Aliases: /gpw, /perworld

---

PERMISSIONS

• getperworld.admin - Allows access to reload and list commands (Default: OP).
• getperworld.bypass - Allows the player to use any command in any world, ignoring restrictions (Default: OP).
• getperworld.* - Grants all permissions.

---

FAQ

Does this unload the plugin? No. The plugin is still running in the background. This plugin only blocks the execution of commands.

Why can I still see the commands in Tab Complete? The client caches tab completions. Switch worlds or relog to update the tab list.

Does this work with Vanilla commands? No. 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.

My config isn't working! Check the capitalization of the Plugin Name. mcmmo will not work if the plugin is actually named mcMMO. Use /plugins to check.