# PlayerLocations Plugin Documentation<\/p>\n
## Introduction<\/p>\n
PlayerLocations is a Minecraft plugin designed to enhance the server experience by providing information about player locations based on their IP addresses. This documentation will guide you through the installation, configuration, and usage of the plugin.<\/p>\n
## Installation<\/p>\n
1. Download the latest version of the plugin.
\n2. Place the plugin JAR file into the ‘plugins’ folder of your Bukkit or Spigot server.
\n3. Restart the server to load the plugin.<\/p>\n
## Configuration<\/p>\n
The plugin requires an API key from ipstack to fetch location information. Follow these steps to configure the plugin:<\/p>\n
1. Sign up for a free ipstack account at ipstack signup page.
\n2. Confirm your email by clicking on the confirmation link sent to you.
\n3. Log in to your ipstack account.
\n4. Copy your API key from the ipstack dashboard.
\n5. Open the `plugins\/PlayerLocations\/config.yml` file.
\n6. Add your API key to the configuration file:<\/p>\n
“`yaml
\n# Configuration for PlayerLocations
\nkey: “YOUR_IPSTACK_API_KEY”
\n“`<\/p>\n
Replace `YOUR_IPSTACK_API_KEY` with the API key you obtained from ipstack.<\/p>\n
## Features<\/p>\n
– Display player join events in the server console, including player name and their country based on IP address.
\n– Command for administrators to have knowledge of their server’s traffic by players.<\/p>\n
## Commands<\/p>\n
– **\/playerlocations** Shows information about plugin and restarts the plugin
\n– **\/country [username]** Shows the location of a user<\/p>\n
## Permissions<\/p>\n
– **playerlocations.command.playerlocations**
\n– **playerlocations.command.country**<\/p>\n
## Troubleshooting<\/p>\n
If you encounter any issues while using the plugin, consider the following:<\/p>\n
1. Check the server console for error messages.
\n2. Verify that your ipstack API key is correctly configured in the `config.yml` file.
\n3. Ensure that the plugin is compatible with your server version.<\/p>\n
## API Usage (if applicable)<\/p>\n
PlayerLocations does not currently provide an external API for developers.<\/p>\n
## Contributing<\/p>\n
Contributions are welcome. You can contribute by providing useful code, suggesting new ideas for updates, or reporting issues\/bugs encountered while using the plugin<\/p>\n
## License<\/p>\n
PlayerLocations is licensed under the **Creative Commons Attribution-NonCommercial-NoDerivs 3.0 Unported License**.<\/p>\n
### You are free to:<\/p>\n
– **Share** \u2014 Copy and redistribute the material in any medium or format.
\n– **Adapt** \u2014 Remix, transform, and build upon the material.<\/p>\n","protected":false},"excerpt":{"rendered":"
Provide information about player locations based on their IP addresses. This documentation will guide you through the installation, configuration, and usage of the plugin.<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"playerlocations","_minecraft_project_id":"teILv4G9","_minecraft_author":"JayoX","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":219,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"playerlocations.zip","_minecraft_size_bytes":7158,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T12:28:51.413289Z","_minecraft_date_created":"2023-11-29T23:00:48.996980Z","_minecraft_date_modified":"2023-11-27T17:02:58.945311Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/playerlocations","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-07T05:15:36+00:00","_minecraft_import_hash":"9795cabf486e48f58d619439c7bfb631","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124],"mod_loader":[130],"minecraft_version":[59,36,60],"class_list":["post-122760","mod","type-mod","status-publish","hentry","mod_category-bukkit","mod_loader-bukkit","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2"],"yoast_head":"\n