COWMODSКаталог модов

Geo Restrict

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

1,2 тыс.13обновлён 14 окт. 2026 г.
Скачать 2.1.0-geyserВсе версии (14)
УправлениеУтилиты

Описание

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

nexeu-sponsor

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

Галерея

nexeu_sponsorbanner

Последние версии

Все версии →
release

GeoRestrict 2.1.0 (Geyser)

2.1.0-geyser
14 окт. 2026 г.42Minecraft: 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, 26.3geyser
Скачать
Что нового
### GeoRestrict v2.1.0 #### What's New - **Local Connection Access Control**: Opt-in `blockLocalConnections` rejects loopback (127.0.0.1), RFC1918 LAN, link-local, and unique-local IPv6 before geolocation queries occur. - **LOCAL Evaluation in Country Rules**: Setting `LOCAL` in country `BLOCKLIST` blocks local connections with `kickMessageCountry`. - **Multi-Loader Server Mod Adapters**: Dedicated server mods for Fabric, Forge, NeoForge, and Sponge sharing the unified rule engine and local cache. - **Geyser & Floodgate Bedrock Integration**: Resolves trusted Bedrock client sockets and honors Bedrock bypass rules. - **Fail-Closed Architecture**: Cloudflare Worker edge router with multi-provider failover and self-hosted local DB-IP MMDB fallback server. - **Developer API (GeoRestrictAPI)**: Asynchronous lookups, country routing, ASN, and VPN queries.
release

GeoRestrict 2.1.0 (Sponge)

2.1.0-sponge
14 окт. 2026 г.22Minecraft: 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, 26.3sponge
Скачать
Что нового
### GeoRestrict v2.1.0 #### What's New - **Local Connection Access Control**: Opt-in `blockLocalConnections` rejects loopback (127.0.0.1), RFC1918 LAN, link-local, and unique-local IPv6 before geolocation queries occur. - **LOCAL Evaluation in Country Rules**: Setting `LOCAL` in country `BLOCKLIST` blocks local connections with `kickMessageCountry`. - **Multi-Loader Server Mod Adapters**: Dedicated server mods for Fabric, Forge, NeoForge, and Sponge sharing the unified rule engine and local cache. - **Geyser & Floodgate Bedrock Integration**: Resolves trusted Bedrock client sockets and honors Bedrock bypass rules. - **Fail-Closed Architecture**: Cloudflare Worker edge router with multi-provider failover and self-hosted local DB-IP MMDB fallback server. - **Developer API (GeoRestrictAPI)**: Asynchronous lookups, country routing, ASN, and VPN queries.
release

GeoRestrict 2.1.0 (NeoForge)

2.1.0-neoforge
14 окт. 2026 г.52Minecraft: 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, 26.3neoforge
Скачать
Что нового
### GeoRestrict v2.1.0 #### What's New - **Local Connection Access Control**: Opt-in `blockLocalConnections` rejects loopback (127.0.0.1), RFC1918 LAN, link-local, and unique-local IPv6 before geolocation queries occur. - **LOCAL Evaluation in Country Rules**: Setting `LOCAL` in country `BLOCKLIST` blocks local connections with `kickMessageCountry`. - **Multi-Loader Server Mod Adapters**: Dedicated server mods for Fabric, Forge, NeoForge, and Sponge sharing the unified rule engine and local cache. - **Geyser & Floodgate Bedrock Integration**: Resolves trusted Bedrock client sockets and honors Bedrock bypass rules. - **Fail-Closed Architecture**: Cloudflare Worker edge router with multi-provider failover and self-hosted local DB-IP MMDB fallback server. - **Developer API (GeoRestrictAPI)**: Asynchronous lookups, country routing, ASN, and VPN queries.
release

GeoRestrict 2.1.0 (Forge)

