# BedrockRestrictor<\/p>\n
A lightweight and efficient Velocity proxy plugin designed to restrict Bedrock players (connecting via Geyser\/Floodgate) from joining specific backend servers on your network.<\/p>\n
### Why use BedrockRestrictor?
\nIf 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). <\/p>\n
While you can block Bedrock players directly on the backend server, it causes unnecessary load.<\/p>\n
**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.<\/p>\n
### Features
\n* **Proxy-Level Blocking:** Intercepts the `ServerPreConnectEvent` to save backend resources.
\n* **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.
\n* **Customizable Blacklist:** Easily define which backend servers (as named in your `velocity.toml`) are restricted.
\n* **Custom Messages:** Supports legacy color codes (`&`) and MiniMessage for the deny message.
\n* **Plug & Play:** Extremely lightweight with zero impact on proxy performance.<\/p>\n
### Dependencies
\n* **Velocity** (Proxy)
\n* **Floodgate** (Velocity version must be installed on the proxy)
\n* **GeyserMC** (Velocity version must be installed on the proxy)<\/p>\n
### Configuration
\nThe plugin generates a simple `config.yml` where you can toggle the system, add servers to the blacklist, and customize your message:<\/p>\n
“`
\n# BedrockRestrictor configuration
\n# Whether the restriction logic is enabled at all.
\nenabled: true<\/p>\n
# Names of backend servers (from velocity.toml) that Bedrock players
\n# are NOT allowed to join. Case-insensitive.
\nblocked-servers:
\n # – RPG
\n # – classic<\/p>\n
# Message sent to Bedrock players when they are denied.
\n# Supports legacy ‘&’ color codes or MiniMessage formatting.
\ndeny-message: “&cBedrock players when they are denied.”<\/p>\n
“`<\/p>\n
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.<\/p>\n","protected":false},"excerpt":{"rendered":"
Velocity Bedrock Whitelist for servers<\/p>\n","protected":false},"featured_media":27055,"template":"","meta":{"_minecraft_slug":"bedrockrestrictor","_minecraft_project_id":"n6fKuTjr","_minecraft_author":"GamemasterUA","_minecraft_license":"MIT","_minecraft_downloads":11,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"bedrockrestrictor.zip","_minecraft_size_bytes":8943,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T23:05:30.061422Z","_minecraft_date_created":"2026-03-18T22:11:50.183635Z","_minecraft_date_modified":"2026-03-18T12:21:13.083961Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/bedrockrestrictor","_minecraft_icon_attachment_id":27055,"_minecraft_imported_at":"2026-06-01T10:15:21+00:00","_minecraft_import_hash":"1ab8924af7852ef5d3e17abc85c984b2","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,90,985],"mod_loader":[986],"minecraft_version":[41],"class_list":["post-27054","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-optimization","mod_category-velocity","mod_loader-velocity","minecraft_version-1-21-11"],"yoast_head":"\n