Understanding the Multiverse-Portals Ban Plugin
Running a Minecraft server with multiple worlds often requires fine-grained control over who can enter each dimension. Whether you operate a competitive PvP arena, a creative building zone, or a private staff-only realm, keeping unwanted players out is essential. The Multiverse-Portals Ban plugin solves this problem elegantly by integrating with the popular Multiverse suite to block specific players from using portals into designated worlds.
What Does This Plugin Actually Do?
At its core, the plugin listens for portal usage events generated by Multiverse-Portals. When a player attempts to step through a portal that leads to a banned world, the plugin checks its internal ban list and stops the teleport. It can also enforce a whitelist, so only approved players may enter a world, and it can blacklist entire worlds from portal access altogether. This makes it a lightweight but powerful tool for server administrators who already rely on Multiverse for world management.
Key Features at a Glance
- World-Specific Bans: Prevent a player from entering a particular world via any Multiverse portal.
- Whitelist Mode: Restrict access so that only players you explicitly add can use portals to a world.
- Configurable Messages: Customize every chat notification, including ban reasons and whitelist feedback, directly in the config file.
- World Blacklist: Designate worlds that no player can portal into, regardless of bans or whitelists.
- Self-Ban Protection: An option to prevent operators from accidentally banning themselves.
Commands and How to Use Them
The plugin introduces a straightforward command set under the alias /mpb. Here is the full list:
- /mpb ban <world> <player> – Bans a player from entering the specified world through portals.
- /mpb unban <world> <player> – Removes the ban, allowing the player to use portals to that world again.
- /mpb list – Displays all currently banned players and the worlds they are banned from.
- /mpb reload – Reloads the configuration file without restarting the server.
- /mpb wl <world> – Toggles the whitelist on or off for a world.
- /mpb wl <world> list – Shows the whitelist for a specific world.
- /mpb wl <world> add <player> – Adds a player to the whitelist.
- /mpb wl <world> del <player> – Removes a player from the whitelist.
All commands are permission-based, giving you the flexibility to delegate moderation tasks to trusted staff without granting full administrative access.
Permissions Breakdown
The plugin uses a granular permission node system. The main nodes are:
- mpb.* – Wildcard access to every command.
- mpb.modo – Grants access to the core banning and listing commands (excludes reload).
- mpb.ban – Allows banning players.
- mpb.unban – Allows unbanning players.
- mpb.list – Lets the user view banned players.
- mpb.reload – Permission to reload the config.
- mpb.wl – Base permission for whitelist commands.
- mpb.wl.modo – Core whitelist management (toggle, list).
- mpb.wl.add – Add players to a whitelist.
- mpb.wl.del – Remove players from a whitelist.
- mpb.wl.onoff – Enable or disable a whitelist.
- mpb.wl.list – List a whitelist.
Assigning these nodes through a permissions manager like LuckPerms allows you to build a custom staff hierarchy that matches your server's needs.
Configuration and Customization
The plugin ships with a fully bilingual configuration file, supporting both English and French messages. Every chat output can be tailored to match your server’s tone. For instance, you can change the ban notification to something humorous or strictly informative. The config also includes a WorldBlacklist list where you can add worlds that should never be accessible through portals, regardless of any ban or whitelist settings. A simple /mpb reload applies changes instantly.
One useful setting is playercantbanself, which when set to true, stops an operator from accidentally locking themselves out of a world. This small touch prevents a lot of headaches during busy moderation sessions.
Installation Requirements
Before you can use Multiverse-Portals Ban, your server must meet a few prerequisites. You need Java 7 or higher, the Multiverse-Core plugin, and the Multiverse-Portals plugin. Place the downloaded jar file into your server’s plugins folder, restart the server, and the plugin will generate its default configuration. For players who enjoy customizing their game, using a modern launcher like foxygame.net can simplify mod management, allowing you to download and install mods right from the menu. While this plugin is server-side, keeping your client environment flexible with such tools makes testing and development much smoother.
Practical Scenarios and Use Cases
Imagine you run a survival server with a separate PvP arena world. A player repeatedly breaks arena rules, but you don’t want to ban them from the entire server. With this plugin, you simply run /mpb ban pvp_arena rulebreaker and they are blocked from entering the arena via any portal. The custom message will inform them why they cannot pass, maintaining transparency. Later, you can unban them just as easily.
For exclusive worlds, like a donator-only creative plot world, you can enable the whitelist and add paying members. Everyone else who tries to step through the portal will see a configurable denial message, encouraging them to support the server.
Troubleshooting and Known Behavior
The developer notes that if you make a syntax error in the config file, the plugin will reset to default settings to prevent crashes. Always double-check your YAML formatting after editing. Currently, there are no known bugs, and the plugin works stably with the latest Multiverse builds. If you encounter issues, ensure your Java version is compatible and that both Multiverse plugins are loaded correctly.
Final Thoughts
The Multiverse-Portals Ban plugin fills a niche that many server admins didn’t realize they needed until they faced portal abuse. Its lightweight design, clear command structure, and dual-language support make it accessible even for beginners. By combining bans, whitelists, and world blacklists, you gain complete control over cross-world travel. Whether you’re protecting a hardcore survival realm or a private building sanctuary, this plugin gives you the tools to enforce your rules without complex workarounds. Install it, configure the messages to your liking, and watch your portal traffic become exactly what you want it to be.