# ViaRestrictor for Velocity
\nThis is ViaRestrictor, a fork of the original akanoka\/viarestrictor project, adapted specifically for Velocity proxies. It helps manage client versions on your Minecraft proxy setup by integrating with ViaVersion, allowing you to restrict access from incompatible or undesired clients and provide informative messages if needed.<\/p>\n
### What It Does<\/p>\n
Detects the player’s client version through ViaVersion (which must be installed).
\nSupports blacklisting restricted versions or whitelisting allowed ones, based on your preference.
\nCustomizable kick messages with color codes (&) and line breaks (n).
\nOption to automatically kick players after displaying the message.
\nLogs blocked connections to the console for reference, if enabled.<\/p>\n
### Why This Fork?<\/p>\n
The original plugin was designed for Spigot servers (or forks like Paper). This version has been fully ported to work with Velocity proxies, keeping all the core features intact but optimized for the proxy environment.
\nSetup<\/p>\n
Place the plugin in your Velocity plugins directory.
\nRequires Java 17 or higher and ViaVersion.
\nThe configuration file is generated at plugins\/ViaRestrictor\/config.yml upon first launch.
\nallowed_versions: Specify protocol numbers (e.g., 759 for Minecraft 1.20.1).<\/p>\n
“`
\nkick_message: Customize with placeholders like %mcversion% or %version%.<\/p>\n
mode: Use whitelist to allow only specified versions.<\/p>\n
kick: Set to true to enable automatic kicks.<\/p>\n
log_kicks: Set to true to log blocked players in the console.
\n“`<\/p>\n
Example for kick: <\/p>\n
You can reload the configuration using Velocity’s commands (like \/velocity reload) or restart <\/p>\n","protected":false},"excerpt":{"rendered":"
Restricts access by client version.<\/p>\n","protected":false},"featured_media":166025,"template":"","meta":{"_minecraft_slug":"viarestrictor-velocity","_minecraft_project_id":"oJinikG9","_minecraft_author":"PopugaiOnTheBeat","_minecraft_license":"Apache-2.0","_minecraft_downloads":14,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"viarestrictor-velocity.zip","_minecraft_size_bytes":300362,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:54:11.034221Z","_minecraft_date_created":"2026-02-25T01:49:45.772915Z","_minecraft_date_modified":"2026-02-05T09:06:43.865751Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/viarestrictor-velocity","_minecraft_icon_attachment_id":166025,"_minecraft_imported_at":"2026-06-09T18:10:48+00:00","_minecraft_import_hash":"7935bd2f8d5b163263b1bd4e586626f2","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,123,92,985],"mod_loader":[986],"minecraft_version":[845,846,847,848,849,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-166024","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-technology","mod_category-utility","mod_category-velocity","mod_loader-velocity","minecraft_version-1-2-1","minecraft_version-1-2-2","minecraft_version-1-2-3","minecraft_version-1-2-4","minecraft_version-1-2-5","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n