# GeoLoc<\/p>\n
## Advanced Geolocation Plugin for Paper Servers<\/p>\n
### Description<\/p>\n
GeoLoc is a powerful geolocation plugin for Paper servers that allows administrators to view the approximate geographic location of their players. With GeoLoc, server admins can easily see where their community members are connecting from around the world, enhancing community building and moderation capabilities.<\/p>\n
### Features<\/p>\n
– **Fast & Reliable:** Uses multiple geolocation APIs to ensure accurate location data
\n– **Flexible Commands:** View full geolocation data or just specific information (city, region, country, local time)
\n– **PlaceholderAPI Support:** Integrate geolocation data into other plugins using our PAPI expansion
\n– **Customizable Messages:** Fully customizable messages through the messages.yml configuration file
\n– **Join Messages:** Optional location announcements when players join your server
\n– **Tab Completion:** Helpful tab completion for online players
\n– **Lightweight:** Minimal impact on server performance<\/p>\n
### Commands<\/p>\n
“` ### Permissions<\/p>\n – **geoloc.admin** – Access to all GeoLoc commands ### PlaceholderAPI Integration<\/p>\n GeoLoc provides the following placeholders when PlaceholderAPI is installed:<\/p>\n “` ### Configuration<\/p>\n GeoLoc comes with two configuration files: “`yaml # Set to true to display a welcome message to players with their location # Permissions: “`yaml # Available placeholders for every message is defined by ALL CAPS<\/p>\n # Prefix for messages # Default value when the geolocation of the player returns null (when they are in a local network) # Join message (broadcasts to all players) # Command messages # Log messages (console only) error: # Possible Placeholders: # The return format of all placeholders can be defined below<\/p>\n # PlaceholderAPI return format ### Support<\/p>\n For support, please visit our Discord server or create an issue on our GitHub repository.<\/p>\n ## **Disclaimer**<\/p>\n This plugin provides approximate geolocation data based on IP addresses and should not be considered 100% accurate. The data provided is for general informational purposes only and should not be used for any critical decision-making. The plugin relies on third-party geolocation services which may have varying levels of accuracy depending on the region.<\/p>\n GeoLoc respects player privacy and only provides general location information (city, region, country, local time) rather than exact coordinates. Server administrators should inform their players that this information may be visible to server staff.<\/p>\n *GeoLoc is not affiliated with any geolocation service providers used in this plugin. We are not responsible for any inaccuracies in the data provided by these services.*<\/p>\n *\u00a9 2025 TSERATO | Version 1.0*<\/p>\n","protected":false},"excerpt":{"rendered":" A simple plugin for the geographical Location of a Player.<\/p>\n","protected":false},"featured_media":75306,"template":"","meta":{"_minecraft_slug":"geoloc","_minecraft_project_id":"IVILx8gR","_minecraft_author":"TSERATO","_minecraft_license":"Apache-2.0","_minecraft_downloads":386,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"geoloc.zip","_minecraft_size_bytes":34018,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T11:01:16.991730Z","_minecraft_date_created":"2024-05-01T07:26:16.379693Z","_minecraft_date_modified":"2025-03-22T20:18:46.131579Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/geoloc","_minecraft_icon_attachment_id":75306,"_minecraft_imported_at":"2026-06-04T08:47:06+00:00","_minecraft_import_hash":"93c14cb7390fef43ba7ad990e969fee2","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,126,127,129,92],"mod_loader":[131,132,134],"minecraft_version":[38],"class_list":["post-75305","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-folia","mod_category-management","mod_category-paper","mod_category-spigot","mod_category-utility","mod_loader-folia","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21-4"],"yoast_head":"\n
\n\/geoloc reload – Reload plugin configuration
\n\/geoloc geolocation
\n\/geoloc geolocation full
\n\/geoloc geolocation city
\n\/geoloc geolocation region
\n\/geoloc geolocation country
\n\/geoloc geolocation localTime
\n“`<\/p>\n
\n– **geoloc.see** – Allows the player to see the join message<\/p>\n
\n%geoloc_full% – Full geolocation information
\n%geoloc_city% – Player’s city
\n%geoloc_region% – Player’s region\/state
\n%geoloc_country% – Player’s country
\n%geoloc_localtime% – Player’s local time
\n“`<\/p>\n
\n– **config.yml** – Main plugin settings
\n– **messages.yml** – Customizable messages for all plugin features<\/p>\nconfig.yml<\/summary>\n
\n# GeoLoc Plugin Configuration<\/p>\n
\n# Set to false to disable the welcome message
\n# The actual message content is in messages.yml
\njoin-message-enabled: true<\/p>\n
\n# geoloc.admin – Allows reloading the config
\n# geoloc.see – Allows seeing the join message (if enabled)
\n“`
\n<\/details>\nmessages.yml<\/summary>\n
\n# GeoLoc Plugin Messages
\n# You can use color codes with & (e.g. &a for green, &c for red)
\n# Available placeholders for join-message:
\n# {player} – Player name
\n# {city} – City
\n# {region} – Region\/State
\n# {country} – Country
\n# {localTime} – Local time in HH:mm:ss format<\/p>\n
\n# NONE
\nprefix: “&c&lGeoLoc &7&l\u2192 &r”<\/p>\n
\n# NONE
\ndefault-location-value: “Unknown”<\/p>\n
\n# PLAYER, CITY, REGION, COUNTRY, LOCALTIME
\njoin-message: “&aPlayer &e{player} &ajoined us from &6{city}, {region}, {country}&a! It’s &b{localTime} &athere.”<\/p>\n
\ncommand:
\n # NONE
\n reload-success: “&aGeoLoc configuration has been reloaded successfully!”
\n # NONE
\n no-permission: “&cYou don’t have permission to use this command.”
\n # PLAYER, CITY, REGION, COUNTRY, LOCALTIME
\n location: “&aPlayer &e{player} &ais from &6{city}, {region}, {country}&a! Local time: &b{localTime}”<\/p>\n
\nlog:
\n # PLAYER, CITY, REGION, COUNTRY, LOCALTIME
\n player-connected: “{player} connected from: {city}, {region}, {country} (Local time: {localTime})”
\n # PLAYER
\n no-ip: “Could not get IP address for player: {player}”
\n # PLAYER
\n no-geolocation: “Could not get geolocation data for player: {player}”<\/p>\n
\n # PLAYER
\n player-not-found: “&c{player} can’t be found or isn’t online.”
\n # PLAYER
\n ip-not-found: “&cCouldn’t get IP from {player}.”
\n # PLAYER
\n geolocation-not-found: “&cCouldn’t get geolocation data from {player}.”<\/p>\n
\n# – %geoloc_full% -> Returns all geolocation information from the player
\n# – %geoloc_city% -> Returns the city of the player
\n# – %geoloc_region% -> Returns the region of the player
\n# – %geoloc_country% -> Returns the country of the player
\n# – %geoloc_localTime% -> Retunrs the local time of the player (calculated by region)<\/p>\n
\nplaceholder:
\n full: “{city}, {region}, {country}, {localTime}”
\n city: “{city}”
\n region: “{region}”
\n country: “{country}”
\n localTime: “{localTime}”
\n“`
\n<\/details>\n