Geo Restrict

Minecraft 版本： 1.16 1.16.1 1.16.2 1.16.3 1.16.4 1.16.5 1.17 1.17.1 1.18 1.18.1 1.18.2 1.19 1.19.1 1.19.2 1.19.3 1.19.4 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11 26.1 26.1.1 26.1.2 26.2

平台： bukkit bungeecord folia paper purpur spigot velocity waterfall

标签： management utility

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.1 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.1.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 <ip> 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.1 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

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

• Source code
• Download on Modrinth
• Documentation
• Privacy Policy
• Terms and Conditions
• Discord support and feedback
• Bug reports
• Demonz Development

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