By continuing to use this site, you agree to the Terms of Service of this website, including usage of cookies.

OK, Don't show this again

Block or allow players from certain countries
version 1.0-beta
Direct Download How to install?
516 Downloads / 516 Total
1 Review
Plugin Description §


GeoBlock is a very simple Geo Blocking plugin for PocketMine-MP. Everytime a player join your server his IP will be checked against external APIs so we can get his country of origin and block or allow his login.

Please read the "API Limits" and "IMPORTANT" tab before using this plugin.

API Limits

This plugin uses two APIs. One main API ( and another for failover ( has a hard limit of 150 requests per minute and has a limit of 50 request per minute. This means that you have 200 requests per minute available for you.

Note: WILL block your IP if you send more than 150 requests per minute and you will need to unban your IP here or that will leave you with only 50 requests per minute from

One request = one player logging in on the server. If you have a big server (more than 150 players logging in per minute) please consider actually paying for some GeoIP API and edit the code to suit your new paid API


Permission Description
geoblock.bypass Players with this permission will bypass Geo Block


Configuration is pretty straightforward.

Setting Description
kickMsg Message for kicked player
action deny or allow
allow = only players from “countries” will be able to join
deny = every player will join except players from “countries”
countries Countries to allow/deny on the server. Uppsercase comma separated
Example: [BR, NZ, CN, RU, US]
fail deny or allow. What to do if all APIs fail to return a country?
allow = players with invalid country code will be able to join the server
deny = players with invalid country code WILL NOT be able to join the server
failMsg Message to show players kicked due to API fail


Again, I'd like to remind that if you get many (over 150) players logging in per minute it's VERY recommended that you pay for a good unlimited GeoIP API, there are many on Google, search for one that best suit your needs and budget. You will also have to edit the code to suit your new API.

Keep in mind this plugin is still in BETA and has not been rigorously tested

What happens if all APIs go offline or my IP gets blacklisted?

I don't know. I could not simulate this situation, but the chances of you getting blocked by both API providers are very low

Does this detect VPNs?

No. Players with a proxy or VPN can easily bypass this plugin

Why did you choose these APIs over X API?

I didn't want to play favorites and the APIs I have choosen have pretty decent usage limits

using v1.0-beta
21 Sep 20

Reply to review by :

Supported API versions
License §
Admin Tools
External Internet clients

You can leave one review per plugin release, and delete or update your review at any time