Plugin Description
- A high-performance player IP geolocation lookup plugin
- Uses a fully local offline database, supporting both IPv4 and IPv6 queries, with single-core throughput exceeding 1,000,000 queries per second
- Outputs data via PlaceholderAPI variables, compatible with any plugin that supports PAPI
Dependencies
Commands & Permissions
- /atlasip - atlasip.admin - Reload configuration files
Placeholders
| Placeholder | Description | Example |
|---|---|---|
| %atlasip_ip% | IP | 127.0.0.1 |
| %atlasip_country% | Country | 中国 |
| %atlasip_province% | Province | 浙江省 |
| %atlasip_city% | City | 杭州市 |
| %atlasip_isp% | ISP | 电信 |
| %atlasip_country_code% | Country Code | CN |
| %atlasip_full% | Full Location | 中国 浙江省 杭州市 电信 |
Configuration
# Value replacements
# When a variable result matches the left value, it will be replaced with the right value
replacements:
"内蒙古自治区": "内蒙古"
"广西壮族自治区": "广西"
"西藏自治区": "西藏"
"宁夏回族自治区": "宁夏"
"新疆维吾尔自治区": "新疆"
"香港特别行政区": "香港"
"澳门特别行政区": "澳门"
"Japan": "日本"
"Tokyo": "东京"
Data File Information
- This plugin uses the open-source offline database ip2region
- Data files are located in the
plugins/AtlasIP/data/directory - To update the database, download the latest .xdb file from the ip2region project and replace the existing one
Disclaimer
The IP geolocation data used by this plugin is sourced from the third-party open-source project ip2region. All country, region, and location information is provided by that database and does not represent the plugin author's political views or stance.
The data may be inaccurate, outdated, or inconsistent with actual administrative divisions.
If you have concerns about specific data, you can modify it via the replacements configuration or contact the ip2region project directly.
The plugin author is not responsible for the accuracy, completeness, or any disputes arising from the data.
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.20, 1.20.1, 1.20.2
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
- Ships as AtlasIP.jar — drop this file into the mods folder
- Download size: 10.9 MB
- Download link checked 22 Aug 2026 — working
These come from our own check of the pack file, not from the source page.