Bedrock Restrictor

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

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

Dependencies

* GeyserMC (Proxy) * GeyserMC (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.