ZBedRockBlock is a lightweight Paper plugin that blocks Bedrock players from joining your backend server by detecting their Java username prefix. No Floodgate or Geyser API hooks required — purely prefix-based, zero database, and built for Paper servers running behind Velocity.
Features:
Use Cases:
Commands:
Permissions:
Requirements:
Features:
- Prefix-based Bedrock detection — blocks any player whose username starts with the configured prefix (case-insensitive)
- Fully customizable kick message with support for both MiniMessage (<red>…</red>) and legacy & color codes
- Bypass permission for exceptions — grant trusted players or staff alts zbedrockblock.bypass to let them through
- Optional op exemption via ignore-ops config toggle
- Debug logging to console for monitoring denied join attempts
- Hot reload via /zbedrockblock reload — no restart required
- Test command /zbedrockblock test <name> — previews whether a username would be blocked and shows the kick message
- Tab-completion included on all commands
- Zero database footprint — purely event-driven with no stored data
Use Cases:
- Block all Bedrock players from a Java-only backend server
- Allow specific Bedrock players through (staff alts, trusted users) via bypass permission
- Temporarily disable blocking without removing the plugin using enabled: false
- Compatible with queue plugins like ajQueue — configure a keyword in your kick message to automatically remove blocked players from the queue
Commands:
- /zbedrockblock reload — Reloads the plugin configuration (requires zbedrockblock.admin)
- /zbedrockblock test <name> — Previews whether a name would be blocked (requires zbedrockblock.admin)
Permissions:
- zbedrockblock.admin — Access to reload and test commands
- zbedrockblock.bypass — Allows a player to join even if their name matches the Bedrock prefix
Requirements:
- Paper 1.21+
- Java 21+
- A permissions plugin optional (LuckPerms recommended for bypass/admin grants)