2.1.0-forge
14 окт. 2026 г.40Minecraft: 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, 26.3forge
Скачать
Что нового
### GeoRestrict v2.1.0 #### What's New - **Local Connection Access Control**: Opt-in `blockLocalConnections` rejects loopback (127.0.0.1), RFC1918 LAN, link-local, and unique-local IPv6 before geolocation queries occur. - **LOCAL Evaluation in Country Rules**: Setting `LOCAL` in country `BLOCKLIST` blocks local connections with `kickMessageCountry`. - **Multi-Loader Server Mod Adapters**: Dedicated server mods for Fabric, Forge, NeoForge, and Sponge sharing the unified rule engine and local cache. - **Geyser & Floodgate Bedrock Integration**: Resolves trusted Bedrock client sockets and honors Bedrock bypass rules. - **Fail-Closed Architecture**: Cloudflare Worker edge router with multi-provider failover and self-hosted local DB-IP MMDB fallback server. - **Developer API (GeoRestrictAPI)**: Asynchronous lookups, country routing, ASN, and VPN queries.
release

GeoRestrict 2.1.0 (Fabric)

2.1.0-fabric
14 окт. 2026 г.140Minecraft: 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, 26.3fabric
Скачать
Что нового
### GeoRestrict v2.1.0 #### What's New - **Local Connection Access Control**: Opt-in `blockLocalConnections` rejects loopback (127.0.0.1), RFC1918 LAN, link-local, and unique-local IPv6 before geolocation queries occur. - **LOCAL Evaluation in Country Rules**: Setting `LOCAL` in country `BLOCKLIST` blocks local connections with `kickMessageCountry`. - **Multi-Loader Server Mod Adapters**: Dedicated server mods for Fabric, Forge, NeoForge, and Sponge sharing the unified rule engine and local cache. - **Geyser & Floodgate Bedrock Integration**: Resolves trusted Bedrock client sockets and honors Bedrock bypass rules. - **Fail-Closed Architecture**: Cloudflare Worker edge router with multi-provider failover and self-hosted local DB-IP MMDB fallback server. - **Developer API (GeoRestrictAPI)**: Asynchronous lookups, country routing, ASN, and VPN queries.
release

GeoRestrict 2.1.0

2.1.0
14 окт. 2026 г.59Minecraft: 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, 26.3bukkit, bungeecord, folia, paper, purpur, spigot, velocity, waterfall
Скачать
Что нового
### GeoRestrict v2.1.0 #### What's New - **Local Connection Access Control**: Opt-in `blockLocalConnections` rejects loopback (127.0.0.1), RFC1918 LAN, link-local, and unique-local IPv6 before geolocation queries occur. - **LOCAL Evaluation in Country Rules**: Setting `LOCAL` in country `BLOCKLIST` blocks local connections with `kickMessageCountry`. - **Multi-Loader Server Mod Adapters**: Dedicated server mods for Fabric, Forge, NeoForge, and Sponge sharing the unified rule engine and local cache. - **Geyser & Floodgate Bedrock Integration**: Resolves trusted Bedrock client sockets and honors Bedrock bypass rules. - **Fail-Closed Architecture**: Cloudflare Worker edge router with multi-provider failover and self-hosted local DB-IP MMDB fallback server. - **Developer API (GeoRestrictAPI)**: Asynchronous lookups, country routing, ASN, and VPN queries.
release

Geo Restrict 2.0.2

2.0.2
2 сент. 2026 г.121Minecraft: 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, 26.3bukkit, bungeecord, folia, paper, purpur, spigot, velocity, waterfall
Скачать
Что нового
### What's New in v2.0.2 #### 1. Broadened Developer API - 10 new additive `GeoRestrictAPI` methods for third-party plugin integrations: - Property getters: `getCountryName()`, `getAsnName()`, `isProxy()`, `isHosting()`, `isMobile()` - Rule helper: `isBlocked()` - Parallel batch lookups: `lookupAll(ips)` - Offline cache inspection & manipulation: `getCachedCountryCode()`, `getCacheSize()`, `purgeCache()` #### 2. Private Status Dashboard - Token-gated `/status` endpoint on the Cloudflare Worker gateway: - Live probe indicators for upstream geolocation providers, local MMDB fallback gateway, and cache tiers. - Operator HTML view (or JSON with `?format=json`). #### 3. Infrastructure & Fallback Improvements - Integrated resilient local MMDB fallback server with automated DB-IP Lite database updates. - Consolidated versioning and gateway configurations across Bukkit, BungeeCord, and Velocity platforms. --- **Supported Platforms**: Bukkit, Spigot, Paper, Purpur, Folia, BungeeCord, Waterfall, Velocity (Java 17+)
release

