Countries limits, blocks, or allows players connecting from certain countries. This is useful for keeping your playerbase somewhat localized.

Note: Eventually this plugin will have its API handling split to the Geo IP plugin for general use. This plugin will continue the country handling usage though, just requiring the Geo IP plugin as well.

Permissions

• countries.admin -- Allows player to use the countries command
• countries.exclude -- Allows player to bypass country checks

Commands

This plugin offers both chat and console commands. When using a command chat, prefix with a forward slash: /.

• countries add <XX> -- Add the specified two-digit country code to the country list
• countries remove <XX> -- Remove the specified two-digit country code from the country list
• countries check <player name or ID> -- Check if specificed player is from a listed country
• countries list -- List all countries currently on the country list

Configuration

Example Configuration

{
  "API key for paid IP lookup service (if applicable)": "YOUR_API_KEY",
  "Ban player if country is blacklisted (true/false)": false,
  "Only allow players from server's country (true/false)": false,
  "Cache responses from IP lookup service provider (true/false)": true,
  "Number of retries on IP lookup fail (0 to disable)": 3,
  "Log connections from players (true/false)": false,
  "Use country code list as a whitelist (true/false)": false,
  "List of two-digit countries codes to check": [
    "CN",
    "JP",
    "HK",
    "KR",
    "RU",
    "VN"
  ]
}

Localization

Providers

While I've added support for over 20 different IP lookup service providers, I've not tested them all yet; so, the providers currently enabled are the ones shown below.

Free Providers

• dp-ip.com - No known request limit
• freegeoip.app - Limit of 15,000 free requests per hour
• geolocation-db.com - No known request limit
• ipgeolocationapi.com - No known request limit
• ipwhois.io - Limit of 10,000 free requests per month

Paid Providers

Coming soon...