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
Approved
Direct Download How to install?
111 Downloads / 111 Total
Plugin Description §

GeoBlock-PMMP

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 (ip-api.com) and another for failover (extreme-ip-lookup.com). ip-api.com has a hard limit of 150 requests per minute and extreme-ip-lookup.com has a limit of 50 request per minute. This means that you have 200 requests per minute available for you.

Note: ip-api.com 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 extreme-ip-lookup.com.

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

Permissions

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

config.yml

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

IMPORTANT

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

Supported API versions
3.0.0
->
3.8.2
License §
Categories:
General
Admin Tools
Permissions
Permissions
External Internet clients

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

Loading...