Geo Restrict 2.0.1

2.0.1
25 июл. 2026 г.76Minecraft: 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.2bukkit, bungeecord, folia, paper, purpur, spigot, velocity, waterfall
Скачать
Что нового
--- ## [v2.0.1] - 2026-07-25 ### Added - **Developer API & Geo-Routing (`GeoRestrictAPI`)**: - `GeoRestrictAPI.lookup(ip)`: Asynchronous raw geolocation lookup without rule evaluation or kick decisions. - `GeoRestrictAPI.getCountryCode(ip)`: Asynchronous ISO 2-letter country code query for custom proxy routing. - `GeoRestrictAPI.isVpn(ip)`: Asynchronous VPN / proxy / hosting node detection. - `GeoRestrictAPI.getAsn(ip)` and `GeoRestrictAPI.getIsp(ip)`: Network AS number and provider queries. - `GeoRestrictAPI.checkIp(ip, playerName, uuid, bypass)` and `isAllowed(ip, playerName)`. - Automatic `ServicesManager` registration on Paper/Spigot backends. - **Geyser & Floodgate (Bedrock) Integration**: - Reflection-based fail-safe wrapper for Floodgate API (`FloodgateHandler`). - Configurable `floodgate:` settings block (`enabled`, `bypassGeorestrict`, `bypassVpnCheck`). - Discord embed placeholders `%xuid%` (Bedrock Xbox User ID) and `%device_os%`. - **Automatic Config Schema Migration (v5)**: - Bumped `configVersion` from 4 to 5. - Older v2.0.0 configs auto-migrate on load, adding new `floodgate:` defaults in-place without losing user settings. ### Fixed & Improved - **Discord Webhook Threading**: Moved Discord webhook delivery to a dedicated single-thread executor (`GeoRestrict-Discord`), preventing slow webhooks from stalling player lookups. - **Cache Debounce Scheduling**: Replaced `ForkJoinPool` sleeping in cache save debouncing with a `ScheduledExecutorService`. - **Bukkit Pending-Check Pruning**: Replaced inline HashMap cleaning with a periodic 60s background task. - **Expanded VPN Keywords**: Added `datacamp` (DataCamp Limited AS62005 / Proton VPN free servers), `tzulo`, `leaseweb`, `m247`, `proton`, and `datacenter` to default `vpnKeywords`. ---
release

Geo Restrict 2.0.0

2.0.0
15 июл. 2026 г.44Minecraft: 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.2bukkit, bungeecord, folia, paper, purpur, spigot, velocity, waterfall
Скачать
Что нового
GeoRestrict 2.0.0 is a full refresh of the plugin, lookup service and documentation. ## Highlights - One Java 17 jar for Bukkit, Spigot, Paper, Purpur, Folia, BungeeCord, Waterfall and Velocity - Country allowlists and blocklists, ASN rules, and configurable VPN, proxy and hosting checks - Bounded local plugin cache with atomic persistence and expiry cleanup - Cloudflare Worker provider routing with a 24 hour edge cache and optional KV support - Protected local MMDB fallback server for country and ASN results when external providers fail - Clearer startup guidance, rewritten marketplace pages, a new wiki, privacy policy and terms ## Upgrade note Back up `plugins/GeoRestrict/config.yml` before upgrading. GeoRestrict removes the retired `directFallbackEnabled` setting during loading. Most server owners should leave the generated Worker settings unchanged and use the configuration guide or Discord support before replacing the lookup path. Read the [installation guide](https://georestrict-docs.pages.dev/installation), [privacy policy](https://georestrict-docs.pages.dev/privacy), [terms and conditions](https://georestrict-docs.pages.dev/terms), and [full changelog](https://georestrict-docs.pages.dev/changelog).
release

Geo Restrict 1.0.0

1.0.0
30 дек. 2025 г.187Minecraft: 1.2.1, 1.2.2, 1.2.3, 1.2.4, 1.2.5, 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.11bukkit, bungeecord, folia, paper, purpur, spigot, velocity
Скачать
Что нового
some bug fixes