BedrockRestrictor

A lightweight and efficient Velocity proxy plugin designed to restrict Bedrock players (connecting via Geyser/Floodgate) from joining specific backend servers on your network.

Why use BedrockRestrictor?

If you run a cross-play network, you might have certain servers that are strictly for Java players (for example, an RPG server that requires a complex Java-only resource pack).

While you can block Bedrock players directly on the backend server, it causes unnecessary load.

BedrockRestrictor solves this by intercepting the connection at the Velocity proxy level. The connection is blocked instantly before the backend server is even pinged or awoken.

Features

• Proxy-Level Blocking: Intercepts the ServerPreConnectEvent to save backend resources.
• 100% Accurate Detection: Uses the official Floodgate API to detect Bedrock players. It works flawlessly even if players use Global Linking and share a Java UUID.
• Customizable Blacklist: Easily define which backend servers (as named in your velocity.toml) are restricted.
• Custom Messages: Supports legacy color codes (&) and MiniMessage for the deny message.
• Plug & Play: Extremely lightweight with zero impact on proxy performance.

Dependencies

• Velocity (Proxy)
• Floodgate (Velocity version must be installed on the proxy)
• GeyserMC (Velocity version must be installed on the proxy)

Configuration

The plugin generates a simple config.yml where you can toggle the system, add servers to the blacklist, and customize your message:

# BedrockRestrictor configuration
# Whether the restriction logic is enabled at all.
enabled: true

# Names of backend servers (from velocity.toml) that Bedrock players
# are NOT allowed to join. Case-insensitive.
blocked-servers:
  # - RPG
  # - classic

# Message sent to Bedrock players when they are denied.
# Supports legacy '&' color codes or MiniMessage formatting.
deny-message: "&cBedrock players when they are denied."

I use this plugin on my own server and don't plan on supporting it for older versions of Velocity. I'll update the plugin whenever I run into issues myself.