Fabric-GeoLogin
by Ranzeplay
Fabric-GeoLogin is a Fabric server mod that restricts which real-world countries can log in to a server, based on each player's location.
What it does
The mod checks where a connecting player is located and admits or refuses the login according to a list of country codes. Countries are listed with their ISO ALPHA-2 codes, and the mod can run in either a blocklist mode, which refuses listed countries, or an allowlist mode, which admits only listed ones.
Location is looked up through the IpLocation API for each client. Results are cached per IP address, and a configurable recheck time controls how often a cached address is looked up again. Single addresses, wildcards and address segments can be exempted from the country check. If the geo-location service fails, a fallback setting decides whether the player is allowed to join or refused.
Fabric-GeoLogin is a server-side only mod, so players join without installing anything. It requires Fabric API and is released under the MIT License. Files exist for 1.21.4, 1.21.7, 1.21.8, 1.21.9 and 1.21.10, with 0.2 for 1.21.10 as the latest file, published 2025-10-13.
Key features
Country blocklist and allowlist
Server owners list ISO ALPHA-2 country codes and choose whether those countries are refused or are the only ones admitted.
Cached location lookups
Each IP address is stored after its first check, and a configurable recheck time limits how often the lookup repeats.
Address exemptions
Single IP addresses, wildcard patterns and address segments can be exempted from the country check.
Fallback on lookup failure
A setting controls whether players are admitted or refused when the geo-location service cannot answer.
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Requirements
Dependencies declared by the latest file for each loader.
Required 1
Use cases
Who it’s for: Server owners who want to limit logins by country. The mod does nothing on the client, so it fits any server that already runs Fabric with Fabric API.
How it compares
IPWhitelist is a server-side Fabric mod, open source under the GNU General Public License v3.0 only, with files for 1.21.1 – 26.3, and it works by IP address rather than by country. EyeIP is a client-side Fabric mod under the MIT License, published for 1.20.2 – 1.20.3, so it cannot replace a server-side check. Server Insight is client-side only and open source under the GNU General Public License v3.0 or later, for 1.21.11 – 26.2.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Fabric-GeoLogin | Fabric | 1.21.4 – 1.21.10 | Server-side only | 2025-10-13 |
| IPWhitelist | Fabric | 1.21.1 – 26.3 | Server-side only | 2026-10-10 |
| EyeIP | Fabric | 1.20.2 – 1.20.3 | Client-side only | 2023-11-21 |
| Server Insight | Fabric | 1.21.11 – 26.2 | Client-side only | 2026-08-31 |
Questions
Does Fabric-GeoLogin need Fabric API?
Do players need the mod installed?
Which game versions have files?
In the catalog
Fabric-GeoLogin is one of 8,016 Management mods on ModsFinder, and one of 5,930 Management mods for Fabric. 15,569 mods support Minecraft 1.21.10.
More from Ranzeplay
Similar mods
What the author says
A fabric server-side mod that restricts login countries in the real world We use IpLocation API to check the location of clients.
Official listing
- Modrinth page
- modrinth.com/mod/fabric-geologin
- Owner
- Ranzeplay
- Published
- 2025-02-24
- Updated on Modrinth
- 2025-10-13
- Facts verified
- 2026-10-15