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

• PlaceholderAPI

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.