Understanding Pl3xMap-SuperVanish: The Perfect Map-Vanish Integration
Minecraft server administrators often face a delicate balancing act: providing a rich, interactive world map for players while preserving the privacy of staff members or hidden users. The Pl3xMap-SuperVanish plugin solves this challenge elegantly by bridging two powerful tools — Pl3xMap, a modern web-based map renderer, and SuperVanish, a robust vanish plugin. When a player goes into vanish mode, they instantly disappear from the live map, and when they reappear, their marker returns seamlessly. This integration eliminates the awkward situation where a supposedly invisible admin still shows up on the map, breaking immersion and potentially revealing sensitive operations.
How the Integration Works
At its core, Pl3xMap-SuperVanish acts as a lightweight listener that hooks into SuperVanish events. Whenever a player triggers a vanish or unvanish action — whether through a command, a permission-based auto-vanish, or another plugin — the add-on immediately notifies Pl3xMap to update that player’s visibility status. The map renderer then either removes the player’s icon from the web interface or restores it, all within a fraction of a second. This real-time synchronization ensures that the map always reflects the true visible state of every online player, without any manual intervention from server staff.
Key Features at a Glance
- Automatic hiding and showing: No extra commands needed; vanish state changes are instantly mirrored on the map.
- Full SuperVanish compatibility: Works with all vanish methods, including /sv, /vanish, and permission-based auto-vanish on join.
- Lightweight and efficient: Minimal performance impact, as it only listens for specific events rather than polling.
- Easy configuration: Simple setup with clear permissions and a straightforward config file.
- Multi-world support: Handles players across different worlds without conflicts.
- Open-source transparency: The code is publicly available, allowing server owners to audit or customize it.
Why This Plugin Matters for Server Owners
Running a Minecraft server with a public web map like Pl3xMap offers tremendous value — players can explore the world from a browser, plan builds, and locate friends. However, staff members often need to observe player activity discreetly, whether to catch griefers, monitor chat, or simply perform maintenance without causing panic. Without proper integration, a vanished staff member would still appear as a dot on the map, defeating the purpose of invisibility. Pl3xMap-SuperVanish closes this loophole completely, ensuring that vanish and map privacy work hand in hand.
Beyond staff use, many servers employ vanish for VIP perks, event setups, or spectator modes. In each case, the map should respect the player’s hidden state. This plugin also helps maintain a clean map aesthetic — no confusing markers for players who are not truly present in the game world. The result is a more professional and trustworthy server environment.
Installation and Setup
Getting Pl3xMap-SuperVanish running is straightforward, assuming you already have Pl3xMap and SuperVanish installed and configured. The plugin is designed to be drag-and-drop simple, with no complex dependencies beyond the two core plugins. For those who prefer a more streamlined mod management experience, the foxygame.net launcher provides a convenient way to install and keep such plugins updated directly from its interface, making it an excellent choice for server administrators who value flexibility and modern tooling.
Step-by-Step Guide
- Verify prerequisites: Ensure your server runs a compatible Minecraft version (typically 1.16.5 or newer) and that both Pl3xMap and SuperVanish are active and functioning.
- Download the plugin: Grab the latest stable build from the official GitHub releases page. Snapshot builds are also available for testing upcoming features.
- Place the JAR file: Drop the downloaded JAR into your server’s
pluginsfolder. - Restart or reload: Restart the server or use a plugin manager to load the new addition.
- Check permissions: The plugin adds a simple permission node
pl3xmap.supervanish.hidethat controls whether a player’s vanish state affects the map. By default, all vanished players are hidden, but you can fine-tune this. - Verify functionality: Vanish with a test account and confirm that the player marker disappears from the web map. Unvanish and ensure it reappears.
Configuration and Customization
The plugin generates a config.yml file on first run, offering a few adjustable options. You can toggle whether vanished players are hidden by default, define which worlds the integration should ignore, and set custom messages for debug purposes. The configuration is minimal by design, as the plugin’s job is to simply bridge two existing systems without adding unnecessary complexity.
For advanced setups, the plugin respects SuperVanish’s layered vanish system. If a player is vanished multiple times (e.g., through different plugins that stack vanish states), Pl3xMap-SuperVanish will only show the player when all vanish layers are removed. This prevents accidental exposure when only one layer is lifted.
Permissions and Commands
The plugin introduces a single primary permission: pl3xmap.supervanish.hide. Players with this permission will be hidden from the map when vanished. Without it, even vanished players remain visible on the map. This allows server owners to selectively apply the integration — for example, letting moderators vanish without hiding their map marker if they are simply observing chat, while fully hiding administrators.
There are no additional commands to learn. The plugin works silently in the background, triggered entirely by SuperVanish events. This zero-command philosophy reduces the learning curve for staff and keeps the server’s command list uncluttered.
Compatibility and Performance
Pl3xMap-SuperVanish is built to be lightweight. It listens only for specific vanish/unvanish events and sends a single API call to Pl3xMap to update the player’s visibility. There is no constant polling, no database overhead, and no impact on tick rate. The plugin has been tested on servers with hundreds of players and frequent vanish toggles without any noticeable performance degradation.
It supports all modern Minecraft versions that run Pl3xMap and SuperVanish, typically from 1.16.5 through the latest releases. Because it relies on standard event APIs, it is unlikely to break with minor updates to either parent plugin. The developer actively maintains the project, and bug reports or feature suggestions are welcomed through the issue tracker on GitHub.
Troubleshooting Common Issues
If vanished players still appear on the map, first check that the player has the correct permission node. Next, verify that both Pl3xMap and SuperVanish are loaded and functioning independently. Sometimes a mismatched version of SuperVanish can cause events to fire incorrectly. The plugin’s wiki provides detailed troubleshooting steps, including how to enable debug logging to trace vanish events in real time.
Another common pitfall is using a map renderer that caches player positions aggressively. Pl3xMap updates markers dynamically, but if you have a proxy or caching layer in front of the map, it might serve stale data. Ensure your web map is configured to fetch live data from the server rather than relying on long-term caches.
Extending the Functionality
Because the plugin is open-source, enterprising server owners can fork the code to add custom behaviors. For example, you could modify it to also hide vanished players from Dynmap if you run multiple map plugins, or integrate with other vanish plugins like PremiumVanish. The modular design makes such extensions relatively painless. The developer encourages community contributions and provides clear documentation on the project’s wiki.
Conclusion
Pl3xMap-SuperVanish fills a small but critical gap in Minecraft server management. By synchronizing vanish states with a live web map, it preserves the integrity of both staff surveillance and player privacy. The plugin is simple to install, requires no extra commands, and runs with negligible performance cost. Whether you run a small community server or a large network, this integration ensures that your map always reflects the true visible player base. With its open-source nature and active support channels, it’s a reliable choice for any administrator using Pl3xMap and SuperVanish. Adopting it means one less thing to worry about — and one more layer of professionalism for your server.
--- **Update Sep 21, 2026:** Added 1 file for version 26.2, 26.1.2, 26.1.1, 26.1, 1.21.9, 1.21.8, 1.21.7, 1.21.6, 1.21.5, 1.21.4, 1.21.3, 1.21.2, 1.21.11, 1.21.10, 1.21.1, 1.21, 1.20.6, 1.20.5, 1.20.4, 1.20.3, 1.20.2, 1.20.1, 1.20, 1.19.4.