The OnlyCountry Plugin is designed for BungeeCord servers to restrict player access based on their country of origin, using their IP address to determine the country. When a player connects to the BungeeCord server, the plugin checks the player's country and allows or denies access based on the settings defined in the config.yml file of this plugin.


Installation and Initial Setup

1. Installing the Plugin:
   
   • Download the .jar file for the OnlyCountry plugin and place it in your BungeeCord server's plugins directory.
   • Restart your BungeeCord server to load the plugin.
2. Configuring config.yml:
   
   • On the first run after installation, the plugin will create a config.yml file in the OnlyCountry directory.
     
     
   • Open the config.yml file with a text editor (e.g., Notepad++, VSCode).
     
     
   • Customize the settings according to your needs:
     

1. • enabled: Set to true to enable the plugin, or false to disable it.
     
     
   • country-allowed: Specify a list of allowed countries using ISO 3166-1 alpha-2 country codes. To allow all countries, include all in the list. You can find the correct country codes on countrycode.org.
     
2. Testing the Configuration:
   
   • After editing config.yml, restart your BungeeCord server to apply the settings.
   • Attempt to connect to the server from both allowed and disallowed countries to verify the plugin is working correctly.

Using the Plugin

1. Player Connection:
   
   • When a player attempts to connect to the BungeeCord server, the OnlyCountry plugin checks the player's IP address.
   • If the player's country is listed in the allowed countries, the connection proceeds.
   • If the player's country is not allowed, the connection is canceled, and the player is denied access to the server.
2. Customizing Settings:
   
   • To change the list of allowed countries, edit the config.yml file and restart the server to apply the new settings.
   • You can enable or disable the plugin by adjusting the enabled value in config.yml.

Troubleshooting

• Connection Issues:
  
  • If players from allowed countries cannot connect, ensure the config.yml file is configured correctly.
  • Verify that the IP geolocation service is functioning properly and that the player's IP is accurately detected.
• Plugin Loading Issues:
  
  • If the plugin fails to load or operate correctly, check the BungeeCord logs for any error messages or warnings related to the plugin.
  • Contact the plugin developer or the BungeeCord community for further assistance.