HPWP

[CENTER] [SIZE=7][B][COLOR=#55BFFF]PER WORLD PLUGINS[/COLOR][/B][/SIZE] [SIZE=4][COLOR=#B7C3D0]Control plugin events, commands, and chat in every world from one clean GUI.[/COLOR][/SIZE]

[B][COLOR=#55FF88]Version 3.2[/COLOR][/B] | [B]GUI Configuration[/B] | [B]Optional PlaceholderAPI Support[/B] [/CENTER]

[HR][/HR]

[SIZE=5][B][COLOR=#55BFFF]A DIFFERENT EXPERIENCE IN EVERY WORLD[/COLOR][/B][/SIZE]

Per World Plugins (HPWP) gives multi-world servers fine-grained control over where plugin features are available. Configure every loaded world through an intuitive inventory GUI or edit the generated YAML files directly.

Run a survival world, creative world, lobby, event world, and minigames on the same server while keeping standard plugin events and commands where they belong.

[SIZE=5][B][COLOR=#55BFFF]FEATURES[/COLOR][/B][/SIZE]

[LIST] [*][B]Per-world plugin control[/B] - Filter standard Bukkit events and plugin-owned commands in selected worlds. [*][B]Complete in-game GUI[/B] - Configure global options, worlds, plugins, and chat tunnels without hand-editing YAML. [*][B]Blacklist and whitelist modes[/B] - Disable only selected plugins or allow only selected plugins in a world. [*][B]Fast bulk controls[/B] - Enable or disable all listed plugins, then fine-tune individual choices. [*][B]Automatic world discovery[/B] - Browse worlds currently loaded by Bukkit and refresh after adding worlds or plugins. [*][B]Chat tunnels[/B] - Group worlds into separate chat channels so only players in the same tunnel receive each other's messages. [*][B]Optional tunnel labels[/B] - Add a configurable prefix to chat messages so players can see where a message came from. [*][B]PlaceholderAPI integration[/B] - Use [ICODE]%pwp-chat_tunnel%[/ICODE] to display the player's current tunnel format. [*][B]YAML configuration[/B] - Every setting remains available in readable configuration files. [*][B]No required dependencies[/B] - PlaceholderAPI support is completely optional. [/LIST]

[SIZE=5][B][COLOR=#55BFFF]GREAT FOR[/COLOR][/B][/SIZE]

[LIST] [*]Survival and creative worlds on one server [*]Lobby, event, and minigame worlds [*]Worlds that need different gameplay plugins [*]Networks that want local chat groups without another required dependency [*]Administrators who prefer a GUI but still want editable configuration files [/LIST]

[SIZE=5][B][COLOR=#55BFFF]QUICK START[/COLOR][/B][/SIZE]

[LIST=1] [*]Stop your server. [*]Place [ICODE]HPWP-3.2.jar[/ICODE] in the server's [ICODE]plugins[/ICODE] folder. [*]Optionally install PlaceholderAPI if you want to use the tunnel placeholder. [*]Start the server and run [ICODE]/pwp gui[/ICODE]. [*]Open [B]Worlds' Config[/B], choose a world, and select which plugins should be enabled there. [*]Changes made through the GUI are saved automatically. Restart the server after manual YAML edits so they are reloaded. [/LIST]

[SIZE=5][B][COLOR=#55BFFF]COMMANDS[/COLOR][/B][/SIZE]

[LIST] [*][ICODE]/hpwp[/ICODE] or [ICODE]/pwp[/ICODE] - Show command help. [*][ICODE]/pwp gui[/ICODE] - Open the configuration GUI. [*][ICODE]/pwp events PLUGIN_NAME[/ICODE] - List the Bukkit events registered by a plugin. [*][ICODE]/pwp togglechat[/ICODE] - Toggle between tunnel chat and global chat for yourself. [/LIST]

[SIZE=5][B][COLOR=#55BFFF]PERMISSIONS[/COLOR][/B][/SIZE]

[LIST] [*][ICODE]hpwp.gui[/ICODE] - Use [ICODE]/pwp gui[/ICODE]. Default: operators. [*][ICODE]hpwp.events[/ICODE] - Use [ICODE]/pwp events[/ICODE]. Default: operators. [*][ICODE]hpwp.toggle.chat[/ICODE] - Use [ICODE]/pwp togglechat[/ICODE]. Default: operators. [*][ICODE]hpwp.notify[/ICODE] - Receive update notifications. Default: operators. [*][ICODE]hpwp.bypass.chat[/ICODE] - Use global chat instead of tunnel-restricted chat. Default: false. [*][ICODE]hpwp.*[/ICODE] - Grants the GUI, events, and notification permissions. Default: operators. [*][ICODE]hpwp.bypass.*[/ICODE] - Grants all declared HPWP bypass permissions. Default: false. [/LIST]

[SIZE=5][B][COLOR=#55BFFF]CONFIGURATION FILES[/COLOR][/B][/SIZE]

HPWP stores its settings in [ICODE]plugins/HPWP/[/ICODE]:

[LIST] [*][ICODE]global.yml[/ICODE] - Global messages and notification settings. [*][ICODE]chat_tunnels.yml[/ICODE] - Tunnel definitions, formats, and chat options. [*][ICODE]WORLD_NAME.yml[/ICODE] - Per-world plugin mode, plugin list, allowed events, and selected chat tunnel. [/LIST]

[SIZE=5][B][COLOR=#55BFFF]PLACEHOLDERAPI[/COLOR][/B][/SIZE]

PlaceholderAPI is optional. When it is installed, HPWP registers:

[CENTER][ICODE]%pwp-chat_tunnel%[/ICODE][/CENTER]

The placeholder returns the configured format for the player's current chat tunnel.

[SIZE=5][B][COLOR=#FFCC55]IMPORTANT: HOW FILTERING WORKS[/COLOR][/B][/SIZE]

[B]HPWP does not unload or start separate copies of plugins for each world.[/B] It filters standard Bukkit event listeners and blocks commands attributed to plugins according to each world's configuration.

Scheduled tasks, background runnables, network activity, and persistent data changes performed independently by another plugin are not automatically isolated. Plugins that use non-standard command systems or unusual event handling may require testing. Always test your chosen plugin combination on a staging server before deploying it to production.

[SIZE=5][B][COLOR=#55BFFF]FREQUENTLY ASKED QUESTIONS[/COLOR][/B][/SIZE]

[B]Does HPWP work with worlds created by a multi-world manager?[/B]

HPWP displays worlds currently loaded by Bukkit. Use the refresh button after loading or adding a world.

[B]Do I need PlaceholderAPI?[/B]

No. It is only needed for the optional [ICODE]%pwp-chat_tunnel%[/ICODE] placeholder.

[B]Can I configure HPWP without editing files?[/B]

Yes. Run [ICODE]/pwp gui[/ICODE] to manage global settings, chat tunnels, and per-world plugin choices.

[B]Why does part of a disabled plugin still run?[/B]

That feature may use a scheduler, background task, or another mechanism that is not tied to a Bukkit event or command. See the filtering explanation above.

[SIZE=5][B][COLOR=#55BFFF]SUPPORT[/COLOR][/B][/SIZE]

For the fastest help, include your server software and version, Java version, HPWP version, the plugin you are filtering, the relevant world configuration, and any console errors when posting in the resource Discussion tab.

[SIZE=5][B][COLOR=#55BFFF]PRIVACY[/COLOR][/B][/SIZE]

HPWP includes bStats for anonymous usage statistics. Server owners can disable bStats through the shared bStats configuration.

[CENTER] [SIZE=4][B][COLOR=#55FF88]Build each world your way with HPWP.[/COLOR][/B][/SIZE] [/CENTER