GWhitelist – Smart Crossplay Whitelist System for Paper
Advanced Whitelist Management for Geyser + Floodgate Servers
GWhitelist is a performance-focused whitelist management plugin built specifically for crossplay servers running Paper with Geyser and Floodgate.Vanilla Minecraft whitelist systems are designed only for Mojang-authenticated Java accounts. When Bedrock players join through Floodgate, identity handling differs due to the UUID format and authentication methods. This often causes confusion, manual errors, and unreliable whitelist behaviour.
GWhitelist replaces the vanilla whitelist logic with a unified system that correctly handles both Java and Bedrock players.
Why Use GWhitelist?
If your server uses:- Geyser
- Floodgate
- Java + Bedrock crossplay
GWhitelist:
- Correctly handles Floodgate UUID formats
- Prevents identity mismatch issues
- Eliminates manual whitelist confusion
- Provides clean admin commands
- Works without server restarts
Core Features
- Full Java + Bedrock whitelist compatibility
- Designed specifically for Geyser + Floodgate environments
- Add or remove players instantly
- UUID-based management support
- Clean and readable console output
- Fully configurable settings
- No dependency on vanilla whitelist file
- Event-driven validation (no heavy background tasks)
⚙ How It Works
When a player joins the server, GWhitelist detects:- Standard Java (online-mode) UUID
- Floodgate-authenticated Bedrock UUID
The plugin normalises identity handling internally and validates access using its own secure whitelist storage system.
This ensures both account types are treated correctly without relying on Mojang-only whitelist logic.
Commands
/geyserwhitelist add <player> – Add player/geyserwhitelist remove <player> – Remove player
/geyserwhitelist list – Show whitelisted players
/geyserwhitelist reload – Reload configuration
/geyserwhitelist on – Enable whitelist
/geyserwhitelist off – Disable whitelist
/geyserwhitelist status – Check status
/geyserwhitelist addUUID <uuid> – Add by UUID
/geyserwhitelist removeUUID <uuid> – Remove by UUID
Aliases
/gwhitelist
/gw
/g-whitelist
Permissions
geyserwhitelist.admin – Full administrative access(Default: OP)
Requirements
- Paper / Spigot 1.21+
- Geyser
- Floodgate
🛠 Installation
- Install Geyser and Floodgate on your Paper server
- Disable the vanilla whitelist
- Place GWhitelist.jar inside your /plugins folder
- Restart the server
- Use /gwhitelist on to enable
Performance
- No database dependency
- No scheduled heavy async tasks
- Lightweight event-based validation
- Designed for minimal overhead
FAQ
Q: Does this replace the vanilla whitelist system?A: Yes. GWhitelist bypasses the default whitelist to prevent UUID conflicts.
Q: Can I add players by UUID directly?
A: Yes. UUID management is supported.
Q: Is this safe for production survival servers?
A: Yes. It is designed for SMP, survival, and private crossplay communities.
Ideal For
- Crossplay survival servers
- Private SMP communities
- Java + Bedrock mixed networks
- Floodgate-enabled infrastructure
Developer
Created by FireIndex Studios
Specialising in optimised Paper plugins for crossplay infrastructure.
Website: https://play.indexfoundation.online/geyser-whitelist
Support: [email protected]
More plugins & projects available on the site
