Skip to content

Geo Restrict

Country, ASN, VPN and proxy access rules for Minecraft servers and proxy networks.

FabricNeoForgeForgePaper
Loaders
FabricNeoForgeForgePaper
Downloads on Modrinth
1.1K
Followers on Modrinth
13
versions
14
Updated
October 14, 2026Oct 14
Published
in 2025
banner · swipe

At a glance

Runs on Fabric, NeoForge, Forge and Paper
For Minecraft 1.2.1–1.2.5, 1.12.2–26.3
Latest version — 2.1.0-geyser from October 14, 2026
License GPL-3.0-only — free
Where it's needed
In gameunknownOn serverunknown

The author didn't say where the mod is needed

Game versions1.2.1–1.2.5, 1.12.2–26.3

GeoRestrict geographic access rules for Minecraft

GeoRestrict

Friendly geographic access control for Minecraft servers and proxies.

GeoRestrict lets you make practical rules around where connections come from. Block a short list of countries, keep a private server open to one region, stop traffic from a troublesome hosting network, or add a VPN rule while an attack is active. The policy stays in your own config.yml, where you can read it and change it.

Sponsored by Nexeu Hosting

High-performance, affordable hosting for your Minecraft server. Premium hardware, instant setup, 24/7 support.

The useful bits

  • Country allowlists and blocklists
  • ASN rules for individual ISPs and hosting networks
  • Configurable VPN, proxy and hosting detection
  • Geyser / Floodgate (Bedrock) integration with custom bypass options
  • Developer API (GeoRestrictAPI) for Paper, BungeeCord, and Velocity (Geo-Routing, VPN queries, ASN lookups)
  • One v2.0.2 jar for Bukkit, Spigot, Paper, Purpur, Folia, BungeeCord, Waterfall and Velocity
  • Local, bounded cache with atomic saves and automatic expiry cleanup
  • Clear behavior when the lookup service is temporarily unavailable
  • Discord block notifications with IP masking enabled by default
  • /georestrict check, cachestats, purgecache and reload
  • georestrict.bypass on servers compatible with Bukkit

Start small

  1. Put georestrict-2.0.2.jar in the server or proxy plugins/ folder.
  2. Restart once to create plugins/GeoRestrict/config.yml.
  3. Pick BLOCKLIST or ALLOWLIST and add two letter country codes.
  4. Run /georestrict reload.
  5. Use `/georestrict check ` to confirm the result before inviting everyone back.

You do not need to enable every feature on day one. Country rules are enough for many communities; ASN and VPN controls can wait until you have a specific problem to solve.

When a lookup fails

v2.0.2 blocks by default when the cache is empty and the lookup service is unavailable. The player receives your kickMessageLookupFailure. Set blockOnLookupFailure: false if keeping the server reachable during an outage matters more than strict filtering.

Live Statistics

bStats Bukkit bStats BungeeCord bStats Velocity

Privacy, without vague promises

On a cache miss, the connecting IP goes to the configured lookup service for country, ASN and proxy data. GeoRestrict does not run a central player panel or player analytics service. Standard aggregate bStats metrics are available per platform; bStats does not receive player names or IP addresses from this plugin. Most communities can keep the generated network settings unchanged.

Requirements

  • GeoRestrict targets Java 17 bytecode; use the newer Java version required by your platform
  • Check the tested version table in the wiki for your Minecraft release
  • A supported Bukkit server or proxy platform
  • Outbound HTTPS access to the configured lookup service

Help and project links

GeoRestrict was originally created by linuxaddict and is now maintained by the Demonz Development open source community. Licensed under GPL-3.0.

FAQ

How to install Geo Restrict?

Install Fabric for your Minecraft version, download Geo Restrict for the same version and loader, put the file into the mods folder and launch the game with the loader profile.

Which Minecraft versions does Geo Restrict support?

Geo Restrict has builds for Minecraft 1.2.1–1.2.5, 1.12.2–26.3.

License and source
GNU General Public License v3.0 onlyfree to use and share; changes to the mod itself must be published under the same license
Original — Modrinth↗Files unchanged, verified with SHA-512Is this your mod? For rights holders

The site uses cookies: the necessary ones for sign-in and the theme, plus the Yandex Metrica and LiveInternet visit counters — they show us how the site is used. We have no advertising cookies. More